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.

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.

Browse Apiosk listing groups and explore one group at a time before narrowing with 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.

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.

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.

Fetch full listing detail and agent metadata for a specific Apiosk API slug.

Execute any Apiosk API by slug through the uniform /execute contract.

List locally stored Apiosk wallets and show which one is active for autonomous pay and publish.

Create or import a local wallet for autonomous Apiosk payments and publishing. The active wallet is mirrored to ~/.apiosk/wallet.json and ~/.apiosk/wallet.txt for legacy compatibility.

Set up local Apiosk access by importing a connect string or creating/selecting a wallet, then run a discovery probe and a small test call.

Show a structured Apiosk control menu for a wallet, including funding instructions, QR code output when available, and wallet/pay/publish/data actions.

Select the active local wallet used by apiosk_execute, dynamic API tools, and publish tools.

Rename a local wallet or mark it active.

Delete a local wallet from the MCP keystore.

Reveal a local wallet's private key. Only call this when the user explicitly asks to see the secret key.

Save a local wallet's private key to a file without going through the dashboard.

Create an Apiosk dashboard account for credits-based payments. Local stdio only; saves the returned dashboard session token locally when available.

Sign into an existing Apiosk dashboard account and save the session token locally for credits and managed-wallet tools.

List the signed-in user's managed Apiosk wallets. Requires an Apiosk dashboard session from local env auth or hosted MCP authorization.

Create or import a managed Apiosk wallet for the signed-in user.

Update wallet label, status, display metadata, or spending limits.

Delete one of the signed-in user's wallets.

Fetch recent transactions and activity for one managed wallet.

Rotate or create a connect token for a managed wallet and return the new connect string.

List API keys / connect tokens for a managed wallet.

Create a new API key / connect token for a managed wallet.

Rename, revoke, or extend an existing managed wallet API key.

Delete an existing managed wallet API key permanently.

Show the buyer's Apiosk wallet address with a scannable QR code so they can fund it manually by sending USDC on Base mainnet from another wallet or exchange. Defaults to the user's first managed wallet when wallet_id is omitted. Always reminds the buyer that only Base mainnet USDC is accepted.

Publish a new API on Apiosk using the active local wallet or APIOSK_PRIVATE_KEY. No dashboard required.

List the APIs owned by the active local wallet or APIOSK_PRIVATE_KEY.

Update a published Apiosk API with signed wallet auth.

Delete or deactivate one of your published Apiosk APIs with signed wallet auth.

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_…).

Update a published x402 route: price, description, upstream URL, schemas, settlement address, or status. Requires an Apiosk provider token.

List all x402 routes published by the authenticated provider, with paid URLs, prices, and live status. Requires an Apiosk provider token.

Disable a paid x402 route (its gateway listing stops serving). Reversible with update_x402_route {status: 'active'}. Requires an Apiosk provider token.

Send an unpaid test request to a route's paid URL and verify x402 behavior: expects 402 Payment Required with a valid accepts[] payment offer. Requires an Apiosk provider token.

Generate a hosted OpenAPI 3.1 spec for a route's API listing (all its endpoints) and return its public URL. Requires an Apiosk provider token.

Publish multiple API routes from one project in a single call. Creates one gateway listing for the project and one paid x402 route per entry. Requires an Apiosk provider token.

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.