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 → AuthenticateAdd 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
| Tool | Needs the account | Does |
|---|---|---|
| search_endpoints | No | Searches the catalog by task, category and price. |
| get_endpoint | No | One endpoint with its params and response schema. |
| call_endpoint | Yes | A paid call, the same as REST: endpoint, params, max_cost. |
| ask | Yes | A question answered from Octio’s own data; the first 20 are free. |
| get_balance | Yes | Balance, spent today, caps and the deposit address. |
| quote_credit_purchase | Yes | A 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.