Docs navigation

Claude Desktop

Install the Crypto Brain MCP server in Claude Desktop in under a minute. Once installed, Claude can call any of the 105 tools directly from a chat: no extra UI, no copy-paste.

1. Install

BCA ships as a zero-install npx package. No global install, no Docker, no Python.

bash
npx -y @blockchainacademics/mcp

The first run downloads the package and prints a usage banner. Press Ctrl+C: you only ran it once to prime the npm cache. Claude Desktop invokes it on demand.

2. Add to your Claude Desktop config

Open your Claude Desktop config file:

bash
~/Library/Application Support/Claude/claude_desktop_config.json

Paste this for the zero-config demo (17 tools, 100 calls/day shared globally):

claude_desktop_config.json
json
{
  "mcpServers": {
    "blockchainacademics": {
      "command": "npx",
      "args": ["-y", "@blockchainacademics/mcp"]
    }
  }
}

When you have a key, add the env block with it:

claude_desktop_config.json
json
{
  "mcpServers": {
    "blockchainacademics": {
      "command": "npx",
      "args": ["-y", "@blockchainacademics/mcp"],
      "env": {
        "BCA_API_KEY": "bca_xxxxxxxxxxxxxxxx"
      }
    }
  }
}

See Demo tier for the full list of the 17 zero-config tools and what falls under the upgrade.

3. Restart Claude Desktop

Fully quit Claude Desktop (not just the window: Cmd+Q on macOS) and relaunch. You should see a small hammer icon in the chat input bar. Click it and confirm blockchainacademics appears with 105 tools listed.

4. Try it

In a new chat, paste:

"Use the BCA tools to summarize this week's regulatory news on Circle, with citations."

Claude will call search_news with entity="circle" and topic="regulation", then assemble a cited summary. Every quoted fact links to its source through attribution.citations[0].cite_url in the response envelope.

Troubleshooting

SymptomFix
Hammer icon missingFully quit and relaunch. Check ~/Library/Logs/Claude/mcp*.log.
BCA_TIER_LOCKED on a tool you expected to workYou are on the demo key (17 tools). Add BCA_API_KEY to the config env block: sign up at blockchainacademics.com/crypto-api/signup.
HTTP 402 on a tool, with a key setYour plan is below the tool's tier, and the message names the tier it needs. Plans are on Pricing.
BCA_RATE_LIMIT errorsThe demo bucket is 100 calls a day shared plus 20 a day per IP. The free tier is 2,000 calls a month per user: sign up at blockchainacademics.com/crypto-api/signup.
BCA_AUTH after rotating the keyThe old key stops at once. Paste the new key into the env block and fully restart the client.

Next up