Tools overview
The BCA Crypto Brain exposes 99 typed tools across 19 categories. Every tool returns the same response envelope — {data, cite_url, as_of, source_hash} — so your agent can always surface a citation.
The tables below are maintained in sync with bca-mcp-ts/src/tools/ via the scripts/generate-tools-index.ts script. Run npm run generate:tools after editing tool files in the MCP repo.
Tier legend: Free · Starter · Pro · Enterprise. Free + Starter callers must surface the cite_url in downstream output — see Attribution.
Content & corpus (1–7)
| # | Tool | Tier | Description |
|---|---|---|---|
| 1 | search_news | Free | Full-text search across 3,501+ editorial crypto articles. |
| 2 | get_article | Free | Fetch a single article by slug with full body, entities, and citations. |
| 3 | list_topics | Free | Enumerate editorial topics (regulation, defi, mev, stablecoins, …). |
| 4 | get_entity | Free | Canonical entity dossier by slug or ticker, with aliases and sentiment. |
| 5 | list_entities | Free | Enumerate entities by type (chain, project, person, org, token). |
| 6 | get_explainer | Free | Canonical academy lesson by slug or topic (evergreen, cited). |
| 7 | search_corpus | Starter | Semantic + keyword hybrid search across news + explainers + reports. |
Market data (8–11)
| # | Tool | Tier | Description |
|---|---|---|---|
| 8 | get_price | Free | Real-time + historical OHLCV for any ticker (CoinGecko-backed). |
| 9 | get_market | Free | Market cap, circulating supply, 24h volume, FDV. |
| 10 | get_ohlcv | Starter | Minute-to-day candles across 15+ exchanges. |
| 11 | compare_assets | Starter | Side-by-side market stats for up to 10 tickers. |
On-chain (12–15)
| # | Tool | Tier | Description |
|---|---|---|---|
| 12 | get_wallet | Starter | Balances + recent tx for an address (ETH, BTC, SOL). |
| 13 | get_transaction | Starter | Tx detail with decoded logs and counterparty entities. |
| 14 | get_contract | Starter | Source, ABI, verification status, common-risk flags. |
| 15 | get_token_holders | Pro | Top holders + concentration metrics. |
Sentiment (16–18)
| # | Tool | Tier | Description |
|---|---|---|---|
| 16 | get_sentiment | Starter | Multi-source sentiment score for an entity or topic. |
| 17 | get_social_volume | Starter | Social mention volume across X, Farcaster, Reddit. |
| 18 | get_narrative | Starter | Current narrative cluster for an entity. |
Proprietary indicators (19–24)
| # | Tool | Tier | Description |
|---|---|---|---|
| 19 | get_coverage_index | Pro | BCA Coverage Index — editorial attention score, 0–100. |
| 20 | get_narrative_pulse | Pro | Narrative Pulse — momentum of associated themes. |
| 21 | get_dev_activity | Pro | Dev Activity composite — commits, contributors, releases. |
| 22 | get_sentiment_momentum | Pro | Sentiment Momentum — 7d / 30d delta and inflection flags. |
| 23 | get_regulatory_risk | Pro | Regulatory Risk score with jurisdiction breakdown. |
| 24 | get_macro_exposure | Pro | Macro Exposure — correlation to rates, DXY, risk-on/off. |
Agent-backed generators (25–28)
Long-running jobs. Return a job_id; poll get_job_status until done.
| # | Tool | Tier | Description |
|---|---|---|---|
| 25 | due_diligence | Pro | Full DD memo from ticker or slug — ~15s, ~2k words, cited. |
| 26 | tokenomics_model | Pro | Vesting + emission schedule + unlock calendar for a token. |
| 27 | summarize_whitepaper | Starter | Paste URL or PDF → structured summary. |
| 28 | translate_contract | Pro | Solidity → natural language with risk annotations. |
Directories (29–40)
| # | Tool | Tier | Description |
|---|---|---|---|
| 29 | list_exchanges | Free | CEX + DEX directory with volume + pair count. |
| 30 | list_wallets | Free | Self-custody + smart wallet directory. |
| 31 | list_bridges | Free | Cross-chain bridge directory. |
| 32 | list_rollups | Free | L2 / rollup directory. |
| 33 | list_dex_aggregators | Free | DEX aggregator directory. |
| 34 | list_lending | Free | Lending + money-market directory. |
| 35 | list_stablecoins | Free | Stablecoin directory with backing + jurisdiction. |
| 36 | list_oracles | Free | Oracle directory. |
| 37 | list_dao_tools | Free | DAO tooling directory. |
| 38 | list_launchpads | Free | Launchpad directory. |
| 39 | list_rwa_platforms | Free | Real-world asset platform directory. |
| 40 | list_analytics | Free | On-chain analytics provider directory. |
Fundamentals + events + dev infra + portfolio (41–70)
| # | Tool | Tier | Description |
|---|---|---|---|
| 41 | get_fundamentals | Starter | TVL, fees, revenue, P/F, P/S for a protocol. |
| 42 | get_tvl_history | Starter | TVL time series, chain-level and protocol-level. |
| 43 | get_fees_history | Starter | Fee revenue time series. |
| 44 | get_emissions | Pro | Current + historical emission rate. |
| 45 | get_supply_schedule | Pro | Forward-looking supply curve. |
| 46 | get_holders_distribution | Pro | Holder concentration Gini + decile breakdown. |
| 47 | list_events | Free | Upcoming crypto events (conferences, hackathons, mainnets). |
| 48 | get_event | Free | Single event detail. |
| 49 | list_unlocks | Starter | Upcoming token unlocks. |
| 50 | get_unlock_calendar | Starter | Per-token unlock schedule. |
| 51 | list_hackathons | Free | Upcoming + active hackathons. |
| 52 | list_grants | Free | Open grant programs. |
| 53 | get_rpc_endpoints | Free | Public RPC endpoints per chain. |
| 54 | get_chain_status | Free | Chain liveness, block time, finality status. |
| 55 | get_faucets | Free | Testnet faucet directory. |
| 56 | get_sdks | Free | SDK directory per chain. |
| 57 | get_block_explorers | Free | Block explorer directory. |
| 58 | get_node_providers | Free | Managed node provider directory. |
| 59 | get_indexers | Free | Indexer / subgraph provider directory. |
| 60 | get_dev_frameworks | Free | Dev framework directory (Foundry, Hardhat, Anchor, …). |
| 61 | get_audit_firms | Free | Audit firm directory. |
| 62 | get_compliance_tools | Free | KYT / compliance tooling directory. |
| 63 | portfolio_value | Starter | USD value of a list of balances. |
| 64 | portfolio_allocation | Starter | Allocation breakdown by asset / chain / sector. |
| 65 | portfolio_performance | Starter | Return, drawdown, Sharpe over a window. |
| 66 | portfolio_risk | Pro | Concentration + correlation + tail-risk metrics. |
| 67 | portfolio_rebalance | Pro | Suggested trades to hit target weights. |
| 68 | portfolio_tax_lots | Pro | Cost basis + unrealized P&L per lot. |
| 69 | portfolio_benchmarks | Starter | Compare vs BTC, ETH, top-10 index. |
| 70 | portfolio_alerts | Pro | Set price / allocation / drawdown alerts. |
Microstructure + regulatory + security + narrative + chains + memes + compute + services (71–106)
| # | Tool | Tier | Description |
|---|---|---|---|
| 71 | get_order_book | Pro | L2 order book snapshot across CEX + DEX. |
| 72 | get_trades | Pro | Recent trades with maker/taker classification. |
| 73 | get_funding_rate | Starter | Perp funding rate by venue. |
| 74 | get_open_interest | Starter | Open interest by venue and asset. |
| 75 | get_liquidations | Pro | Liquidation feed with size and venue. |
| 76 | get_basis | Pro | Spot / perp / futures basis curve. |
| 77 | get_mev | Pro | MEV extraction stats per block or validator. |
| 78 | get_flashbots_bundles | Pro | Recent Flashbots bundles. |
| 79 | get_regulatory_filings | Pro | Recent SEC / CFTC / international filings. |
| 80 | get_enforcement_actions | Pro | Enforcement actions by jurisdiction. |
| 81 | get_regulatory_calendar | Starter | Scheduled regulatory events + comment periods. |
| 82 | get_licenses | Starter | Licensed entity registry (MiCA, BitLicense, MSB…). |
| 83 | get_sanctions | Pro | OFAC + international sanctions lookups for addresses. |
| 84 | get_exploits | Starter | Historical exploit database with loss and root cause. |
| 85 | get_audit_reports | Starter | Audit report index per contract. |
| 86 | get_bug_bounties | Free | Active bug bounty programs. |
| 87 | get_security_score | Pro | Composite security score per protocol. |
| 88 | get_incident_response | Pro | Recent security incidents + response status. |
| 89 | get_trending | Free | Trending entities / tokens / narratives across surfaces. |
| 90 | get_narrative_cluster | Pro | Narrative cluster membership for an entity. |
| 91 | get_meme_index | Starter | Top memecoins by momentum and social volume. |
| 92 | get_memecoin_risk | Starter | Risk score for a memecoin (liquidity, holders, LP lock). |
| 93 | list_chains | Free | Directory of active chains (L1, L2, appchain). |
| 94 | get_chain | Free | Single chain detail. |
| 95 | list_validators | Starter | Validator set + performance per chain. |
| 96 | get_staking_yields | Starter | Staking yields per chain. |
| 97 | list_restaking | Starter | Restaking / AVS directory. |
| 98 | get_compute_providers | Free | Decentralized compute directory (Akash, Render, io.net). |
| 99 | list_services | Free | Catch-all services directory (custody, OTC, prime, …). |
Per-tool input schemas, response shapes, and example calls live on the Tool reference page (auto-generated from the Zod schemas).