How to connect Octio to Claude, ChatGPT or Cursor with MCP

How do I connect an API marketplace to Claude, ChatGPT or Cursor through MCP?

Add https://www.octio.xyz/mcp as a remote MCP server (Streamable HTTP). Claude and ChatGPT sign in with your wallet through OAuth; Claude Code and Cursor can send an API key as Authorization: Bearer. Searching the catalog needs no key, and paid calls come from your CREDIT balance.

Claude and ChatGPT

  • claude.ai, Claude Desktop and mobile: add https://www.octio.xyz/mcp as a custom connector. With “Sign in when needed”, Claude browses first and asks you to sign in the first time a tool needs your account.
  • ChatGPT: add it as a custom MCP server with OAuth as the authentication.

Signing in opens octio.xyz, where the owner wallet signs in and approves the app. A connected app spends within the account’s per-call maximum and daily cap, and cannot withdraw, create keys or change limits. Disconnect it on the account page.

Claude Code

Add Octio to Claude Code with a wallet sign-in

claude mcp add --transport http Octio {{origin}}/mcp
# then, inside Claude Code: /mcp → Octio → Authenticate

Add Octio to Claude Code with an API key

claude mcp add --transport http Octio {{origin}}/mcp \
  --header "Authorization: Bearer $TM_KEY"

Cursor and other JSON-configured clients

Cursor and most clients that support remote servers accept this shape in their MCP config file; the exact file and key names vary by client.

MCP JSON config

{
  "mcpServers": {
    "octio": {
      "url": "{{origin}}/mcp",
      "headers": { "Authorization": "Bearer oct_live_…" }
    }
  }
}

The tools

Octio MCP tools
ToolNeeds the accountDoes
search_endpointsNoSearches the catalog by task, category and price.
get_endpointNoOne endpoint with its params and response schema.
call_endpointYesA paid call, the same as REST: endpoint, params, max_cost.
askYesA question answered from Octio’s own data; the first 20 are free.
get_balanceYesBalance, spent today, caps and the deposit address.
quote_credit_purchaseYesA quote and three transactions to buy CREDIT with USDG.

There is one generic call_endpoint tool rather than one tool per endpoint, so new listings work without any client change. Publishing tools for listing your own API are in the docs.

FAQ

Do I need an API key to use the MCP server?

Not to search and read endpoints. Paid tools need the account: a wallet sign-in in apps that support OAuth, or an API key.

Which transport does the server use?

Streamable HTTP at https://www.octio.xyz/mcp.

Can a connected app drain my balance?

It can spend only within the per-call maximum and daily cap you set, and it cannot withdraw or create keys.

Updated 2026-11-16.