com.blockscout MCP Server
● Activecom.blockscout/mcp-server
MCP server for Blockscout
Connect this server
One click to install, or copy the config below. Suits: Cursor · HTTP clients.
Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):
{
"mcpServers": {
"mcp-server": {
"url": "https://mcp.blockscout.com/mcp"
}
}
}claude mcp add --transport http mcp-server https://mcp.blockscout.com/mcpcode --add-mcp '{"name":"mcp-server","type":"http","url":"https://mcp.blockscout.com/mcp"}'Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.
A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.
- Category
- Crypto & Web3
- Version
- 0.19.0
- Registry
- active
- Published
- 9/8/2026
Live check
checked Nov 19, 2026, 14:07 UTCThe endpoint answered the MCP handshake as "blockscout-mcp-server" and listed 16 tools. Answering since Nov 18, 2026.
Context cost ≈ 19k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 16 tools.
Tools (16)
tool list changed Nov 19, 2026, 14:07 UTC__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 other tool, and reuse its payload for the rest of the session; do not call it again.
get_block_info4 paramsGet 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.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainnumber_or_hashstringrequiredBlock number or hashinclude_transactionsIf true, includes a list of transaction hashes from the block.session_idOpaque session identifier.
get_block_number3 paramsRetrieves 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.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchaindatetimeThe date and time (ISO 8601 format, e.g. 2025-05-22T23:00:00.00Z) to find the block for. If omitted, returns the latest block.session_idOpaque session identifier.
get_address_by_ens_name2 paramsUseful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.
Show parametersHide parameters
namestringrequiredENS domain name to resolvesession_idOpaque session identifier.
get_transactions_by_address7 paramsRetrieves 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` date to scope results for performance and relevance. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredAddress which either sender or receiver of the transactionage_fromstringrequiredStart date and time (e.g 2025-05-22T23:00:00.00Z). Alone, returns all transactions to/from the address since this date.age_toEnd date and time (e.g 2025-05-22T22:30:00.00Z). Adding this bounds the upper end of the date range started by `age_from`.methodsA method signature to filter transactions by (e.g 0x304e6ade). Filters the (optionally date-bounded) results to a specific method signature.cursorThe pagination cursor from a previous response to get the next page of results.session_idOpaque session identifier.
get_token_transfers_by_address7 paramsGet 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.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredAddress which either transfer initiator or transfer receiverage_fromstringrequiredStart date and time (e.g 2025-05-22T23:00:00.00Z). Alone, returns all ERC-20 transfers to/from the address since this date.age_toEnd date and time (e.g 2025-05-22T22:30:00.00Z). Adding this bounds the upper end of the date range started by `age_from`; if omitted, transfers up to the curretokenAn ERC-20 token contract address to restrict results to a single token. If omitted, returns transfers of all tokens.cursorThe pagination cursor from a previous response to get the next page of results.session_idOpaque session identifier.
lookup_token_by_symbol3 paramsSearch 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.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainsymbolstringrequiredToken symbol or name to search forsession_idOpaque session identifier.
get_contract_abi3 paramsGet 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.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredSmart contract addresssession_idOpaque session identifier.
inspect_contract_code4 paramsInspects a verified contract's source code or metadata.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchain.addressstringrequiredThe address of the smart contract.file_nameThe name of the source file to inspect. If omitted, returns contract metadata and the list of source files.session_idOpaque session identifier.
read_contract7 paramsCalls 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": "0xdAC17F958D2ee523a2206206994597C13D831ec7", "abi": { "constant": true, "inputs": [{"name": "_owner", "type": "address"}], "name": "balanceOf", "outputs": [{"name": "balance", "type": "uint256"}], "payable": false, "stateMutability": "view", "type": "function" }, "function_name": "balanceOf", "args": "["0xF977814e90dA44bFA03b6295A0616a897441aceC"]" } }
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredSmart contract addressabiobjectrequiredThe JSON ABI for the specific function being called. This should be a dictionary that defines the function's name, inputs, and outputs. The function ABI can befunction_namestringrequiredThe symbolic name of the function to be called. This must match the `name` field in the provided ABI.argsstringA JSON string containing an array of arguments. Example: "["0xabc..."]" for a single address argument, or "[]" for no arguments. Order and types must match ABIblockThe block identifier to read the contract state from. Can be a block number (e.g., 19000000) or a string tag (e.g., 'latest'). Defaults to 'latest'.session_idOpaque session identifier.
get_address_info3 paramsGet 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): determines if a smart contract is a proxy contract (which forwards calls to implementation contracts), including proxy type and implementation addresses - Token details (if the contract is a token): name, symbol, decimals, total supply, etc. Essential for address analysis, contract investigation, token research, and DeFi protocol analysis.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredAddress to get information aboutsession_idOpaque session identifier.
get_tokens_by_address4 paramsGet 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. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredWallet addresscursorThe pagination cursor from a previous response to get the next page of results.session_idOpaque session identifier.
nft_tokens_by_address4 paramsRetrieve 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 PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainaddressstringrequiredNFT owner addresscursorThe pagination cursor from a previous response to get the next page of results.session_idOpaque session identifier.
get_transaction_info4 paramsGet 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 with `include_raw_input=True` only when you truly need the raw hex data. Essential for transaction analysis, debugging smart contract interactions, tracking DeFi operations.
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchaintransaction_hashstringrequiredTransaction hashinclude_raw_inputIf true, includes the raw transaction input data.session_idOpaque session identifier.
get_chains_list2 paramsGet 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 matching is substring-based and may return many chains.
Show parametersHide parameters
queryOptional case-insensitive substring filter applied to chain name, chain ID, native currency, and ecosystem. Prefer narrow text terms over partial numeric chainsession_idOpaque session identifier.
direct_api_call7 paramsCall 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 not a substitute: endpoint paths, parameters, and response shapes vary across Blockscout versions and per-chain deployments. Supports POST requests with a JSON body for endpoints like JSON RPC. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages (GET only).
Show parametersHide parameters
chain_idstringrequiredThe ID of the blockchainendpoint_pathstringrequiredThe Blockscout API path to call (e.g., '/api/v2/stats'); do not include query strings — pass all query parameters via query_params to avoid double-encoding.query_paramsOptional query parameters forwarded to the Blockscout API.cursorThe pagination cursor from a previous response to get the next page of results.methodstringHTTP method used for the upstream call. Use POST with json_body.json_bodyJSON request body for POST requests.session_idOpaque session identifier.
Checked by Serverdex with a plain initialize + tools/list call to mcp.blockscout.com/mcp, no credentials, about once a day. A failed check is never a removal.
On GitHub
read Nov 17, 2026- Stars
- 46
- Forks
- 30
- Last push
- Sep 8, 2026
- License
- Other
Python
From the README
Blockscout MCP Server The Model Context Protocol (MCP) is an open protocol designed to allow AI agents, IDEs, and automation tools to consume, query, and analyze structured data through context-aware APIs. This server wraps Blockscout APIs and exposes blockchain data—balances, tokens, NFTs, contract metadata—via MCP so that AI agents and tools (like Claude, Cursor, or IDEs) can access and analyze it contextually. Key Features: • Contextual blockchain data access for AI tools • Multi-chain support via Blockscout PRO API configuration with Chainscout metadata enrichment • Versioned REST API: Provides a standard, web-friendly interface to all MCP tools. See API.md for full documentation. • Custom instructions for MCP host to use the server • Intelligent context optimization to conserve LLM tokens while preserving data accessibility • Smart response slicing with configurable page sizes to prevent context overflow • Opaque cursor pagination using Base64URL-encoded strings instead of complex parameters • Automatic truncation of large data fields with clear indicators and access guidance • Standardized ToolResponse model with structured JSON responses and follow-up instructions • Enhanced observability with MCP progress notifications and periodic updates for long-running operations Enhanced Analysis with Agent Skills For more powerful and efficient blockchain analysis, install the Blockscout Analysis skill from the agent-skills repository.…
Read the full README on GitHub →Remotes
- streamable-http
https://mcp.blockscout.com/mcp
Alternatives to com.blockscout MCP Server
Best Crypto & Web3 servers →The most-starred Crypto & Web3 servers in the index, with their live-check result.
| Server | Stars | Last push | Live check |
|---|---|---|---|
| Oh My Posh Validator | 23,757 | Nov 2026 | Working |
| Solana MCP by Vybe | 2,728 | Oct 2026 | Working |
| Solana MCP by Vybe | 2,728 | Oct 2026 | Working |
| Oracle3 prediction-market agent tools | 569 | Nov 2026 | Local / not checked |
| Flyto Core | 483 | Nov 2026 | Local / not checked |
com.blockscout MCP Server: questions people ask
- Is com.blockscout MCP Server a remote or a local MCP server?
- According to its entry in the official MCP registry, com.blockscout MCP Server ships as a hosted endpoint (streamable-http) that your client connects to by URL.
- Does com.blockscout MCP Server need an API key?
- Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 19, 2026. Individual tools may still ask for a key when called.
- Is com.blockscout MCP Server still maintained?
- Active: the repository's last commit 2 months ago. Last push Sep 8, 2026, 46 GitHub stars, Other licence. Read from GitHub on Nov 17, 2026.
- What tools does com.blockscout MCP Server expose?
- 16 tools as listed by the server itself during the live check, including __unlock_blockchain_analysis__, get_block_info, get_block_number, get_address_by_ens_name, get_transactions_by_address. The full list with parameters is in the Live check section above.
- How do I add com.blockscout MCP Server to Claude, Cursor or VS Code?
- Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.
More Crypto & Web3 servers
Browse all Crypto & Web3 →BlockVectra Docs: Robinhood Chain & EVM
blockvectra
Search and read Robinhood Chain and EVM RPC/API docs. No account, API key or local install.
Bvcc Agent Wallet
blockventurechaincapital-crypto
Non-custodial BVCC Agent Wallet on-chain for AI agents: balances, transfers, approvals, swaps.
Cabal Hunter
paulf280-ui
Solana pre-trade safety for AI agents: cabal, bundle, dump, deployer & honeypot in one verdict.
Casemargin MCP Server
Casemargin
Turn a support ticket into a structured case brief, or score its L2 escalation readiness.
ChainK9
ChainK9
Token risk checks on BSC, ETH, Base and Arc: trades the token on a fork. Paid in USDC/USDT via x402.
Chainstack
chainstacklabs
Deploy and manage blockchain nodes across 70+ protocols, search docs, request testnet funds.
Add the badge to your site
Show visitors that com.blockscout MCP Server is listed here — it’s also the link we check for a free listing.
HTML — for your website
<a href="https://serverdex.io/server/com-blockscout-mcp-server?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="com.blockscout MCP Server — listed on Serverdex" width="123" height="40" loading="lazy"></a>Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.
Markdown — for your README
[](https://serverdex.io/server/com-blockscout-mcp-server?utm_source=badge)Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.