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.
npx -y @blockchainacademics/mcpThe 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:
~/Library/Application Support/Claude/claude_desktop_config.json%APPDATA%\Claude\claude_desktop_config.json~/.config/Claude/claude_desktop_config.jsonPaste this for the zero-config demo (10 marquee tools, 100 calls/day shared globally):
{
"mcpServers": {
"blockchainacademics": {
"command": "npx",
"args": ["-y", "@blockchainacademics/mcp"]
}
}
}When you are ready for all 105 tools, add the env block with your key:
{
"mcpServers": {
"blockchainacademics": {
"command": "npx",
"args": ["-y", "@blockchainacademics/mcp"],
"env": {
"BCA_API_KEY": "bca_live_xxxxxxxxxxxxxxxx"
}
}
}
}See Demo tier for the full list of 10 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 back to a blockchainacademics.com article via attribution.citations[0].cite_url in the response envelope.
Troubleshooting
| Symptom | Fix |
|---|---|
| Hammer icon missing | Fully quit and relaunch. Check ~/Library/Logs/Claude/mcp*.log. |
BCA_TIER_LOCKED on a tool you expected to work | You are on the demo tier (10 tools). Add BCA_API_KEY to the config env block to unlock all 105: sign up at blockchainacademics.com/crypto-api/signup. |
BCA_RATE_LIMIT errors | The 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. |
| Stale cache after key rotation | Delete ~/.npm/_npx/ and restart. |