Model Context Protocol

One MCP server for the x402 catalogue.

Connect an MCP-capable agent to APIStead and it can search the catalogue, inspect a listing, read the routes, check reliability and prepare a paid call. Discovery is free and never returns a payment challenge.

Connect a client Read the docs

Streamable HTTP

Stateless transport with a modern protocol version and a legacy fallback.

No authentication

Discovery is open. The agent only needs a wallet when it chooses to pay a route.

Eight tools

Search, list, inspect, check receipts and submit a listing for review.

Connect a client

Add the server to any MCP client that supports Streamable HTTP. The configuration below works in Claude Desktop, Cursor and other compatible hosts.

mcp client config

{
  "mcpServers": {
    "apistead": {
      "url": "https://apistead.qd.je/mcp"
    }
  }
}

Test the endpoint

The endpoint speaks JSON-RPC over Streamable HTTP. Initialize a session, list the tools, then call one. A browser visit to /mcp redirects here; agents should POST to the endpoint.

initialize

curl -sS https://apistead.qd.je/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "initialize",
    "params": {
      "protocolVersion": "2026-07-28",
      "capabilities": {},
      "clientInfo": { "name": "my-agent", "version": "1.0" }
    }
  }'

search the catalogue

curl -sS https://apistead.qd.je/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
    "jsonrpc": "2.0",
    "id": 2,
    "method": "tools/call",
    "params": {
      "name": "search_apis",
      "arguments": { "query": "email", "limit": 3 }
    }
  }'

Tool surface

The server returns the catalogue and the evidence. It does not hold a wallet and does not pay on the agent's behalf.

Tool	Purpose
search_apis	Search by capability, category, network and price.
list_apis	Browse the live catalogue with filters.
list_bundles	List outcome-oriented workflows and prompts.
get_api	Read one listing, its routes, verification and reliability.
get_routes	Get methods, paths, prices and examples.
get_receipt	Read the paid verification record for a listing.
check_reliability	Check score, band, uptime and last check.
submit_listing	Submit a paid route for review.

Next: read the payment flow

MCP handles discovery. The agent still pays the provider's own x402 route.

Docs Agent skill