{"slug": "mcp-to-talk-to-blockchain-data", "title": "MCP to Talk to Blockchain Data", "summary": "Bitquery has launched an MCP server that lets AI agents in Claude, ChatGPT, Cursor, and VS Code query on-chain blockchain data for crypto investigations and market intelligence. The tool indexes every DEX trade on eight chains down to the second, including tokens not listed on CoinGecko, and offers one-shot workflows for money-flow tracing, risk screening, and address dossiers. Bitquery claims it performs the same job as costly investigation tools for a fraction of the price, enabling plain-English queries that return evidence-backed answers.", "body_md": "On-chain market intelligence and crypto investigations for AI agents — inside Claude, ChatGPT, Cursor and VS Code.\n\nButtons target **this** host automatically — production (mcp.bitquery.io) or staging. Claude Code has no deep-link yet, so its button copies the install command to your clipboard; for ChatGPT and Codex follow the manual steps below.\n\n📖 Full installation guide: [docs.bitquery.io/docs/usecases/MCP](https://docs.bitquery.io/docs/usecases/MCP/)\n\nEvery DEX trade on 8 chains, indexed down to the second — including tokens that never reach CoinGecko.\n\nFrom one address to the whole story — money flows, labels, risk verdicts, flow maps.\n\nMost crypto investigation tools cost thousands of dollars a month. Bitquery MCP does the same job inside Claude or ChatGPT: paste a wallet address, ask your question in plain English, and get the answer back — with the evidence.\n\nIn the video above we point it at a single Tron wallet and let it work: it pulls the full transaction history, labels the counterparties, tells known exchanges apart from unknown wallets, traces where the money actually moved, and writes a clear verdict — what the wallet is doing, how risky it looks, and the leads worth chasing next. The money-flow map at the end is generated in the same run.\n\n`money_flow`\n\nprompt`risk_screen`\n\nprompt`address_report`\n\nprompt`entity_report`\n\nprompt`address_labels`\n\n— entity, category, CEX deposit / hot wallet, mixer, gambling, scam, darknet and token-clone labels`btc_related_addresses`\n\n— common-input-ownership clusteringThese are one-shot workflows (MCP `prompts/`\n\n) that chain several tools and return a chart, table or diagram. Pick them from your client's prompt / command menu:\n\n`money_flow`\n\nTrace funds from an address or transaction across hops, label counterparties, stop at exchanges / mixers → money-flow diagram + edge table.\n\n`risk_screen`\n\nAML / compliance screen of an address or transaction (mixer / sanctioned / scam / darknet) → LOW / MEDIUM / HIGH verdict + evidence + exposure diagram.\n\n`address_report`\n\nFull dossier for one address: activity stats, recent transfers, labels, and (Bitcoin) likely same-owner addresses.\n\n`entity_report`\n\nResolve a labeled entity → its addresses → activity and connections.\n\nThe prompts are built from per-chain tracing tools your agent can also call directly — the same family exists for each traced chain (`eth_`\n\n, `base_`\n\n, `arbitrum_`\n\n, `matic_`\n\n, `optimism_`\n\n, `tron_`\n\n, `solana_`\n\n, `btc_`\n\n):\n\n`*_address_flow_summary`\n\n— one-call triage of any hop: transfer counts, top senders & receivers, and a computed role — `*_flow_edges`\n\n— money-flow graph edges (source → target, amount, token), ready to render as a diagram.`*_trace_next_hop`\n\n— \"where did the bulk of the funds go\": outgoing flow aggregated by counterparty, largest first.`*_trace_dominant_path`\n\n— auto-follows the largest edge hop by hop, up to 5 hops in a single call.`btc_tx_flow`\n\n— full inputs and outputs of a Bitcoin transaction with change outputs flagged, so you follow the real payment.`address_labels`\n\n/ `addresses_by_label`\n\n— the label directory both directions: identify one address, or pull every address tagged Investigate with FIFO, LIFO, or any methodology you prefer — the agent applies it across the raw transfer data. Transfer tracing covers:\n\nIf you work in compliance and AML, investigate fraud, or just follow the money on-chain, this gets you from an address to the whole story in about a minute.\n\nBitquery indexes every DEX trade on Ethereum, Arbitrum, Base, Polygon, Optimism, BNB Chain, Tron and Solana down to the second — so the answers cover freshly-launched memecoins and long-tail tokens that never appear on CoinGecko or CoinMarketCap. You ask in plain English; the agent picks the right tool:\n\n`trending_tokens`\n\n`pair_ohlcv`\n\n`profitable_traders_by_token`\n\nand `trader_positions`\n\n`trader_profile`\n\nand `trader_activity`\n\n`find_tokens`\n\n`accumulating_traders_by_token`\n\n; `profitable_traders_by_token`\n\nranks by realized + unrealized PnL instead`tx_trades`\n\n`eth_token_holders`\n\n(also Polygon, Arbitrum, Base, Optimism)`execute_sql`\n\n(paid plans)`token_chart`\n\nResolve a token and render a candlestick / line price chart with a data table.\n\n`token_dashboard`\n\n360° view of one token: price chart + supply / FDV + top & smart-money traders + scam check.\n\n`trader_dashboard`\n\nOne wallet: profile stats + holdings / PnL positions + activity time-series.\n\n`compare_assets`\n\nOverlay 2–5 assets on one normalized %-change price chart + stats table.\n\n`token_scout`\n\nTrending / gainers + momentum + accumulation → ranked pivot of promising tokens.\n\n`market_movers`\n\nChain leaderboard: top gainers + most-traded → sortable table + bar chart.\n\n`arbitrage_scan`\n\nOne asset across chains → price-spread % table + bar chart.\n\nEvery prompt and example above is built from individual MCP tools your agent can also call directly. The catalog groups into six families:\n\n`Discovery`\n\n`find_tokens`\n\nresolves a name or ticker (with wildcards) to contract + chain; `find_currencies`\n\n, `token_chains`\n\nand `token_dex_venues`\n\nmap an asset across chains and DEXs; `chain_capabilities`\n\nreturns the per-chain tool matrix.\n\n`Prices & charts`\n\n`token_price`\n\n/ `token_ohlcv`\n\n, `pair_ohlcv`\n\n(USD- or quote-denominated), cross-chain `currency_*`\n\naggregates for majors, plus supply, market cap and `pool_recent_trades`\n\n. Candles from 1 second to 1 hour.\n\n`Traders`\n\n`trending_tokens`\n\n(volume / gainers / losers / most-volatile), `top_traders`\n\nby token, pair or network, `profitable_`\n\nand `accumulating_traders`\n\n, and per-wallet `trader_profile`\n\n/ `positions`\n\n/ `activity`\n\n.\n\n`Tracing`\n\nA per-chain family for 8 chains: `*_address_flow_summary`\n\n, `*_flow_edges`\n\n, `*_trace_next_hop`\n\n, `*_trace_dominant_path`\n\n, `*_transfers_in/out`\n\n, `*_tx_transfers`\n\n, `*_token_holders`\n\n, plus contract `*_find_events`\n\n/ `*_find_calls`\n\n.\n\n`Labels`\n\n`address_labels`\n\nfor one address, `labels_for_addresses`\n\nfor a batch, `addresses_by_label`\n\nfor every address tagged X, `find_label_values`\n\nto discover what exists — entities, CEX deposit & hot wallets, mixers, gambling, scams, darknet, token clones.\n\n`Raw SQL`\n\n`execute_sql`\n\nruns read-only ClickHouse over 30 days of per-second DEX trades plus the label directory; `*_transfers_raw_sql`\n\ndoes the same on each chain's transfer data (paid plans).\n\nThe full tool list, parameter shapes, and supported networks are returned by the server itself when your client calls `tools/list`\n\n— so the AI always sees the up-to-date catalog without you reading docs. Per-chain coverage varies slightly (e.g. Solana exposes `solana_find_instructions`\n\n, Bitcoin adds `btc_related_addresses`\n\nclustering); `chain_capabilities`\n\nis the authoritative matrix.\n\nThe underlying dataset is the same Bitquery you already know. The difference is the interface:\n\nInstall Bitquery as a **custom connector** in your AI client. No config file editing required. Watch the walkthrough:\n\n`https://mcp.bitquery.io`\n\nAdd Bitquery to Claude Code with one command (the **Add to Claude Code** button above copies it to your clipboard):\n\n```\nclaude mcp add --transport http bitquery https://mcp.bitquery.io\n```\n\nAppend `--scope user`\n\nto enable it across every project. On first use, run `/mcp`\n\ninside Claude Code (or `claude mcp login bitquery`\n\n) and complete the browser OAuth login with your Bitquery account.\n\n`https://mcp.bitquery.io`\n\n`https://mcp.bitquery.io`\n\nAdd Bitquery to your Codex MCP servers with the CLI:\n\n```\ncodex mcp add bitquery --url https://mcp.bitquery.io\n```\n\nOr edit `~/.codex/config.toml`\n\ndirectly:\n\n```\n[mcp_servers.bitquery]\nurl = \"https://mcp.bitquery.io\"\n```\n\nOn first call, Codex opens a browser for OAuth login with your Bitquery account.\n\nAdd a new MCP server with URL: `https://mcp.bitquery.io`\n\nIt is a hosted Model Context Protocol (MCP) server at `https://mcp.bitquery.io`\n\nthat exposes Bitquery's on-chain blockchain data as MCP tools. AI agents like Claude, ChatGPT, Cursor, and VS Code can call these tools directly during a conversation, without you having to write GraphQL queries by hand.\n\nYes. The server ships guided investigation prompts: `money_flow`\n\ntraces funds across hops and stops at exchanges or mixers, `risk_screen`\n\nreturns a LOW / MEDIUM / HIGH AML verdict with evidence, `address_report`\n\nbuilds a full dossier for one address, and `entity_report`\n\nresolves a labeled entity to its addresses and activity. Transfer tracing covers Ethereum, Polygon, Arbitrum, Base, Optimism, Tron, Bitcoin and Solana, backed by millions of address labels.\n\nAny client that supports remote MCP servers over Streamable HTTP. This includes Claude Desktop and Claude.ai (web, with Plus/Pro/Max), ChatGPT (Plus/Pro/Business with custom connectors enabled), Cursor, VS Code with MCP enabled, and custom agents built with the Anthropic or OpenAI SDKs.\n\nDEX trading tools cover Ethereum, Arbitrum, Base, Polygon, Optimism, BNB Chain, Tron and Solana, with candles down to 1-second granularity; transfer-tracing tools cover Ethereum, Polygon, Arbitrum, Base, Optimism, Tron, Bitcoin and Solana. Tools span token prices, OHLCV candles, trending tokens, top / profitable / accumulating traders, trader profiles and positions, DEX pairs, transfers, the address-label directory, and raw SQL access where the user has a paid plan.\n\nAuthentication uses **OAuth 2.1**: the AI client opens a browser to your Bitquery account, you approve access, and tokens refresh automatically for ~30 days. Access is tied to your Bitquery account, so revoking it there immediately disables the connection.\n\nThe MCP server is built for AI agents. Instead of writing a GraphQL query, the agent picks an MCP tool (for example `token_ohlcv`\n\nor `top_traders_by_token`\n\n) and the server runs the underlying query on Bitquery for you. The data source is the same; the interface is conversational. Quotas, plans, and billing are shared with your regular Bitquery account.\n\nThere is a free tier inherited from your Bitquery account. Heavier workloads — high request rates, large historical scans, or `execute_sql`\n\n— require a paid Bitquery plan. The MCP server itself does not add a separate charge.", "url": "https://wpnews.pro/news/mcp-to-talk-to-blockchain-data", "canonical_source": "https://mcp.bitquery.io/", "published_at": "2026-08-26 09:17:01+00:00", "updated_at": "2026-08-26 09:45:04.271929+00:00", "lang": "en", "topics": ["ai-tools", "artificial-intelligence"], "entities": ["Bitquery", "Claude", "ChatGPT", "Cursor", "VS Code", "CoinGecko", "CoinMarketCap", "Tron"], "alternates": {"html": "https://wpnews.pro/news/mcp-to-talk-to-blockchain-data", "markdown": "https://wpnews.pro/news/mcp-to-talk-to-blockchain-data.md", "text": "https://wpnews.pro/news/mcp-to-talk-to-blockchain-data.txt", "jsonld": "https://wpnews.pro/news/mcp-to-talk-to-blockchain-data.jsonld"}}