Cambrian API MCP server

Cambrian API MCP

Model Context Protocol server for the Cambrian API. It exposes the same product surface as the cambrian CLI for agents that need live DeFi, social intelligence, risk, and API documentation tools.

Every call needs a Cambrian API key supplied by the caller. The hosted server and local package both require one; the server never ships or proxies a shared key. Create a key at https://console.cambrian.org/. For x402 pay-per-call access without an API key, use cambrian pay --help; MCP transport still requires a caller-supplied key.

What You Get

• a progressive default profile with one concise tool per public Cambrian API endpoint
• compact and full profiles for clients with different tool-loading behavior
• a composite workflow tool for Solana token snapshots
• cambrian_docs for live endpoint and guide docs from https://docs.cambrian.org/llms.txt
• stdio transport for local MCP clients
• Streamable HTTP transport for hosted and self-hosted deployments

Tool Profiles

All profiles use the same progressive documentation flow. cambrian_docs returns the request schema by default. Set detail to response for response fields. The response view also includes the request schema. Set detail to full only for examples and all endpoint prose. The full profile does not preload response documentation for every endpoint.

Progressive omits repeated endpoint descriptions, long patterns, large array enums, and parameter prose. Call cambrian_docs for these details.

Progressive also omits offset, orderasc, and orderdesc. These three are the same on every endpoint that has them, and Progressive already strips the per-endpoint sortable-column enum, so repeating them adds about 10 kB to the tool list and tells the agent nothing. The server instructions name them once, and every endpoint still accepts them. limit stays, with its maximum, because it is how an agent bounds a response.

Toolsets

The whole catalog is 141 tools. An agent that only asks about Solana still pays for 99 EVM tools it will never call. Use --toolsets to load only what you need.

npx -y cambrian-api-mcp --toolsets solana,risk
CAMBRIAN_TOOLSETS=solana npx -y cambrian-api-mcp

Over HTTP, select per request: https://mcp.cambrian.org/mcp?toolsets=solana.

Omit the option, or pass all, to get every tool. cambrian_docs is always present, so a narrowed client can still discover and read about any endpoint.

Progressive tools/list sizes:

How MCP Clients Load Tools

The MCP client receives the complete tools/list result for the selected profile. MCP does not control how much of that result enters the model context.

Claude Code normally loads tool names and server instructions first. It loads complete selected tool definitions after Tool Search. Codex can do the same when its Tool Search feature is available. Other clients can load every tool definition at the start.

Shortened. The full README is on GitHub.