Blockchainacademics

@blockchainacademics/mcp

The canonical crypto MCP server for AI agents. 105 tools spanning 3,800+ editorial articles, 150+ entity dossiers, 38 academy lessons in 8 courses, aggregated market + on-chain data, proprietary indicators, and async agent-backed generation, all exposed as MCP tools your AI agent can call natively.

Tool categories

Every tool response carries attribution.citations[] (each entry a cite_url, an as_of time and a source_hash) and a meta.status that says how complete the answer is (see Response status).

Tools whose data source is not connected yet (bonk.fun, CoinGlass liquidations and exchange flows, the degen leaderboard, the memecoin analyzer, among others) answer with meta.status: "unseeded" and a reason instead of failing, and their descriptions say so.

Why

LLMs hallucinate about crypto. BCA ships ground-truth editorial content with full attribution. Plug this MCP server into Claude Desktop, LangChain, Eliza, or any MCP-compatible agent and your model queries the BCA corpus like any other tool, with citations, timestamps, and source hashes on every response.

Install

Claude Desktop (zero-config demo)

The package ships with a public demo key baked in. No signup needed to try it. Add to claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/claude_desktop_config.json):

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

Restart Claude Desktop. 17 tools work without a key, with real data and real citations:

get_price, get_trending, get_fear_greed, get_market_overview, search_news, get_article, get_sentiment, get_entity, get_explainer, get_recent_stories, get_topic, search_grants, get_grant, list_jobs, get_job, search_academy, get_as_of_snapshot

get_entity works by slug without a key; its ticker form needs one. Every other tool answers with a clean upgrade message (BCA_TIER_LOCKED) that links to the free signup. Demo calls share a daily cap: 100 calls a day across all demo users, and 20 a day per IP.

Claude Desktop (with an API key)

Get a free key at blockchainacademics.com/crypto-api/signup (2,000 calls/month per user) and add the env block:

{  "mcpServers": {    "blockchainacademics": {      "command": "npx",      "args": ["-y", "@blockchainacademics/mcp"],      "env": { "BCA_API_KEY": "bca_live_xxxxxxxxxxxxxxxx" }    }  }}

Restart Claude Desktop. All 105 tools appear in the tool picker: a free key opens 52 of them, and paid plans open the rest (see API Key).

Programmatic (LangChain, Eliza, custom agents)

npm install @blockchainacademics/mcp

import { Client } from "@modelcontextprotocol/sdk/client/index.js";import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js";
const transport = new StdioClientTransport({  command: "npx",  args: ["-y", "@blockchainacademics/mcp"],  env: { BCA_API_KEY: process.env.BCA_API_KEY! },});const client = new Client({ name: "my-agent", version: "0.0.1" }, { capabilities: {} });await client.connect(transport);
const res = await client.callTool({  name: "search_news",  arguments: { query: "stablecoin regulation", limit: 5 },});console.log(res.content);

See examples/research-agent.ts for a full tool-chaining loop.

Tools

search_news

Full-text search across 3,800+ editorial crypto articles.

Example: { "query": "circle IPO", "since": "2026-01-01T00:00:00Z", "limit": 5 }

get_entity

Fetch an entity dossier. Provide exactly one of:

Aliases in slug form resolve to the canonical entity (cz → changpeng-zhao, maker → makerdao, bsc → bnb-chain, …).

get_explainer

Fetch BCA Academy material (38 lessons in 8 courses). Provide exactly one of:

Response status

meta.status says how complete an answer is. Branch on it before you trust data:

Lists that page by offset (search_news, search_grants, list_entities, list_entity_mentions, search_academy) set meta.pageInfo.hasNextPage when more results exist.

Attribution

Every response includes a structured attribution block with a citations array:

{  "data": { ... },  "attribution": {    "citations": [      {        "cite_url": "https://www.coingecko.com/en/coins/bitcoin",        "as_of": "2026-11-01T12:34:56Z",        "source_hash": "sha256:..."      },      {        "cite_url": "https://blockchainacademics.com/...?src=...",        "as_of": "2026-11-01T12:34:56Z",        "source_hash": "sha256:..."      }    ]  },  "meta": { "status": "complete", "request_id": "...", "pageInfo": { ... } }}

citations[0] is the primary source: the upstream page when the data has one (the original article, CoinGecko, Etherscan, DefiLlama, a regulator), otherwise the BCA page for the record, otherwise the tool's entry in the API reference. A BCA link follows the upstream one only where the site has a page for the data. When your agent surfaces BCA content to a user, attribute via citations[0].cite_url. Fields are preserved as null when upstream omits them so downstream agents can detect missing provenance.

API Key

Not required to try it. When BCA_API_KEY is unset, the server falls back to a baked-in public demo key: the 17 tools listed under Install work, and every other tool answers with a clean upgrade message.

For more, get a free key at blockchainacademics.com/crypto-api/signup (2,000 calls/month): it opens the 52 free-tier tools. Paid tiers unlock the rest, such as agent-backed research generation, crypto Twitter intelligence and the proprietary indicators; each tool's description names its tier when it is not free.

Set BCA_API_KEY in your MCP client env. Optionally override BCA_API_BASE (default https://api.blockchainacademics.com). BCA_API_BASE_URL is also accepted for backward compatibility.

Errors

Every failed tool call returns an MCP tool result with isError: true and a JSON body:

{ "error": { "code": "BCA_AUTH", "message": "..." } }

A request that is not a valid MCP call at all (arguments that are not an object, for example) is answered by the MCP SDK with a JSON-RPC error instead.

Development

npm installnpm run build    # tsc -> dist/npm test         # node:test smoke suitenpm run dev      # tsx src/index.ts (stdio)

Pre-commit hooks

This repo uses pre-commit to enforce formatting, lint, secret scanning, and large-file caps before every commit. Install once per clone:

pip install pre-commit          # or: brew install pre-commitpre-commit install              # wires .git/hooks/pre-commitpre-commit run --all-files      # optional: lint the full tree now

Hooks configured in .pre-commit-config.yaml: prettier --check, eslint, gitleaks, detect-private-key, check-added-large-files (500KB cap).

Getting help

• Questions: ask in GitHub Discussions Q&A. Search first, since someone may have asked already.
• Bugs: open an issue.
• Account and billing: email [email protected].
• Security reports: follow SECURITY.md, never a public issue.

Never post a full API key. If we need to know which key, share only the key prefix, the part before the dots on your dashboard (for example bca_1a2b3c4d). Our team will never ask for your key or a seed phrase. Response times by plan are in How to get help.

Security

See SECURITY.md for vulnerability reporting, supported versions, and our 90-day coordinated disclosure policy.

License

MIT © 2026 Blockchain Academics