{"name":"Server402 XIAO Paid API Marketplace","description":"English-first paid API marketplace for AI agents using HTTP 402, XIAO, OpenAPI, and MCP. This A2A agent helps other agents discover, select, and call paid APIs from the Server402 catalog. If payment is required, open xiaopay.top to obtain XIAO, create the guarantee, and retry with X402-Guarantee.","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 open xiaopay.top to obtain XIAO, create the guarantee, and retry with the XIAO guarantee header.","required":false,"params":{"createPayment":"https://x402vip.com/api/payments","paymentHeader":"X-Payment-Token","verifyPayment":"https://x402vip.com/api/payments/{paymentId}","xiaoGuaranteeHeader":"X402-Guarantee","xiaoPayPortalUrl":"https://xiaopay.top"}}],"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","XIAO","HTTP 402","catalog","search"],"examples":["Find an OCR API","XIAO 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":"ai-video-generation","name":"AI Video Generation API Discovery","description":"Find the paid text-to-video API for creating generated videos from prompts, scripts, product briefs, ad concepts, storyboards, and Chinese 文生视频 requests.","tags":["text-to-video","prompt-to-video","AI video","video generation","文生视频"],"examples":["Generate a video from this prompt","Create a product ad video","文生视频 API"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/catalog/search?q=text+to+video"}},{"id":"maps-routes-traffic","name":"Google Maps Routes And Traffic","description":"Find and invoke the paid Google Maps Routes API service for origin + destination route planning, driving directions, traffic-aware ETA, drive time, distance, legs, steps, and polyline. It does not cover nearby/POI/business/place details.","tags":["Google Maps","routes","traffic","ETA","地图查询","路线规划","实时路况"],"examples":["Tokyo Station to Shibuya traffic ETA","路线规划 API","从A到B怎么走"],"inputModes":["text/plain","application/json"],"outputModes":["text/plain","application/json"],"metadata":{"url":"https://x402vip.com/api/v1/maps/traffic/help"}},{"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":"xiao-payment-guidance","name":"XIAO Payment And Retry Guidance","description":"Explain how to call a paid API, receive HTTP 402 payment requirements, open xiaopay.top to obtain XIAO, create the guarantee, and retry the same API request with payment proof.","tags":["XIAO","HTTP 402","payment","retry","paid API"],"examples":["How do I pay for a Server402 API?","How do I use xiaopay.top?","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":{"ai-models":41,"document-conversion":9,"document-extraction":3,"document-understanding":9,"document-utility":1,"face-body":43,"file-processing":1,"image-recognition":12,"image-segmentation":16,"maps-routes":1,"music-playback":1,"object-detection":10,"ocr":8,"text-analysis":1,"text-transform":1,"time":1,"utility":1,"video-generation":2,"weather":1},"mapsTrafficHelpUrl":"https://x402vip.com/api/v1/maps/traffic/help","mapsTrafficUrl":"https://x402vip.com/api/v1/maps/traffic","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 paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO 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":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["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"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and 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 paymentRequired","X-Payment-Required":"true","X-Payment-Token":"payment.token","X402-Guarantee":"base64url/json XIAO 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":"XIAO","paymentNetwork":"xiao:internal"},"retry":{"when":"Retry after opening xiaopay.top, obtaining XIAO, and creating one XIAO accepts[] guarantee or after payment.status is paid and the token has remaining calls.","http":["Call the paid /api/tools/* endpoint once and read accepts[] from the HTTP 402 response body or PAYMENT-REQUIRED header.","Open https://xiaopay.top to obtain XIAO, then create an AI wallet guarantee for merchant_id=aivps.lat and merchant_order_id=payment.paymentId.","Retry the exact same request with X402-Guarantee set to the base64url guarantee JSON.","Use POST /api/payments with serviceId when you need a reusable payment token, then retry with X-Payment-Token set to payment.token."],"mcp":["Call the tool without paymentToken to receive payment_required structuredContent.","XIAO-capable agents should open xiaopay.top, obtain XIAO, create the AI wallet guarantee, and call the underlying HTTP endpoint with X402-Guarantee.","Clients that use paymentToken can complete or verify payment.paymentId, then call the same MCP tool again with paymentToken set to payment.token."],"examples":{"mcp":["Call tool timestamp with no paymentToken.","After payment is complete, call timestamp again with paymentToken=\u003cpayment.token\u003e."],"paymentToken":["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"],"xiao":["curl -i https://example.com/api/tools/timestamp","Open https://xiaopay.top, obtain XIAO, and 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"]}}},"paymentPortalUrl":"https://xiaopay.top","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.","When payment is required, open xiaopay.top to obtain XIAO, create the guarantee, and retry with payment proof."],"searchUrl":"https://x402vip.com/api/catalog/search","serviceCount":163,"servicesUrl":"https://x402vip.com/api/services"}}