blockchainacademics

@blockchainacademics/mcp

AI エージェント向けの標準的な暗号資産 MCP サーバーです。3,501 件以上の編集記事、200 件以上のエンティティ資料、43 件のアカデミーレッスン、集約された市場データとオンチェーンデータ、独自指標、非同期のエージェント連携型生成を網羅する105 個のツールを、AI エージェントがネイティブに呼び出せる MCP ツールとして利用できます。

ツールのカテゴリ（v0.4.0）

カテゴリ	数	例
コンテンツとコーパス	7	search_news、get_article、get_entity、get_explainer、list_entity_mentions、get_as_of_snapshot
市場データ	4	get_price、get_ohlc、get_market_overview、get_pair_data
オンチェーン	4	get_wallet_profile、get_tx、get_token_holders、get_defi_protocol
センチメント	3	get_sentiment、get_social_pulse、get_fear_greed
独自指標	6	get_coverage_index、get_narrative_strength、get_sentiment_velocity、get_editorial_premium、get_kol_influence、get_risk_score
エージェント連携型（非同期、Pro 以上）	6	generate_due_diligence、generate_tokenomics_model、summarize_whitepaper、translate_contract、monitor_keyword、get_agent_job
ディレクトリ	13	list_stablecoins、list_yields、list_aggregators、list_mcps、list_vcs、list_jobs、build_custom_indicator、…
ファンダメンタルズ	6	get_tokenomics、get_audit_reports、get_team_info、compare_protocols、check_rugpull_risk
チェーン固有	4	get_solana_ecosystem、get_l2_comparison、get_bitcoin_l2_status、get_ton_ecosystem
マーケットのマイクロストラクチャー	5	get_funding_rates、get_options_flow、get_liquidation_heatmap、get_exchange_flows、predict_listing
ナラティブ／メタ	5	track_narrative、get_ai_agent_tokens、get_depin_projects、get_rwa_tokens、get_prediction_markets
規制	4	get_regulatory_status、track_sec_filings、get_mica_status、get_tax_rules
セキュリティ	4	check_exploit_history、check_phishing_domain、get_bug_bounty_programs、scan_contract
ミーム／デゲン	4	track_pumpfun、track_bonkfun、check_memecoin_risk、get_degen_leaderboard
サービス（収益）	3	book_kol_campaign、request_custom_research、submit_listing
履歴時系列データ	4	get_history_prices、get_history_sentiment、get_history_correlation、get_history_coverage
コンピュート／AI 暗号資産	2	get_compute_pricing、get_ai_crypto_metrics
コーパスメタデータ	7	list_entities、get_topic、search_academy、get_trending、get_unified_feed、list_sources、get_recent_stories
メモ＋テーゼ＋ソーシャル	6	list_memos、get_memo、list_theses、get_thesis、get_social_signals、get_social_signals_detail
通貨	2	list_currencies、get_currency_feed

すべてのツールの応答には、cite_url（UTM のソース属性を含む）、as_of（任意の時点のスナップショット）、source_hash（コンテンツの完全性）が含まれます。

未リリースのインテグレーション（Twitter のソーシャルパルス、DEXTools、bonk.fun、Bittensor）向けのツールは、失敗する代わりに {status: "integration_pending", reason, eta} を返します。MCP サーバーは現在すべて利用できます。

利用する理由

LLM は暗号資産について幻覚を起こします。BCA は、完全な出典情報付きの、信頼できる編集コンテンツを提供します。この MCP サーバーを Claude Desktop、LangChain、Eliza、または MCP 対応エージェントに接続すれば、モデルはほかのツールと同様に BCA コーパスを検索できます。すべての応答に引用、タイムスタンプ、ソースハッシュが付与されます。

インストール

Claude Desktop（設定不要のデモ）

パッケージには公開デモキーが組み込まれています。試すための登録は不要です。claude_desktop_config.json に追加してください（macOS の場合：~/Library/Application Support/Claude/claude_desktop_config.json）。

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

Claude Desktop を再起動してください。デモでは、実データと実際の引用情報を含む主要な 10 個のツール（get_price、get_trending、get_fear_greed、get_market_overview、search_news、get_sentiment、get_entity、get_explainer、get_recent_stories、get_topic）を利用できます。共有レート上限は、全体で 1 日あたり 100 回、IP ごとに 1 日あたり 20 回です。

