{"uid":"cap_M1jrEb_Ute88yBW2D_Lsq","slug":"toll402-listings-registration-140666cd","name":"Toll402 Listings Registration","description":"The OpenRouter for AI-agent tools: one gateway, one wallet, every capability. Built-in tools, forged tools, a global verified business directory and 2,000+ aggregated x402 services, all paid per call in USDC via x402 (HTTP 402). No signup, no API key.","url":"https://toll402.dev/v1/listings","method":"POST","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method","bodyType","body"],"properties":{"body":{"type":"object","required":["kind","url"],"properties":{"url":{"type":"string","format":"uri","description":"The endpoint / MCP URL / agent-card URL"},"kind":{"enum":["x402","mcp","agent"],"type":"string","description":"x402 = HTTP endpoint that answers 402; mcp = remote MCP server (Streamable HTTP); agent = A2A agent card URL"},"name":{"type":"string","maxLength":80,"minLength":2},"tags":{"type":"array","items":{"type":"string","maxLength":30},"default":[],"maxItems":10},"tier":{"enum":["basic","featured"],"type":"string","default":"basic","description":"basic $1/30 days · featured $5/30 days (top of results, landing spotlight)"},"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)"},"description":{"type":"string","maxLength":600,"minLength":20}},"additionalProperties":false},"type":{"type":"string","const":"http"},"method":{"enum":["POST"],"type":"string"},"bodyType":{"enum":["json","form-data","text"],"type":"string"}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","properties":{"ms":{"type":"integer"},"ok":{"type":"boolean"},"tool":{"type":"string"},"result":{"type":"object","properties":{"listed":{"type":"boolean"},"listing":{"type":"object","properties":{"id":{"type":"string"},"kind":{"type":"string"},"tier":{"type":"string"},"listedUntil":{"type":"string"}}}}}}}}}}},"responseSchema":{"type":"json","example":{"listed":true,"listing":{"id":"l/abc123","kind":"x402","tier":"basic","listedUntil":"2026-10-09T00:00:00Z"}}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"1","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"registry","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$1/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"1","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_6KBtuhxUQWaMX1V0d3OcW","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"1","costPer":"request","priority":0,"asset":null,"unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Registers an x402, MCP, or A2A agent-card endpoint in the Toll402 discovery directory for 30 days","exampleAgentPrompt":"List my x402 endpoint https://myservice.dev/api/v1/summarize on Toll402 as a basic listing — the name is 'TextSummarizer', it's an x402 kind, and my wallet is 0xAbCd1234...","exampleUseCases":[{"title":"Launch a new x402 tool publicly","prompt":"Register my new x402 API at https://mytool.example.com/v1/translate on Toll402 with the name 'DeepTranslate', description 'Neural machine translation for 50 languages, paid per call in USDC', tagged as 'translation' and 'nlp', basic tier, my wallet is 0x1234abcd."},{"title":"Feature a premium MCP server","prompt":"Submit my MCP server at https://mcpserver.example.com to the Toll402 directory as a featured listing so it shows up at the top — name it 'CodeReviewMCP', describe it as 'An MCP server that reviews pull requests and suggests improvements', tag it 'code' and 'review', and use my wallet 0xDeadBeef99."},{"title":"Register an A2A agent card for discovery","prompt":"Add my agent card at https://agents.example.com/.well-known/agent.json to the Toll402 marketplace — kind is agent, name 'ResearchBot', description 'An autonomous research agent that gathers and summarizes web information on demand', basic tier, tagged 'research' and 'web'."}],"resultDescription":"Returns a JSON object confirming the listing was created, including a unique listing ID (e.g. 'l/abc123'), the kind of service listed, the tier selected, and the ISO timestamp when the listing expires (listedUntil).","failureModes":["Invalid or unreachable URL causes rejection","Missing required fields (kind, url) returns validation error","Description too short (under 20 chars) or too long (over 600 chars) fails schema validation","Payment of $1 USDC not received via x402 — listing not created","Invalid kind enum value (not x402/mcp/agent) returns error","Owner wallet address malformed causes attribution failure"],"whenToPreferThis":"Use this endpoint when you want to register a new x402, MCP, or A2A agent endpoint in the Toll402 discovery directory so that other AI agents can find and pay for it. It is the canonical submission path for the Toll402 marketplace and requires only a single $1 USDC payment via x402 — no signup or API key needed. Prefer this over manual directory submissions or other registries when your service already speaks x402, MCP, or the A2A agent-card protocol.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-14T18:55:41.924Z","isFirstParty":false}