{"name":"Server402 x402 Paid API Marketplace","description":"English-first paid API marketplace for AI agents using HTTP 402, x402, OpenAPI, and MCP. This A2A agent helps other agents discover, select, and call paid APIs from the Server402 catalog.","supportedInterfaces":[{"url":"https://x402vip.com/a2a","protocolBinding":"HTTP+JSON","protocolVersion":"1.0","description":"Stateless A2A SendMessage endpoint. POST /a2a/message:send with a natural-language API need to receive catalog matches and payment-aware invocation links."}],"provider":{"organization":"Server402","url":"https://x402vip.com"},"version":"1.0.0","documentationUrl":"https://x402vip.com/ai.txt","capabilities":{"streaming":false,"pushNotifications":false,"extensions":[{"uri":"https://x402vip.com/extensions/server402-catalog/v1","description":"Links the A2A agent to the complete Server402 paid API catalog, OpenAPI document, OpenAI function definitions, and MCP tool endpoint.","required":false,"params":{"catalogUrl":"https://x402vip.com/api/catalog","mcpUrl":"https://x402vip.com/mcp","openaiFunctionsUrl":"https://x402vip.com/api/catalog/openai-functions.json","openapiUrl":"https://x402vip.com/api/catalog/openapi.json","searchUrl":"https://x402vip.com/api/catalog/search","servicesUrl":"https://x402vip.com/api/services"}},{"uri":"https://x402vip.com/extensions/http-402-payment/v1","description":"Describes how selected services return HTTP 402 payment requirements and how clients retry with a paid token or x402 payment header.","required":false,"params":{"createPayment":"https://x402vip.com/api/payments","paymentHeader":"X-Payment-Token","verifyPayment":"https://x402vip.com/api/payments/{paymentId}","x402PaymentHeader":"PAYMENT-SIGNATURE","xiaoGuaranteeHeader":"X402-Guarantee"}}],"extendedAgentCard":true},"defaultInputModes":["text/plain","application/json"],"defaultOutputModes":["text/plain","application/json"],"skills":[{"id":"paid-api-catalog-search","name":"Paid API Catalog Search","description":"Search all published Server402 paid APIs by natural-language task, category, input/output type, and price. Returns matching service IDs, endpoints, schemas, pricing, payment flow, and quality hints.","tags":["paid API","x402","HTTP 402","catalog","search"],"examples":["Find an OCR API","x402 paid api","document parsing","weather API"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/catalog/search"}},{"id":"document-intelligence","name":"Document Intelligence API Discovery","description":"Find APIs for document parsing, extraction, table understanding, OCR, PDF conversion, summarization, and document search.","tags":["document parsing","PDF","OCR","table extraction","document conversion"],"examples":["Extract tables from a PDF","Convert PDF to Markdown","OCR scanned documents"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/catalog/search?q=document+parsing+ocr+pdf"}},{"id":"ocr-computer-vision","name":"OCR And Computer Vision API Discovery","description":"Find text recognition and image understanding APIs, including multilingual OCR, ID/document OCR, image tagging, detection, segmentation, and face/image utilities.","tags":["OCR","computer vision","image recognition","text extraction"],"examples":["Recognize English text in an image","Tag objects in a product photo","Read ID card text"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/catalog/search?q=ocr+image+recognition"}},{"id":"weather-apis","name":"Global Weather API Discovery","description":"Find city-level weather and forecast API candidates and published weather-related services for AI agents.","tags":["weather","forecast","city weather","global weather"],"examples":["Tokyo weather API","Singapore weather","Los Angeles forecast"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/catalog/search?q=weather"}},{"id":"x402-payment-guidance","name":"x402 Payment And Retry Guidance","description":"Explain how to call a paid API, receive HTTP 402 payment requirements, create or settle a payment, and retry the same API request with payment proof.","tags":["x402","HTTP 402","payment","retry","paid API"],"examples":["How do I pay for a Server402 API?","What header do I resend after payment?"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/ai.txt"}},{"id":"planned-api-demand-capture","name":"Planned API Demand Capture","description":"Expose planned API candidates and early-access request paths so agents can ask for APIs not yet published in the paid catalog.","tags":["planned API","early access","demand capture","request access"],"examples":["I need a competitor traffic API","I need product price monitoring"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/demand-capture"}}],"metadata":{"agentCardUrl":"https://x402vip.com/.well-known/agent-card.json","catalogUrl":"https://x402vip.com/api/catalog","categoryCounts":{"document-conversion":9,"document-extraction":3,"document-understanding":9,"document-utility":1,"face-body":43,"image-recognition":12,"image-segmentation":16,"music-playback":1,"object-detection":10,"ocr":7,"text-analysis":1,"text-transform":1,"time":1,"utility":1,"weather":1},"mcpUrl":"https://x402vip.com/mcp","openaiFunctionsUrl":"https://x402vip.com/api/catalog/openai-functions.json","openapiUrl":"https://x402vip.com/api/catalog/openapi.json","payment":{"paymentHeader":"X-Payment-Token","createPayment":"/api/payments","verifyPayment":"/api/payments/{paymentId}","token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json x402PaymentRequired","PAYMENT-SIGNATURE":"base64/json x402 Base USDC payment payload","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json Xiao Coin escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","paymentNetwork":"eip155:8453"},"retry":{"when":"Retry after paying one accepts[] requirement with Base USDC x402, Xiao Coin AI wallet escrow, or after payment.status is paid and the legacy token has remaining calls.","http":["Preferred x402 flow: call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Pay one accepts[] requirement with an x402-compatible wallet/facilitator on network eip155:8453 using Base USDC.","Retry the exact same request with PAYMENT-SIGNATURE set to the base64 JSON x402 payment payload.","XIAO flow: pay the accepts[] requirement where asset=XIAO with the AI wallet, then retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Legacy token flow: POST /api/payments with serviceId, complete/verify payment, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","Preferred x402 clients should pay the accepts[] requirement and call the underlying HTTP endpoint with PAYMENT-SIGNATURE.","XIAO-capable agents should pay the XIAO accepts[] requirement through the AI wallet and call the underlying HTTP endpoint with X402-Guarantee.","Legacy MCP clients can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"http402":["curl -i https://example.com/api/tools/timestamp","Read accepts[0].network=eip155:8453, accepts[0].asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, accepts[0].amount, and accepts[0].payTo.","curl -H 'PAYMENT-SIGNATURE: \u003cbase64-json-x402-payment-payload\u003e' https://example.com/api/tools/timestamp"],"legacyToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"xiao":["curl -i https://example.com/api/tools/timestamp","Read the accepts[] entry with asset=XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]},"flow":{"type":"http-402","createPayment":{"method":"POST","url":"/api/payments","bodySchema":{"properties":{"providerId":{"type":"string"},"serviceId":{"description":"Use the canonical service id from the catalog. Legacy internal ids remain accepted for backward compatibility.","type":"string"}},"required":["serviceId"],"type":"object"},"responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"verifyPayment":{"method":"GET","url":"/api/payments/{paymentId}","responseSchema":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"}},"token":{"header":"X-Payment-Token","mcpArgument":"paymentToken","httpUsage":"Send the paid token in the X-Payment-Token request header when calling /api/tools/*.","mcpUsage":"Pass the paid token as the paymentToken argument when calling the MCP tool."},"requiredResponse":{"status":402,"contentType":"application/json","headers":{"PAYMENT-REQUIRED":"base64/json x402PaymentRequired","PAYMENT-SIGNATURE":"base64/json x402 Base USDC payment payload","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json Xiao Coin escrow guarantee"},"bodySchema":{"properties":{"accepts":{"items":{"type":"object"},"type":"array"},"error":{"type":"string"},"extensions":{"type":"object"},"payment":{"properties":{"amountCents":{"type":"integer"},"amountMicros":{"type":"integer"},"billingMode":{"type":"string"},"clientId":{"type":"string"},"currency":{"type":"string"},"expiresAt":{"format":"date-time","type":"string"},"internalServiceId":{"description":"Legacy internal service id, included only for backward compatibility.","type":"string"},"maxCalls":{"type":"integer"},"paidAt":{"format":"date-time","type":"string"},"payTo":{"type":"string"},"paymentId":{"type":"string"},"provider":{"type":"string"},"providerId":{"type":"string"},"remainingCalls":{"type":"integer"},"serviceId":{"description":"Canonical public service id.","type":"string"},"status":{"type":"string"},"token":{"type":"string"},"usedCalls":{"type":"integer"}},"type":"object"},"paymentFlow":{"type":"object"},"resource":{"type":"object"},"retry":{"type":"object"},"type":{"const":"payment_required","type":"string"},"x402Version":{"type":"integer"}},"required":["type","error","payment","paymentFlow","retry"],"type":"object"},"x402Version":2,"x402Header":"PAYMENT-REQUIRED","paymentAsset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","paymentNetwork":"eip155:8453"},"retry":{"when":"Retry after paying one accepts[] requirement with Base USDC x402, Xiao Coin AI wallet escrow, or after payment.status is paid and the legacy token has remaining calls.","http":["Preferred x402 flow: call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Pay one accepts[] requirement with an x402-compatible wallet/facilitator on network eip155:8453 using Base USDC.","Retry the exact same request with PAYMENT-SIGNATURE set to the base64 JSON x402 payment payload.","XIAO flow: pay the accepts[] requirement where asset=XIAO with the AI wallet, then retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Legacy token flow: POST /api/payments with serviceId, complete/verify payment, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","Preferred x402 clients should pay the accepts[] requirement and call the underlying HTTP endpoint with PAYMENT-SIGNATURE.","XIAO-capable agents should pay the XIAO accepts[] requirement through the AI wallet and call the underlying HTTP endpoint with X402-Guarantee.","Legacy MCP clients can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"http402":["curl -i https://example.com/api/tools/timestamp","Read accepts[0].network=eip155:8453, accepts[0].asset=0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913, accepts[0].amount, and accepts[0].payTo.","curl -H 'PAYMENT-SIGNATURE: \u003cbase64-json-x402-payment-payload\u003e' https://example.com/api/tools/timestamp"],"legacyToken":["curl -X POST https://example.com/api/payments -H 'Content-Type: application/json' -d '{\"serviceId\":\"timestamp\"}'","curl -H 'X-Payment-Token: \u003cpayment.token\u003e' https://example.com/api/tools/timestamp"],"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"xiao":["curl -i https://example.com/api/tools/timestamp","Read the accepts[] entry with asset=XIAO, create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","curl -H 'X402-Guarantee: \u003cbase64url-guarantee-json\u003e' https://example.com/api/tools/timestamp"]},"failures":["payment required","payment token expired","payment token has no remaining calls","api key required","api key is not allowed to call this service"]}}},"recommendedWorkflow":["Read this Agent Card.","POST an A2A SendMessage request to /a2a/message:send with the task text, or call /api/catalog/search?q=task directly.","Inspect returned service schemas, endpoint, price, and payment flow.","Call the selected endpoint once to receive HTTP 402 payment requirements, pay, then retry with payment proof."],"searchUrl":"https://x402vip.com/api/catalog/search","serviceCount":117,"servicesUrl":"https://x402vip.com/api/services"}}