QuickstartClaude Desktop

Claude Desktop

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

Prerequisite: Claude Desktop v0.9 or newer, and a BCA API key. Grab a free key →

1. Install

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

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:

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

Paste the following (or merge into your existing mcpServers block):

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

Replace bca_YOUR_KEY_HERE with your real key from the dashboard. Never commit this file to git — Claude Desktop stores it in your home directory for a reason.

3. Restart Claude Desktop

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

Screenshot coming in v0.3 — add your final capture at public/screenshots/claude-desktop-tool-call.png and re-enable the image reference in this file.

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 the cite_url field in the response envelope.

Troubleshooting

SymptomFix
Hammer icon missingFully quit and relaunch. Check ~/Library/Logs/Claude/mcp*.log.
”Missing BCA_API_KEYConfirm the env block in config. No quotes around the var name.
”BCA_RATE_LIMIT” errorsFree tier is 60 req/min — upgrade at blockchainacademics.com/pricing.
Stale cache after key rotationDelete ~/.npm/_npx/ and restart.

Next up