Blockscout MCP Server

Wraps Blockscout APIs to expose multi-chain blockchain data (balances, tokens, NFTs, contracts, transactions) to AI agents via MCP.

Data & Enrichment by Blockscout None active

Connect (Remote Server) GitHub Docs

Overview

The Blockscout MCP Server wraps the Blockscout block explorer APIs and exposes them through the Model Context Protocol so AI agents can read blockchain data contextually. It supports multiple EVM-compatible chains via dynamic Blockscout instance resolution, letting an agent query addresses, tokens, NFTs, transactions, blocks, and smart contract metadata from a single endpoint.

The server is designed for LLM consumption. It uses opaque Base64URL cursor pagination, automatic truncation of oversized fields with explicit access guidance, and structured JSON responses that include follow-up instructions for the agent. It also exposes a low-level direct_api_call tool for endpoints not covered by the higher-level helpers, and a read_contract tool for executing read-only contract functions.

Blockscout hosts a public remote server at https://mcp.blockscout.com/mcp, and the project is also distributed as an open-source Python package and Docker image (ghcr.io/blockscout/mcp-server:latest) for self-hosting. Installation is available through the Anthropic Connectors Directory, Claude Code, Cursor, Gemini CLI, ChatGPT Apps, and any other MCP-compatible client.

Tools

Tool	Description
`__unlock_blockchain_analysis__`	Initialization tool that primes the agent with usage guidance and unlocks the remaining blockchain analysis tools.
`get_chains_list`	Returns the list of chains supported by the Blockscout multi-chain index.
`get_address_by_ens_name`	Resolves an ENS name to an Ethereum address.
`lookup_token_by_symbol`	Finds tokens by symbol on a given chain.
`get_contract_abi`	Retrieves the ABI of a verified smart contract.
`inspect_contract_code`	Returns verified source code (optionally a specific file) for a contract.
`get_address_info`	Returns comprehensive information about an address including balance, type, and metadata.
`get_tokens_by_address`	Lists ERC-20 token holdings for an address.
`get_block_number`	Returns the latest block number or the block at a given datetime.
`get_transactions_by_address`	Lists transactions for an address with time-range and method filtering.
`get_token_transfers_by_address`	Lists ERC-20 transfers involving an address with time and token filtering.
`nft_tokens_by_address`	Lists NFTs held by an address.
`get_block_info`	Returns information about a block, optionally including its transactions.
`get_transaction_info`	Returns detailed information about a transaction, optionally including raw input.
`read_contract`	Executes a read-only smart contract function.
`direct_api_call`	Performs a direct call against an arbitrary Blockscout API endpoint for cases not covered by the higher-level tools.

Setup Guide

Option 1: Use the hosted remote server (recommended)

Blockscout operates a public MCP server at https://mcp.blockscout.com/mcp. No API key is required.

Claude Desktop / claude.com: Install via the Anthropic Connectors Directory at claude.com/connectors/blockscout (requires a paid Claude plan).

Claude Code:

claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp

Gemini CLI (~/.gemini/settings.json):

{
  "mcpServers": {
    "blockscout": {
      "httpUrl": "https://mcp.blockscout.com/mcp",
      "timeout": 180000
    }
  }
}

ChatGPT Apps: Search for "Blockscout" in the ChatGPT Apps marketplace.

Option 2: Self-host via Docker

{
  "mcpServers": {
    "blockscout": {
      "command": "docker",
      "args": ["run", "--rm", "-i", "ghcr.io/blockscout/mcp-server:latest"]
    }
  }
}

Option 3: Run locally from source

git clone https://github.com/blockscout/mcp-server.git
cd mcp-server
pip install -e .

The server supports stdio mode by default and an HTTP mode (--http --rest). Configuration env vars include BLOCKSCOUT_MCP_USER_AGENT and BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true to opt out of anonymous usage telemetry on community instances.

Use Cases

On-chain investigations: Pull a wallet's full transaction and token transfer history across chains to trace activity or flag suspicious flows.
Smart contract auditing assistance: Fetch a contract's verified source code and ABI, then ask the agent to summarize functions, find risky patterns, or compare versions.
Portfolio and NFT analysis: Query ERC-20 balances and NFT holdings for an address with pagination to build a portfolio snapshot.
Token research: Resolve a token symbol to its on-chain address on a specific chain, then read live contract state (supply, owner, paused, etc.) via read_contract.
Block and transaction forensics: Retrieve a block's transactions or a single transaction's decoded details (including raw input) to debug failed calls or trace MEV.

Example Prompts

"What ERC-20 tokens and NFTs does vitalik.eth hold on Ethereum mainnet?"
"Show me all USDC transfers in and out of 0x... between January 1 and March 31, 2026."
"Fetch the verified source code for the contract at 0x... on Base and summarize what each external function does."
"Resolve the symbol ARB on Arbitrum, then call totalSupply() on the resulting token contract."
"Get the transaction info for hash 0xabc... and explain why it reverted."

Pros

Official, maintained by the Blockscout team and offered as a free hosted endpoint with no API key required.
Broad multi-chain coverage via dynamic Blockscout instance resolution, plus a direct_api_call escape hatch for endpoints not covered by higher-level tools.
LLM-aware design: opaque cursor pagination, automatic truncation, and structured JSON responses that conserve context tokens.
Multiple distribution channels: hosted URL, Anthropic Connectors Directory, ChatGPT Apps, Docker image, and pip-installable Python package.

Limitations

Read-only: the server cannot sign or broadcast transactions, only inspect chain data and call view functions.
Hosted community instance collects anonymous tool usage telemetry by default; you must self-host or set BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true to opt out.
Coverage of any given chain depends on Blockscout having an indexer for it, so some non-EVM or niche chains are not available.

Alternatives

Etherscan MCP servers (community-maintained wrappers around the Etherscan API for Ethereum and related chains).
Dune MCP for SQL-driven on-chain analytics across many chains.
Alchemy MCP for node-level RPC access and richer indexed data with an API key.