{"uid":"cap_EMmED_vzT0cYXMeh4fMsC","slug":"toolvet-api-search-fb4cf822","name":"ToolVet API Search","description":"The vetted directory of paid APIs and MCP servers for AI agents.","url":"https://toolvet.app/api/v1/search?utm_source=zero.xyz","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"],"type":"string"},"queryParams":{"type":"object","required":["q"],"properties":{"q":{"type":"string","description":"What the service should do, e.g. 'company enrichment by domain'"},"kind":{"enum":["x402","mcp"],"type":"string","description":"Only x402 pay-per-call APIs or only MCP servers"},"limit":{"type":"string","description":"1-50, default 10"},"network":{"type":"string","description":"Only services that accept payment on this CAIP-2 network, e.g. eip155:8453"},"category":{"type":"string","description":"Category slug, see GET /api/v1/categories"},"live_only":{"enum":["true","false"],"type":"string","description":"Only services that passed their latest live check"},"max_price":{"type":"string","description":"Maximum price per call in USD, e.g. '0.01'"},"min_score":{"type":"string","description":"Minimum trust score 0-100"}}}},"additionalProperties":false},"output":{"type":"object","required":["type"],"properties":{"type":{"type":"string"},"example":{"type":"object"}}}}},"responseSchema":{"type":"json","example":{"query":"company enrichment by domain","total":37,"results":[{"id":"weather-forecast","url":"https://api.weather.example/v1/forecast","kind":"x402","name":"Forecast","price":{"usd":0.001,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","atomic":"1000","network":"eip155:8453"},"trust":{"score":91,"verified_owner":true},"usage":{"calls_30d":18233,"payers_30d":412},"health":{"live":true,"uptime_30d":99.6,"latency_p50_ms":210},"category":"geo-weather","provider":"Example Weather","how_to_call":{"url":"https://api.weather.example/v1/forecast","method":"GET","example_input":{"city":"Berlin"}}}],"sponsored":[]}},"example":null,"exampleRequest":null,"tags":["x402"],"displayCostAmount":"0.003","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":"unknown","priceObserved":null,"sessionDeposit":null,"pricing":{"kind":"static","summary":"$0.003/call","primary":{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"},"accepted":[{"kind":"static","protocol":"x402","network":"base","amountUsd":"0.003","per":"call","confidence":"exact"}]},"paymentMethods":[{"uid":"pm_r6BI5ccd8PJRf4jQCkK0y","protocol":"x402","methodType":"crypto","chain":"base","mode":"charge","costAmount":"0.003","costPer":"request","priority":0,"asset":"0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913","unit":"request","depositMicros":null,"planRef":null}],"brandName":null,"brandSlug":null,"brandBaseUrl":null,"brandDocsUrl":null,"whatItDoes":"Search a vetted directory of paid x402 APIs and MCP servers for AI agents by natural language query, with filters for price, trust score, network, and category.","exampleAgentPrompt":"Search ToolVet for vetted x402 APIs that do company enrichment by domain, show me only live services with a trust score above 80, priced under $0.01 per call, and return the top 5 results.","exampleUseCases":[{"title":"Bootstrapping an agent's tool selection","prompt":"I'm building an AI agent and need to find the best paid APIs for geocoding — search ToolVet for x402 geocoding APIs on the Base network, live only, trust score at least 70, and show me up to 10 results."},{"title":"Cost-constrained API discovery","prompt":"Find me vetted APIs for sentiment analysis that cost no more than $0.005 per call — I want the top 5 results with the highest trust scores."},{"title":"MCP server catalog search","prompt":"Search ToolVet for MCP servers that handle PDF extraction — show me up to 10 results, only ones that are currently live."}],"resultDescription":"A JSON object containing the search query echoed back, a total count of matching services, a ranked array of results (each with name, URL, kind, per-call price in USD and on-chain asset details, trust score, 30-day usage and payer counts, health/uptime/latency metrics, category, provider, and a how-to-call block with example input), plus a sponsored array.","failureModes":["Missing required 'q' query parameter returns a 400 validation error","Invalid 'kind' enum value (not 'x402' or 'mcp') returns a 400 error","'limit' outside 1-50 range may return a validation error or be clamped","Unknown 'category' slug returns zero results rather than an error","No matching services returns results array of length 0","Payment failure (insufficient USDC balance) returns 402 before query executes"],"whenToPreferThis":"Use this endpoint when an AI agent needs to programmatically discover and evaluate paid APIs or MCP servers — particularly when filtering by price ceiling, network, trust score, or live status matters. Prefer it over manual API directories when the agent must select tools autonomously at runtime based on capability description, cost, and reliability signals.","instructions":null,"reviewSummary":null,"reviewSummaryHighlights":null,"reviewSummaryConcerns":null,"reviewSummaryGeneratedAt":null,"activationCount":0,"lastUsedAt":null,"lastSuccessfullyRanAt":null,"lastHealthCheckAt":"2026-10-12T12:41:06.910Z","isFirstParty":false,"canonicalSlug":"toolvet-api-search-fb4cf822"}