SkillDock — Pay-per-skill AI Marketplace

v1.0.0 · Solana Devnet

Introduction

SkillDock is a pay-per-skill execution marketplace built on the x402 HTTP payment protocol and Purch's Solana USDC facilitator. Skills are callable HTTP endpoints that return 402 Payment Required until a valid USDC micropayment is submitted.

No API keys. No accounts. No subscriptions. Just a Solana wallet and a fraction of a cent in devnet USDC.

Any Agent

AI agents autonomously discover and pay for skills using MCP definitions

Any Language

HTTP + x402 works from Node.js, Python, Rust, Go, or a browser

Instant Settlement

Purch verifies USDC transfers on Solana in under 1 second

How It Works

Every SkillDock skill is a standard HTTP endpoint protected by the x402 payment protocol. Here is the full request flow:

Agent/Browser

→

POST /api/skills/scrape

←

402 + PaymentRequirements

↓

Sign USDC tx (Phantom / keypair)

→

Retry with X-PAYMENT

→

Purch verifies on Solana

→

200 + Result + Receipt

Initial request

Your agent or browser sends a normal HTTP request to the skill endpoint.

402 response

The skill returns HTTP 402 with a PaymentRequirements JSON body containing: facilitator URL, amount in atomic USDC units, the treasury wallet to pay, and network.

Sign USDC transaction

Your client (Phantom browser extension or a server keypair) signs a USDC transfer transaction on Solana devnet.

Retry with X-PAYMENT

The signed transaction is base64-encoded and sent as the X-PAYMENT header on the same request.

Purch verifies

SkillDock forwards the payment to the Purch facilitator at https://app.purch.xyz/facilitator which confirms the USDC transfer on-chain.

200 + result

Once verified, the skill executes and returns the result with an X-PAYMENT-RESPONSE receipt header. The execution is logged to Supabase.

Quick Start

1. Install Phantom wallet browser extension
2. Switch to Solana Devnet in Phantom settings
3. Get devnet USDC from spl-token-faucet.com
4. Visit /play/scrape and click Run Skill

Skills Reference

Endpoint	Method	Price	Input	Output
/api/skills/scrape	POST	$0.002	url: string	title, metaDescription, bodyText, wordCount, links, scrapedAt
/api/skills/summarize	POST	$0.010	text: string, style?: bullet\|paragraph\|tldr	summary, wordCount, style, model
/api/skills/solana-price	GET	$0.001	?token=SOL\|USDC\|JUP\|BONK\|WIF	token, price, change24h, fetchedAt
/api/skills/compose	POST	$0.011	url: string, summaryStyle?: string	url, title, summary, scrapeMs, summarizeMs, totalMs
/api/skills/agent-answer	POST	$0.050	question: string	answer, skillsUsed, totalCost, reasoning

Using Skills in Agents

Each SkillDock skill exposes an MCP tool definition that any agent framework supporting MCP (Claude Code, LangChain, AutoGen, CrewAI) can load and invoke autonomously. The agent discovers the skill, constructs the payment, and pays for execution — all without human intervention.

Claude Code integration

bash

# Install the SkillDock MCP server (coming soon via npm) npx skilldock-mcp --wallet YOUR_PRIVATE_KEY --network devnet

Then add to your claude_desktop_config.json:

json

{
  "mcpServers": {
    "skilldock": {
      "command": "npx",
      "args": ["skilldock-mcp"],
      "env": {
        "SOLANA_PRIVATE_KEY": "YOUR_BASE58_PRIVATE_KEY",
        "SOLANA_NETWORK": "devnet"
      }
    }
  }
}

Claude will then have access to all SkillDock skills and will autonomously pay for them in USDC when invoked in conversation.

MCP Integration

Each skill's MCP definition is downloadable at /api/skills/[skillId]/mcp. The x402 extension field tells MCP clients how and where to pay.

json

{
  "name": "skilldock_scrape",
  "description": "Scrape any URL and return structured content. Costs $0.002 USDC via Purch x402 on Solana.",
  "inputSchema": {
    "type": "object",
    "properties": {
      "url": { "type": "string", "description": "The URL to scrape" }
    },
    "required": ["url"]
  },
  "x402": {
    "endpoint": "https://skilldock.vercel.app/api/skills/scrape",
    "facilitator": "https://app.purch.xyz/facilitator",
    "price": 0.002,
    "network": "solana:devnet"
  }
}

