{"uid":"cap_M1jrEb_Ute88yBW2D_Lsq","slug":"toll402-listings-registration-140666cd","name":"Toll402 Listings Registration","description":"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.","url":"https://toll402.dev/v1/listings?utm_source=zero.xyz","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-10-31T00:40:51.849Z","isFirstParty":false,"canonicalSlug":"toll402-listings-registration-140666cd"}