Blockscout MCP Server

Overview

Blockscout's official MCP server exposes its block-explorer APIs — balances, token holdings, NFTs, and contract metadata — to AI agents and IDEs, with multi-chain support via the Blockscout PRO API, cursor-based pagination, and progress notifications for long queries. It runs over stdio by default, or HTTP/Docker for a REST-style deployment, and plugs into Claude, ChatGPT Apps, Cursor, and Codex. A free-tier PRO API key is required.

Tool inventory — 16 tools, probed live 2026-10-15

• __unlock_blockchain_analysis__ — Initializes a Blockscout MCP session: returns server reference data, the `blockscout-analysis` skill pointer, and the URI resolution rule. Call this tool exactly once per session, before any o
• get_block_info — Get block information like timestamp, gas used, burnt fees, transaction count etc. Can optionally include the list of transaction hashes contained in the block. Transaction hashes are omitted
• get_block_number — Retrieves the block number and timestamp for a specific date/time or the latest block. Use when you need a block height for a specific point in time (e.g., "block at 2024-01-01") or the c
• get_address_by_ens_name — Useful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.
• get_transactions_by_address — Retrieves native currency transfers and smart contract interactions (calls, internal txs) for an address. **EXCLUDES TOKEN TRANSFERS**: Filters out direct token balance changes (ERC-20, etc.)
• get_token_transfers_by_address — Get ERC-20 token transfers for an address within a specific time range. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
• lookup_token_by_symbol — Search for token addresses by symbol or name. Returns multiple potential matches based on symbol or token name similarity. Only the first 7 matches from the Blockscout API are returned.
• get_contract_abi — Get smart contract ABI (Application Binary Interface). An ABI defines all functions, events, their parameters, and return types. The ABI is required to format function calls or interpret cont
• inspect_contract_code — Inspects a verified contract's source code or metadata.
• read_contract — Calls a smart contract function (view/pure, or non-view/pure simulated via eth_call) and returns the decoded result. This tool provides a direct way to query the state of a s
• get_address_info — Get comprehensive information about an address, including: - Address existence check - Native token (ETH) balance (provided as is, without adjusting by decimals) - First transaction d
• get_tokens_by_address — Get comprehensive ERC20 token holdings for an address with enriched metadata and market data. Returns detailed token information including contract details (name, symbol, decimals), market me
• nft_tokens_by_address — Retrieve NFT tokens (ERC-721, ERC-404, ERC-1155) owned by an address, grouped by collection. Provides collection details (type, address, name, symbol, total supply, holder count) and individu
• get_transaction_info — Get comprehensive transaction information. Unlike standard eth_getTransactionByHash, this tool returns enriched data including decoded input parameters, detailed token transfers with token me
• get_chains_list — Get supported blockchain chains with their chain IDs. Ethereum Mainnet is `chain_id` `1`; use this tool to resolve any other chain. Use this when another tool needs a supported `chain_id` and
• direct_api_call — Call a raw Blockscout API endpoint for advanced or chain-specific data. Before the first call to this tool in a session, read `blockscout-mcp://skill/SKILL.md` (the operating rules), then

Answers a handshake

yes · 2026-10-15

Answers a call

the server answered get_chains_list with an error (Error executing tool get_chains_list: A valid `session_id` is required. If you have not yet called `__unlock_blockchain_analysis__` (MCP) / `GET /v1/unlock_bloc)

Live probe verifies the interface responds — not what the tools do, their safety, or their output quality. The call is one read-only tool named by this server's own list (list_/get_/search_, no mutating verb anywhere in the name, no required arguments and none that look like a key, an address or an amount), asked once a day with no arguments. Not asked is not a failure.

Where Blockscout MCP Server fits

Related concepts: What Are MCPs? The Standard Way to Give Agents Tools, What Are Onchain Agents?