# Apiosk Connect MCP server

Discover, pay for, execute, and publish APIs through Apiosk.

## Links
- Registry page: https://www.getdrio.com/mcp/io-github-obcraft-apiosk-mcp
- Repository: https://github.com/obcraft/apiosk-mcp
- Website: https://apiosk.com

## Install
- Command: `npx -y @apiosk/mcp`
- Endpoint: https://mcp.apiosk.com/mcp
- Auth: Not captured

## Setup notes
- Package: Npm @apiosk/mcp v1.7.0
- Environment variable: APIOSK_PRIVATE_KEY (secret)
- Environment variable: APIOSK_CONNECT_TOKEN (secret)
- Package: Pypi apiosk-mcp v1.7.0
- Environment variable: APIOSK_PRIVATE_KEY (secret)
- Environment variable: APIOSK_CONNECT_TOKEN (secret)
- Remote endpoint: https://mcp.apiosk.com/mcp

## Tools
- apiosk_help - Explain what Apiosk MCP is, how to connect it, how auth and USDC/x402 payments work, and the recommended workflow for discovery, wallets, and publishing. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_discover - 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. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_explore - Browse Apiosk listing groups and explore one group at a time before narrowing with search. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_inspect_x402 - Read an arbitrary URL's x402 payment terms (price, asset, network, payTo) WITHOUT paying. Use this on an external result's `url` from apiosk_discover before paying: it makes one unauthenticated request, parses the 402 offer, and returns the exact amount so you can confirm the price with the user. Read-only; never spends. apiosk_execute (for Apiosk catalog listings) does not need this. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_execute - Execute any Apiosk API by slug through the uniform /execute contract. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_fetch_paid - Pay an EXTERNAL x402 endpoint (one Apiosk does not host) from the connected wallet and return its data. Use this only for external results from apiosk_discover (executable_via='apiosk_fetch_paid'); for Apiosk catalog listings use apiosk_execute. REQUIRED: call apiosk_inspect_x402 on the url first, tell the user the exact price, and pass that amount as confirmed_price_usdc — the gateway refuses if the live price is higher. The gateway enforces the wallet's per-tx/daily spend limits. Base + USDC only. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_get_api - Fetch full listing detail and agent metadata for a specific Apiosk API slug. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_search - Search and browse the Apiosk catalog by capability, price, or category. For browsing/filtering the catalog. When the goal is to fulfil a user request with real paid data ('get me the live X'), prefer apiosk_discover, which decomposes the need and ranks the best endpoints across sources. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_payment_guide - Explain how to pay through the Apiosk gateway. Returns a buyer guide (how an agent settles a paid API call over USDC/x402, tailored to the current auth) and a provider guide (how to publish an API and get paid). Pass slug to scope buyer guidance to one listing, or role to pick a side. Endpoint: https://mcp.apiosk.com/mcp
- apiosk_list_wallets - List the signed-in user's managed Apiosk wallets. Requires an Apiosk dashboard session from local env auth or hosted MCP authorization. Endpoint: https://mcp.apiosk.com/mcp
- publish_x402_route (Publish a paid x402 route) - Publish an API endpoint as a paid x402 route on the Apiosk gateway. The route gets a paid URL that returns 402 Payment Required until the caller pays in USDC, then forwards to your upstream API. New routes enter Apiosk's review queue (status pending_review) and go live on approval. Requires an Apiosk provider token (Authorization: Bearer sk_live_…). Endpoint: https://mcp.apiosk.com/mcp

## Resources
- ui://apiosk/result-canvas.html - MIME type: text/html+skybridge

## Prompts
Not captured

## Metadata
- Owner: io.github.obcraft
- Version: 1.7.0
- Runtime: Npm, Pypi
- Transports: STDIO, HTTP
- License: Not captured
- Language: Not captured
- Stars: Not captured
- Updated: Jul 22, 2026
- Source: https://registry.modelcontextprotocol.io