Blockscout
MCP server giving AI agents and IDEs read access to Blockscout blockchain explorer data
Answered our latest tool-list check yesterday with 16 tools. It will be marked verified after 3 successful checks in 7 days.
Blockscout is a freemium MCP server for cloud and infrastructure. It runs as a hosted remote server, so there is nothing to install locally.
- Pricing
- Freemium
- Platforms
- API, CLI, Self-hosted
- Runs
- Remotely
- Version
- 0.19.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add --transport http mcp-server https://mcp.blockscout.com/mcpAdd to Settings → Connectors → Add custom connector
https://mcp.blockscout.com/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.blockscout.com/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.blockscout.com/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"mcp-server": {
"serverUrl": "https://mcp.blockscout.com/mcp"
}
}
}Add to Grok Bot desktop app → Connect apps → Add a custom connector
https://mcp.blockscout.com/mcpEnter a Name (for example "Blockscout"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.
Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"mcp-server": {
"type": "http",
"url": "https://mcp.blockscout.com/mcp"
}
}
}Using several servers? Build one config file with the MCP config generator.
About Blockscout
The README describes this as a Model Context Protocol server that wraps Blockscout APIs, so AI clients such as Claude, Cursor or other MCP hosts can query onchain data like balances, token holdings, NFTs and contract metadata through a set of named tools. Requests are routed through the Blockscout PRO API, so a PRO API key from the Blockscout Developer Portal is required for most data tools.
The server supports multiple chains and uses chain metadata to resolve which network a query targets. Responses are trimmed and paginated with opaque cursors to keep large results from overflowing an LLM's context window. The project also offers a REST API alongside the MCP endpoint and can be run over stdio, HTTP streamable transport or Docker.
It is aimed at developers and analysts who want an assistant to investigate transactions, addresses, tokens or contracts on EVM chains without writing their own explorer integration.
Tools this server provides (16)
Read directly from the server.
All 16 tools say they're read-only.
From the server's own tool annotations; not verified by us.
- __unlock_blockchain_analysis__Says read-only
- 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 other tool, and reuse its payload for the rest of the session; do not call it again.
- get_block_infoSays read-only
- 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 by default; request them only when you truly need them, because on high-traffic chains the list may exhaust the context.
- get_block_numberSays read-only
- 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 current chain tip. If `datetime` is provided, finds the block immediately preceding that time. If omitted, returns the latest indexed block.
- get_address_by_ens_nameSays read-only
- Useful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.
- get_transactions_by_addressSays read-only
- 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.). You'll see calls *to* token contracts, but not the `Transfer` events. For token history, use `get_token_transfers_by_address`. A single tx can have multiple records from internal calls. Requires an `age_from
- get_token_transfers_by_addressSays read-only
- 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_symbolSays read-only
- 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_abiSays read-only
- 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 contract data.
- inspect_contract_codeSays read-only
- Inspects a verified contract's source code or metadata.
- read_contractSays read-only
- 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 smart contract. Example: To check the USDT balance of an address on Ethereum Mainnet, you would use the following arguments: { "tool_name": "read_contract", "params": { "chain_id": "1", "address": "0xdAC17F958D2ee523a2206206994
- get_address_infoSays read-only
- Get comprehensive information about an address, including: - Address existence check - Native token (ETH) balance (provided as is, without adjusting by decimals) - First transaction details (block number and timestamp) for age calculation - ENS name association (if any) - Contract status (whether the address is a contract, whether it is verified) - Proxy contract information (if applicable): deter
- get_tokens_by_addressSays read-only
- 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 metrics (exchange rate, market cap, volume), holders count, and actual balance (provided as is, without adjusting by decimals). Essential for portfolio analysis, wallet auditing, and DeFi position tracking. **SU
- nft_tokens_by_addressSays read-only
- 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 individual token instance data (ID, name, description, external URL, metadata attributes). Essential for a detailed overview of an address's digital collectibles and their associated collection data. **SUPPORTS PAGINA
- get_transaction_infoSays read-only
- Get comprehensive transaction information. Unlike standard eth_getTransactionByHash, this tool returns enriched data including decoded input parameters, detailed token transfers with token metadata, transaction fee breakdown (priority fees, burnt fees) and categorized transaction types. By default, the raw transaction input is omitted if a decoded version is available to save context; request it w
- get_chains_listSays read-only
- 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 only the chain name, ecosystem, or native currency is known. Prefer a narrow `query` to avoid returning the full registry to the agent. Do not rely on partial numeric chain ID queries such as `1`, because mat
- direct_api_callSays read-only
- 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 `blockscout-mcp://skill/references/blockscout-api-index.md` (the authoritative index of callable endpoints); skip both reads only if this skill content is already in context. Recalled Blockscout API knowledge is
What it does
- Multichain data access
- Queries span many EVM networks, with a chain list tool for finding supported chain identifiers.
- Address and token inspection
- Tools return balances, ERC-20 holdings, NFT ownership and public address tags.
- Contract reading
- Fetch ABIs, verified source files and run read-only contract functions.
- Transaction and block lookup
- Retrieve decoded transaction inputs, token transfers and block details by number or timestamp.
- Context-friendly responses
- Large fields are truncated and results are paginated to conserve LLM tokens.
- Flexible deployment
- Runs over stdio, HTTP streamable transport, optional REST API or Docker.
Good for
- Asking an AI assistant which approvals an address has granted on a given chain
- Calculating gas fees paid by a wallet over a chosen month
- Checking whether a token contract includes blacklisting functions
- Finding the block that was current at a specific date and time
- Reviewing the source code of a verified smart contract from an IDE
Pricing
Freemium
Free developer-portal tier for a PRO API key; higher usage is metered in credits.
Prices change. Check blockscout.com before you buy.
Blockscout FAQ
Do I need an API key to use Blockscout?
Yes. The README says most data tools route through the Blockscout PRO API, and a key from the Blockscout Developer Portal is required, with a free tier that needs no credit card.
How do I connect Blockscout to Claude or Cursor?
The README gives setup steps for Claude custom connectors, Claude Code, Codex, Cursor and ChatGPT Apps, using the hosted endpoint at https://mcp.blockscout.com/mcp.
Can I run Blockscout myself?
Yes. The README documents local installation, running in stdio or HTTP mode, and a Docker image at ghcr.io/blockscout/mcp-server.
Does Blockscout collect telemetry?
Community instances collect anonymous usage data by default, according to the README, and it can be turned off with BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true.
Is Blockscout free?
Blockscout has a free plan, with paid plans for more usage or features.
How do I add Blockscout to Claude Code?
Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.blockscout.com/mcp
What are the best alternatives to Blockscout?
The closest alternatives to Blockscout are Universal Blockchain MCP, Komodo MCP Server, awslabs and Azure MCP Server.
Where this comes from
- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.
