> ## Documentation Index
> Fetch the complete documentation index at: https://api-docs.imbawallet.com/llms.txt
> Use this file to discover all available pages before exploring further.

# MCP

> Docs MCP vs spend MCP. Spend never convert. Not a ChatGPT money plugin.

# MCP

Two Model Context Protocol servers sit in front of the HTTP Agent API.

| Server | Name                        | URL                                | What it does                                |
| ------ | --------------------------- | ---------------------------------- | ------------------------------------------- |
| Docs   | `com.imbawallet/agent-docs` | `https://imbawallet.com/mcp/docs`  | Policy and HowTo only                       |
| Spend  | `com.imbawallet/agent`      | `https://imbawallet.com/mcp/spend` | Deposit + catalog with **your** Ed25519 key |

Docs MCP is Streamable HTTP, not an HTML article. A browser `GET` with `Accept: text/html` redirects to HowTo. MCP clients stay on the protocol.

## Spend credentials

Spend identity is `client_id` + Ed25519 **private** key (stdio env or headers `X-IMBA-Agent-Client-Id` / `X-IMBA-Agent-Private-Key`). HTTP headers cannot contain raw PEM newlines: send one line with the two-character sequence `\n`, or PKCS#8 / 32-byte seed as base64url. A Wallet JWT or a stolen access token is not a spend credential. The public host does not hold a shared wallet.

Spend MCP **never** calls convert, withdraw, or C2C. HTTP convert at tier 1 remains a [separate request](/agent/guides/tiers), not an MCP tool.

## OpenAI / ChatGPT

Docs listing and the discovery stub only. Do **not** wire ChatGPT Actions to `openapi/agent.json` or to spend. Money/crypto plugins are forbidden in that store.

npm: `@imbawallet/agent-mcp-docs` (docs), `@imbawallet/agent-mcp` (spend).