Claude Desktop（全 105 ツール）

brain.blockchainacademics.com/signup で無料のキーを取得し（ユーザーごとに月 2,000 回の呼び出し）、env ブロックを追加します。

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

Claude Desktop を再起動します。すべての 105 ツールがツールピッカーに表示されます。

プログラムからの利用（LangChain、Eliza、カスタムエージェント）

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);

ツールを連鎖させるループの完全な例については、examples/research-agent.ts をご覧ください。

ツール

search_news

3,501 件以上の暗号資産関連の編集記事を全文検索します。

引数	型	必須	説明
query	string (1-512)	はい	検索クエリ
entity	string	いいえ	エンティティのスラッグによるフィルター（例：ethereum）
since	ISO 8601	いいえ	最も古い公開日
topic	string	いいえ	トピックによるフィルター（例：regulation）
limit	number (1-50)	いいえ	デフォルトは 10

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

get_entity

正規エンティティの詳細情報を取得します。次のいずれか 1 つだけを指定してください。

引数	型	説明
slug	string	例："vitalik-buterin"、"circle"
ticker	string	例："ETH"、"SOL"（大文字と小文字は区別されません）

エイリアスは自動的に解決されます（CZ → changpeng-zhao、Maker → makerdao、BSC → bnb-chain、…）。

get_explainer

正規のアカデミーレッスンを取得します。次のいずれか 1 つだけを指定してください。

引数	型	説明
slug	string	レッスンのスラッグ。例："what-is-a-blockchain"
topic	string	正規のレッスンに解決されるトピックキーワード

帰属表示

すべてのレスポンスには、構造化された attribution ブロックが含まれます。

{
  "data": { ... },
  "attribution": {
    "cite_url": "https://blockchainacademics.com/...",
    "as_of": "2026-04-19T12:34:56Z",
    "source_hash": "sha256:..."
  }
}

エージェントが BCA のコンテンツをユーザーに提示する際は、cite_url を使って出典を明記してください。上流でフィールドが省略されている場合、そのフィールドは null のまま保持されるため、下流のエージェントは出典情報の欠落を検出できます。

API キー

試用に API キーは不要です。 BCA_API_KEY が設定されていない場合、サーバーは組み込みの公開デモキーにフォールバックし、主要な 10 個のツールを利用できます。上記のデモプランをご覧ください。

全 105 ツールを利用するには、brain.blockchainacademics.com/signup で無料のキーを取得してください（月 2,000 回の呼び出し）。有料プランでは、エージェントを活用したリサーチの生成と独自のオンチェーン指標を利用できます。

MCP クライアントの env に BCA_API_KEY を設定します。必要に応じて BCA_API_BASE（デフォルトは https://api.blockchainacademics.com）を上書きできます。後方互換性のため、BCA_API_BASE_URL も使用できます。

エラー

サーバーが stdio プロセスをクラッシュさせることはありません。すべての失敗は、isError: true と JSON 本文を含む MCP レスポンスとして返されます。

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

コード	意味
BCA_AUTH	BCA_API_KEY が無効です（HTTP 401/403）
BCA_TIER_LOCKED	ツールが現在のプランの許可リストに含まれていません（HTTP 403）。デモプランでは 105 個中 91 個のツールでこのエラーが発生します。エラーメッセージにはアップグレード用 URL が含まれます。
BCA_RATE_LIMIT	レート制限を超過しました（HTTP 429 — Retry-After に従ってください）
BCA_UPSTREAM	BCA API が 5xx または不正な JSON を返しました
BCA_NETWORK	ネットワークエラー、または 20 秒のタイムアウトを超過しました
BCA_BAD_REQUEST	ツールの引数が無効です

開発

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

コミット前フック

このリポジトリでは pre-commit を使用して、コミットのたびにフォーマット、Lint、シークレットのスキャン、大容量ファイルの制限を適用します。クローンごとに一度インストールしてください。

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

.pre-commit-config.yaml で設定されているフック：prettier --check、eslint、gitleaks、detect-private-key、check-added-large-files（上限 500KB）。

セキュリティ

脆弱性の報告、サポート対象バージョン、90 日間の協調的な情報開示ポリシーについては、SECURITY.md をご覧ください。

ライセンス

MIT © 2026 Blockchain Academics