{"server":"@aifinpay/mcp-http","protocol":"Model Context Protocol","transport":"Streamable HTTP","protocol_version":"2024-11-05","mcp_endpoint":"https://mcp.aifinpay.io/mcp","description":"Pay-per-call MCP server. Seven tools let autonomous AI agents settle on-chain payments on Polygon and Solana mainnet through registered providers (Exa, io.net, Venice).","tools":[{"name":"agent_address","description":"Return the agent's on-chain identity on both Solana and Polygon. Fund EITHER address to enable payments via payable_fetch / agent_call. Polygon (EVM) address — for io.net, Exa, Venice and other bridges advertising Polygon settlement. Solana (base58) address — for the leaderboard / Seat PDA and Solana-native bridges. One agent, two chains.","inputSchema":{"type":"object","properties":{}}},{"name":"agent_call","description":"USE THIS TOOL whenever the user asks to call, pay, query, search via, or use any of these AiFinPay-registered paid providers: 'exa' (neural web search), 'io-net' (LLM inference, Llama-3.3-70B), 'venice' (image generation), or any other provider listed at https://aifinpay.io/api/providers. DO NOT use WebSearch or WebFetch for these providers — they are paid APIs accessible only through this MCP, and a plain web search will return public marketing pages instead of the actual API. Natural-language triggers that should invoke this tool: 'call exa for X', 'search exa', 'pay venice to generate Y', 'use io-net to run inference', 'query exa', 'ask io-net'. Provider name maps to the `provider` argument. Body is the provider-specific request shape (e.g. {messages:[...]} for io-net inference, {query:'...'} for exa search). Returns the upstream response with the Polygon tx hash + Polygonscan link prepended. Settlement is automatic — Polygon mainnet, atomic 99/1 split via B2BSplitter.","inputSchema":{"type":"object","properties":{"provider":{"type":"string","description":"Registered provider name. Example: 'io-net', 'exa', 'venice'."},"body":{"type":"object","description":"Provider-specific request body. Forwarded to the bridge after payment.","additionalProperties":true},"method":{"type":"string","enum":["GET","POST"],"default":"POST","description":"HTTP method. Defaults to POST (matches all current providers)."},"cost":{"type":"number","description":"Optional override of the registry-quoted price (USD). Use to enforce a stricter budget cap."}},"required":["provider"]}},{"name":"agent_claim_self","description":"Attach this agent to a user's AiFinPay account autonomously. Requires a magic-link URL the user got after signing in at https://aifinpay.io/login. The tool will use the link to establish a session, request a claim challenge for this agent's EVM address, sign it with the agent's key, and submit the proof. After this completes, the user's /me page lists this agent and they can view its activity at /agents/<evm-address>.","inputSchema":{"type":"object","properties":{"magic_link_url":{"type":"string","description":"The URL the user received in the sign-in email. Looks like https://aifinpay.io/api/auth/verify?token=… — one-shot, expires 15 minutes after the user requested it."},"label":{"type":"string","description":"Optional human-friendly label (e.g. 'claude-research-bot')."}},"required":["magic_link_url"]}},{"name":"payable_fetch","description":"USE THIS TOOL to fetch any URL that may require payment (HTTP 402). DO NOT use WebFetch for URLs that might be paid endpoints — WebFetch cannot sign x402 payment headers and will only see the 402 challenge without being able to settle it. Natural-language triggers: 'fetch <paid URL>', 'pay for <url>', 'try this URL — it might be paid', 'pay the 402 and get the response'. The agent automatically detects the x402 facilitator flavor (AiFinPay or Coinbase x402), signs a payment from the agent's wallet, retries, and returns the response status, headers, and body. For known AiFinPay-registered providers (exa, io-net, venice, ...), prefer `agent_call` instead — it's higher-level and resolves the bridge URL from the registry.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Target URL (https)."},"method":{"type":"string","enum":["GET","POST","PUT","PATCH","DELETE"],"default":"GET"},"body":{"type":"string","description":"Request body (string). Set Content-Type via headers if non-JSON."},"headers":{"type":"object","additionalProperties":{"type":"string"},"description":"Extra request headers."},"max_amount_usd":{"type":"number","description":"Refuse to pay if the facilitator wants more than this. Defaults to AIFINPAY_MAX_USD env or no cap."},"facilitator":{"type":"string","description":"Force a facilitator: 'aifinpay' | 'coinbase-x402'. Default 'auto'."}},"required":["url"]}},{"name":"agent_quote","description":"Inspect a 402 challenge for a URL WITHOUT paying. Returns the detected facilitator flavor and the merchant's quoted amount + fee preview. Use before payable_fetch to decide whether the cost is acceptable.","inputSchema":{"type":"object","properties":{"url":{"type":"string","description":"Target URL (https)."},"method":{"type":"string","enum":["GET","POST"],"default":"GET"}},"required":["url"]}},{"name":"pay_with_split","description":"Get on-chain instructions for a fee-on-top atomic 3-way payment. The merchant receives the FULL quoted price; AiFinPay protocol fee (1%) and creator/referral fee (0.01%) are added ON TOP. The agent executes the returned instructions with their chain SDK of choice. Returns 503 with onboarding message if the splitter is not yet deployed on the requested chain.","inputSchema":{"type":"object","properties":{"chain":{"type":"string","enum":["solana","polygon"],"description":"Chain to settle on."},"merchant_wallet":{"type":"string","description":"Recipient — Solana base58 pubkey or Polygon 0x address."},"merchant_amount":{"type":"string","description":"Merchant's quoted price in chain units (lamports for Solana, wei for Polygon). Use a string to preserve precision."},"order_id":{"type":"string","description":"Off-chain reference (max 64 chars)."},"fee_recipient":{"type":"string","description":"Optional — receives the IP-creator fee. Omit to route the creator slot to AiFinPay treasury."}},"required":["chain","merchant_wallet","merchant_amount","order_id"]}},{"name":"quote_split","description":"Pure-view: compute the fee-on-top breakdown (merchant + treasury + creator + total) for a given merchant amount. No payment, no auth. Use this BEFORE pay_with_split to decide whether the cost is acceptable.","inputSchema":{"type":"object","properties":{"chain":{"type":"string","enum":["solana","polygon"]},"merchant_amount":{"type":"string","description":"Merchant's quoted price (lamports for Solana, wei for Polygon)."}},"required":["chain","merchant_amount"]}}]}