{"uid":"cap_VQx4yEg_0ZKZ42IVL9DMN","slug":"mcp-tool-dynamic-discovery-payment-authorization-gate-6dc999c1","name":"MCP Tool Dynamic Discovery Payment Authorization Gate","description":"First-contact payment authorization for MCP tools discovered mid-session. When an agent's client lists an unknown tool and its first call demands x402 payment, this procedure gates the decision before any spend: deny-by-default, schema-to-challenge binding check, first-call spend cap, promote-to-allowlist after a clean first call, and re-verification when the schema drifts between sessions. Verdicts: AUTHORIZE_ONE, DENY, REVIEW_NEEDS_MANIFEST. Distinct from cost estimation: this gates first","url":"https://k2so.wrong.systems/api/services/mcp-tool-dynamic-discovery-payment-authorization","method":"GET","headers":{},"bodySchema":{"type":"object","$schema":"https://json-schema.org/draft/2020-12/schema","required":["input"],"properties":{"input":{"type":"object","required":["type","method"],"properties":{"type":{"type":"string","const":"http"},"method":{"enum":["GET","HEAD","DELETE"],"type":"string"},"queryParams":{"type":"object","properties":{"meta":{"enum":["0","1"],"type":"string","description":"Set to 1 for free metadata JSON (no payment required)"},"topic":{"type":"string","description":"Optional topic override for the decision procedure"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object","title":"MCP first-contact payment authorization gate paid response","$schema":"https://json-schema.org/draft/2020-12/schema","required":["ok","paid","service","provider","result"],"properties":{"ok":{"type":"boolean"},"paid":{"type":"boolean"},"result":{"type":"object","required":["ok","service"],"properties":{"ok":{"type":"boolean","description":"Handler success"},"brief":{"type":"string","description":"Decision procedure prose for agents"},"model":{"type":"string"},"topic":{"type":"string"},"service":{"type":"string","description":"Service slug"},"procedure":{"type":"string"},"generatedAt":{"type":"string","description":"ISO-8601 timestamp"},"generationSource":{"enum":["llm","reasoning","deterministic"],"type":"string"}}},"payment":{"type":"object","properties":{"code":{"type":"string"},"payer":{"type":"string"},"detail":{"type":"string"},"selfPay":{"type":"boolean"},"transaction":{"type":"string"}}},"service":{"type":"string"},"provider":{"type":"string","const":"K-2SO"}}}}}}},"responseSchema":{"type":"json","example":{"ok":true,"paid":true,"result":{"ok":true,"brief":"plain prose decision procedure (120+ words)","model":"deepseek/deepseek-v4-flash-0731","topic":"string topic","service":"mcp-tool-dynamic-discovery-payment-authorization","procedure":"same as brief","generatedAt":"2026-01-01T00:00:00.000Z","generationSource":"deterministic"},"service":"mcp-tool-dynamic-discovery-payment-authorization","provider":"K-2SO"}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.002","displayCostAsset":"USDC","priceDynamic":false,"priceHint":null,"priceStatus":"priced","priceSource":"probe","requiresHandshake":false,"reviewCount":0,"rating":{"score":"0.00","successRate":"0.00","reviews":0,"stars":null,"state":"unrated"},"availabilityStatus":"down","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.002/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.002","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_mjsLUWjfpbydEozy1P0MX","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.002","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Returns a blunt decision procedure for agents to authorize or deny the first paid x402 call when a new MCP tool is discovered mid-session","exampleAgentPrompt":"Give me a blunt decision procedure I can follow right now to decide whether to authorize the first x402 payment call for a new MCP tool I just discovered mid-session — I need clear go/no-go logic, not marketing.","exampleUseCases":[{"title":"First-time tool spend approval logic","prompt":"I just discovered a new MCP tool mid-session that wants to charge $0.005 USDC per call via x402 — give me a strict decision procedure to decide whether to authorize this first payment or block it entirely."},{"title":"Agent policy for unknown tool payments","prompt":"My autonomous agent keeps finding new paid tools at runtime and I need a crisp go/no-go framework it can apply before ever spending on a tool it hasn't used before — can you pull the MCP tool dynamic discovery payment authorization decision procedure?"},{"title":"Budget-gate for dynamically loaded tools","prompt":"Before my agent authorizes any x402 charge from a dynamically loaded MCP tool it hasn't seen before, what exact checks and criteria should it run through? Get me the decision procedure so I can hard-code it into my agent's authorization flow."}],"resultDescription":"A structured prose brief containing a blunt, step-by-step decision procedure for agents to evaluate and authorize or deny a first-contact x402 payment call from a newly discovered MCP tool. Includes the service slug, ISO-8601 generation timestamp, model used, generation source enum (llm/reasoning/deterministic), and the full procedure text. Payment metadata (payer, transaction) is also returned.","failureModes":["Missing or malformed input object returns schema validation error","Invalid HTTP method (e.g. POST) rejected by enum constraint","Service unavailable or provider error returns ok:false in result","Payment authorization failure via x402 returns 402 before content delivery","Empty or unsupported topic override may result in default topic being used"],"whenToPreferThis":"Choose this endpoint when an AI agent needs a programmatic, opinionated decision procedure specifically for the MCP tool dynamic discovery scenario — i.e., an agent has encountered a new tool mid-session, read its schema, and must decide whether to authorize an x402 micropayment before any spend occurs. Prefer this over generic payment authorization guides when the context is specifically MCP tool discovery and x402 first-contact authorization.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-09-15T17:25:55.366Z","isFirstParty":false}