Discover and pay for APIs with USDC credits. No wallet, no gas, MCP-native marketplace.
Discover and purchase APIs using USDC credits through an MCP-native marketplace.
Captured live from the server via tools/list.
apihub_search
Read-only. Searches onboarded APIHub services by free-text query, with optional category, price, and type filters. Returns up to 10 matches ranked by uptime and endpoint count, each with slug, description, endpoints array, min price in microdollars, provider name, and quality score. No authentication required. Use this when you need to find an API by capability; use apihub_list_services to browse without a query, apihub_search_external to include the external x402 catalog, or apihub_get_service when you already know a slug. Does not call any upstream API or debit credits.
Parameters (4)
querystringrequired
Required free-text query matched against service name and description (case-insensitive substring match). Use 1-3 keywords describing the capability you want, e.g. 'weather' or 'stock price'.
Optional upper bound on price per request in microdollars (1 USD = 1,000,000 microdollars, so 10000 = $0.01). Services whose cheapest endpoint exceeds this are excluded.
typestring
Optional filter. 'api' = standard REST APIs, 'content' = content gateways that proxy a fixed upstream URL.
apihub_list_services
Read-only. Lists onboarded APIHub services alphabetically, returning each service's slug, name, description, category, provider, endpoint count, and lowest per-endpoint price in microdollars. No authentication required. Use this to browse the full onboarded catalog when you don't have a specific capability in mind; prefer apihub_search when filtering by query, category, or price. Does not include external x402 APIs (use apihub_search_external for those) and does not return endpoint-level details (use apihub_get_service for that).
Parameters (1)
limitnumber
Optional max number of services to return. Default 20, minimum 1, hard cap 100. Values above 100 are clamped.
apihub_get_service
Get full details for a specific API service including all endpoints, schemas, and pricing.
Parameters (1)
service_slugstringrequired
The service slug (e.g., 'exchange-rates')
apihub_call
Sends payment. Calls a paid endpoint on an onboarded APIHub service. Debits the endpoint's price from your credit balance and forwards the request to the upstream provider. Returns an object with the upstream response body, HTTP status, and credits_charged_microdollars. Requires a valid API key and sufficient credit balance; if balance is insufficient the call returns a 402 with payment requirements (use apihub_topup to add credits, apihub_balance to check). Use this for services already onboarded to APIHub (find slugs via apihub_search or apihub_list_services); use apihub_call_external for arbitrary x402 URLs not onboarded here, or apihub_read_content for content gateways.
Parameters (4)
service_slugstringrequired
Required. The service slug as returned by apihub_search or apihub_list_services, e.g. 'exchange-rates' or 'weather'.
endpoint_pathstringrequired
Required. The endpoint path including any leading slash, e.g. '/latest/USD' or '/v1/forecast'. Get valid paths from apihub_get_service.
methodstring
Optional HTTP method, default GET. Must match the method declared on the endpoint or the request will fail.
bodystring
Optional. Request body as a JSON string for POST/PUT. Ignored for GET/DELETE. The proxy forwards this verbatim with Content-Type: application/json.
apihub_search_external
Search external x402-protected APIs (not operated by APIHub, but callable via credits). Returns listings with endpoint counts, prices, and on-chain activity.
Parameters (3)
querystring
Search text matched against name/description
categorystring
Filter by category (ai, search, finance, media, other)
limitnumber
Max results (default 10, max 50)
apihub_call_external
Call an external x402-protected URL (any provider in the marketplace or any x402 API). APIHub pays the provider on your behalf using the platform wallet and debits your credit balance for the exact amount. No wallet or gas required.
Parameters (4)
urlstringrequired
The full URL to call (e.g. https://hub.atxp.ai/...)
methodstring
HTTP method (default POST)
bodyany
Request body (object or string). Omit for GET.
headersobject
Additional request headers. Do not set Authorization or X-PAYMENT - handled automatically.
apihub_read_content
Read web content through a paid content gateway. Returns clean, structured text extracted from the URL. Use this for content services (service_type = 'content').
Parameters (2)
service_slugstringrequired
The content service slug
urlstringrequired
The full URL to read (must match a verified domain on the service)
apihub_topup
Purchase APIHub credits via x402 (USDC on Base). Returns payment instructions including a web URL for browser-based payment, a CLI command, and raw x402 requirements for agents with wallet support. Credits are added to your account instantly once payment confirms on-chain.
Parameters (1)
amount_dollarsnumberrequired
Amount to top up in USD. Minimum $5.00, maximum $10,000 per call. Example: 10 for $10.
apihub_balance
Read-only. Returns your current APIHub credit balance (in microdollars and USD), total lifetime spending (microdollars and USD), and total completed request count. Requires a valid API key. Use before apihub_call or apihub_call_external to confirm sufficient funds for a paid request, or periodically to audit usage. Does not modify state, send payments, or call upstream APIs; for top-ups use apihub_topup.