🌐

Web Scraper

$0.002

✍️

AI Summarizer

$0.010

💹

Solana Price Feed

$0.001

⚡

Scrape + Summarize

$0.011

🤖

Skill Router

$0.050

🔍

Google Search

$0.005

🎵

Audio / Video Transcriber

$0.050

▶️

YouTube Summarizer

$0.025

Install & SDKs

bash

npm install x402-solana          # Solana x402 client (recommended)
npm install @x402/fetch @x402/svm # Coinbase official SDK with Solana
pip install x402                  # Python client

Language	Package	Solana Support	Status
Node.js	x402-solana	✓	✓ Stable
Node.js	@x402/fetch + @x402/svm	✓	✓ Stable
Python	x402	✓	✓ Stable
Rust	x402-rs	⚠ Beta	⚠ Beta
Go	x402-go	⚠ Beta	⚠ Beta

Get Devnet USDC

You need devnet USDC to test skills. The mint address is 4zMMC9srt5Ri5X14GAgXhaHii3GnPAEERYPJgZJDncDU

1. Visit spl-token-faucet.com ↗
2. Select "USDC" and enter your devnet wallet address
3. Claim free devnet USDC tokens

API Reference

GET/api/skillsNone

Returns the full skill registry with all skill definitions, MCP tool definitions, and pricing.

bash

curl https://skilldock.vercel.app/api/skills

POST/api/skills/scrapex402 $0.002 USDC

Scrape and parse any public URL.

bash

curl -X POST https://skilldock.vercel.app/api/skills/scrape \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64_signed_tx>" \
  -d '{"url":"https://example.com"}'

POST/api/skills/summarizex402 $0.010 USDC

Summarize text using Claude Haiku.

bash

curl -X POST https://skilldock.vercel.app/api/skills/summarize \
  -H "Content-Type: application/json" \
  -H "X-PAYMENT: <base64_signed_tx>" \
  -d '{"text":"Your text here","style":"bullet"}'

GET/api/skills/solana-price?token=SOLx402 $0.001 USDC

Get current Solana token price from Jupiter API.

bash

curl "https://skilldock.vercel.app/api/skills/solana-price?token=SOL" \
  -H "X-PAYMENT: <base64_signed_tx>"

GET/.well-known/purch.jsonNone

SkillDock provider manifest for Purch x402scan registration.

bash

curl https://skilldock.vercel.app/.well-known/purch.json

GET/api/registry/statsNone

Aggregate execution statistics.

bash

curl https://skilldock.vercel.app/api/registry/stats

Provider Registration

Anyone can register their own skill provider on SkillDock. Build an HTTP endpoint with the x402 payment middleware, serve a manifest, and submit your URL.

Build a skill endpoint

Add the withPurchPayment() middleware to any HTTP route. It handles 402 responses and payment verification automatically.

Serve a manifest

Host a /.well-known/purch.json manifest on your domain with your provider name, wallet, and skills array.

Register your URL

Visit /register and submit your manifest URL. SkillDock will validate the manifest and list your skills.

You're live

Your skills appear in the marketplace immediately. Other agents can discover and pay for them autonomously.

FAQ

Do I need an account?▼

No. Skills are gated by payment, not identity. Connect a Solana wallet and you're ready.

What wallet do I need?▼

Any Solana wallet. Phantom is recommended for browser use. For server-side agents, use a keypair directly.

Is this mainnet?▼

No — devnet only during the hackathon period. Mainnet deployment will follow after security review.

How does Purch verify payment?▼

Via the Purch facilitator at https://app.purch.xyz/facilitator which checks the USDC transfer on Solana devnet in real time.

Can my AI agent use these skills autonomously?▼

Yes — use the MCP definitions or any x402-compatible Solana client. The agent downloads the skill schema, signs a USDC transaction, and retries the request.

What is the server ID ad1c686d-5f67-4160-ad50-72175071d9a7?▼

That's SkillDock's registered facilitator ID on x402scan, used to track settlements and verify provider identity.

Can I build my own skills and list them?▼

Yes! Register at /register. Build any HTTP endpoint with the withPurchPayment middleware, serve a purch.json manifest, and submit your manifest URL.

What are the rate limits?▼

No rate limits — every request is individually paid for. The economics prevent abuse naturally.