apiosk_discover
ActiveTool of Apiosk
declared in 1.7.0
Find the best paid x402 API for a data capability across discovery sources (Apiosk catalog + federated external listings). Decompose the user's request into capability segments first, then call this once per capability. Returns a normalized, ranked list; each result's `executable_via` says whether to call apiosk_execute (Apiosk-settled) or apiosk_inspect_x402 + apiosk_fetch_paid (external). Use this instead of apiosk_search when the goal is 'get real paid data for X', not just browsing.
Parameters schema
{
"type": "object",
"required": [
"query"
],
"properties": {
"query": {
"type": "string",
"description": "The data capability to find, e.g. 'realtime USD exchange rate' or 'company registry lookup by domain'."
},
"sources": {
"type": "array",
"items": {
"enum": [
"all",
"apiosk",
"bazaar",
"x402-list",
"x402-direct",
"agentic-market",
"thirdweb",
"payai",
"x402engine",
"anchor-x402",
"apify",
"x402scan",
"wellknown"
],
"type": "string"
},
"description": "Discovery sources to query. Default ['apiosk','bazaar']. Use ['all'] for every directly wired free REST source. Paid sources 'x402scan' and 'apify' are opt-in and return their payable endpoint for apiosk_inspect_x402 + apiosk_fetch_paid; discovery never spends automatically. Add 'wellknown' with probe_hosts for a specific host."
},
"segments": {
"type": "array",
"items": {
"type": "string"
},
"description": "Optional: the user's request pre-decomposed into distinct data capabilities. Each is searched and merged."
},
"max_results": {
"type": "number",
"description": "Maximum results to return (default 8, max 25)."
},
"probe_hosts": {
"type": "array",
"items": {
"type": "string"
},
"description": "For the 'wellknown' source: explicit hostnames to probe for a /.well-known/x402 document (e.g. 'x402.example.com'). No speculative crawling — only hosts you name here are probed."
},
"max_price_usdc": {
"type": "number",
"description": "Optional per-call price ceiling in USDC. Results above this are dropped."
}
}
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Apiosk
https://github.com/obcraft/apiosk-mcp
1/7 registries