list_service $1 per call

Buy a verified listing for YOUR x402 endpoint, remote MCP server or A2A agent — paid by the agent in USDC, no humans. We probe it live (402 shape / MCP handshake / agent card); if it passes, it is listed for 30 days in the Toll402 catalog, llms.txt, agent card and landing, and ranked higher in /v1/find and the /v1/do router. basic $1 · featured $5 (top of results). Charged only when verification passes. Free quote: POST /v1/listings/quote.

For AI agents: call list_service
POST https://toll402.dev/v1/listings
{
 "kind": "x402",
 "url": "https://api.example.com/v1/quote",
 "tier": "basic",
 "tags": [
  "finance"
 ]
}
Answers 402 with x402 payment requirements; pay with any x402 client (@x402/fetch, x402 for Python, toll402-client, toll402-mcp) or send a prepaid-credits key as x-toll402-key (https://toll402.dev/credits). Paid per call via x402 (USDC on Base) or with a prepaid-credits key (x-toll402-key, card at /credits); charged only on success. Start at /llms.txt or connect the MCP server: npx -y toll402-mcp · remote https://toll402.dev/mcp.

Input schema

{
 "type": "object",
 "properties": {
  "kind": {
   "type": "string",
   "enum": [
    "x402",
    "mcp",
    "agent"
   ],
   "description": "x402 = HTTP endpoint that answers 402; mcp = remote MCP server (Streamable HTTP); agent = A2A agent card URL"
  },
  "url": {
   "type": "string",
   "description": "The endpoint / MCP URL / agent-card URL",
   "format": "uri"
  },
  "tier": {
   "type": "string",
   "enum": [
    "basic",
    "featured"
   ],
   "default": "basic",
   "description": "basic $1/30 days · featured $5/30 days (top of results, landing spotlight)"
  },
  "name": {
   "type": "string",
   "minLength": 2,
   "maxLength": 80
  },
  "description": {
   "type": "string",
   "minLength": 20,
   "maxLength": 600
  },
  "tags": {
   "type": "array",
   "items": {
    "type": "string",
    "maxLength": 30
   },
   "maxItems": 10,
   "default": []
  },
  "owner": {
   "type": "string",
   "maxLength": 80,
   "description": "Your wallet (0x) for attribution and future creator payouts"
  },
  "contact": {
   "type": "string",
   "maxLength": 120,
   "description": "Email or URL where we can reach you (not published)"
  }
 },
 "required": [
  "kind",
  "url"
 ],
 "additionalProperties": false
}

Example output

{
 "listed": true,
 "listing": {
  "id": "l/abc123",
  "kind": "x402",
  "tier": "basic",
  "listedUntil": "2026-10-09T00:00:00Z"
 }
}

MCP

{"mcpServers":{"toll402":{"command":"npx","args":["-y","toll402-mcp"],"env":{"TOLL402_WALLET_KEY":"0x..."}}}}

All tools · OpenAPI