# mcp-server MCP server MCP server for Blockscout ## Links - Registry page: https://www.getdrio.com/mcp/com-blockscout-mcp-server - Repository: https://github.com/blockscout/mcp-server - Website: https://blockscout.com ## Install - Endpoint: https://mcp.blockscout.com/mcp - Auth: Not captured ## Setup notes - Remote endpoint: https://mcp.blockscout.com/mcp ## Tools - __unlock_blockchain_analysis__ (Unlock Blockchain Analysis) - Mandatory initialization step for any session against the Blockscout MCP server. Returns server reference data plus the `blockscout-analysis` skill pointer and URI resolution rule. MANDATORY FOR AI AGENTS: Call this tool first in every session. The returned payload identifies where the operating rules and analysis framework live and how to read referenced skill files before executing further tool calls. Endpoint: https://mcp.blockscout.com/mcp - get_block_info (Get Block Information) - 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. Endpoint: https://mcp.blockscout.com/mcp - get_block_number (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 current chain tip. If `datetime` is provided, finds the block immediately preceding that time. If omitted, returns the latest indexed block. Endpoint: https://mcp.blockscout.com/mcp - get_address_by_ens_name (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. Endpoint: https://mcp.blockscout.com/mcp - get_transactions_by_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.). 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; use `internal_transaction_index` for execution order. Requires an `age_from` date to scope results for performance and relevance. Use cases: - `get_transactions_by_address(address, age_from)` - get all txs to/from the address since a given date. - `get_transactions_by_address(address, age_from, age_to)` - get all txs to/from the address between given dates. - `get_transactions_by_address(address, age_from, age_to, methods)` - get all txs to/from the address between given dates, filtered by method. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages. Endpoint: https://mcp.blockscout.com/mcp - get_token_transfers_by_address (Get Token Transfers by Address) - Get ERC-20 token transfers for an address within a specific time range. Use cases: - `get_token_transfers_by_address(address, age_from)` - get all transfers of any ERC-20 token to/from the address since the given date up to the current time - `get_token_transfers_by_address(address, age_from, age_to)` - get all transfers of any ERC-20 token to/from the address between the given dates - `get_token_transfers_by_address(address, age_from, age_to, token)` - get all transfers of the given ERC-20 token to/from the address between the given dates **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages. Endpoint: https://mcp.blockscout.com/mcp - lookup_token_by_symbol (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 ``TOKEN_RESULTS_LIMIT`` matches from the Blockscout API are returned. Endpoint: https://mcp.blockscout.com/mcp - get_contract_abi (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 contract data. Endpoint: https://mcp.blockscout.com/mcp - inspect_contract_code (Inspect Contract Code) - Inspects a verified contract's source code or metadata. Endpoint: https://mcp.blockscout.com/mcp - read_contract (Read from 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 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"]" } } Endpoint: https://mcp.blockscout.com/mcp - get_address_info (Get Address Information) - 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): 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. Endpoint: https://mcp.blockscout.com/mcp - get_tokens_by_address (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 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. Endpoint: https://mcp.blockscout.com/mcp - nft_tokens_by_address (Get 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 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. Endpoint: https://mcp.blockscout.com/mcp - get_transaction_info (Get Transaction Information) - 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 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. Endpoint: https://mcp.blockscout.com/mcp - get_chains_list (Get List of Chains) - Get supported blockchain chains with their chain IDs. 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. Endpoint: https://mcp.blockscout.com/mcp - direct_api_call (Direct Blockscout API Call) - Call a raw Blockscout API endpoint for advanced or chain-specific data. Do not include query strings in ``endpoint_path``; pass all query parameters via ``query_params`` to avoid double-encoding. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages (GET only). Supports POST requests with a JSON body for endpoints like JSON RPC. Returns: ToolResponse[Any]: Must return ToolResponse[Any] (not ToolResponse[BaseModel]) because specialized handlers can return lists or other types that don't inherit from BaseModel. The dispatcher system supports flexible data structures. Endpoint: https://mcp.blockscout.com/mcp ## Resources - blockscout-mcp://skill/SKILL.md - MANDATORY — invoke this skill BEFORE making any Blockscout MCP tool calls or writing any blockchain data scripts, even when the Blockscout MCP server is already configured. Provides architectural rules, execution-strategy decisions, MCP REST API conventions for scripts, endpoint reference files, response transformation requirements, and output conventions that are not available from MCP tool descriptions alone. Use when the user asks about on-chain data, blockchain analysis, wallet balances, token transfers, contract interactions, on-chain metrics, wants to use the Blockscout API, or needs to build software that retrieves blockchain data via Blockscout. Covers all EVM chains. MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api-index.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/addresses.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/arbitrum.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/blocks.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/celo.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/ethereum.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/mud.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/optimism.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/scroll.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/search.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/shibarium.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/smart-contracts.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/stability.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/stats.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/tokens.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/transactions.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/user-operations.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/zilliqa.md - MIME type: text/markdown - blockscout-mcp://skill/references/blockscout-api/zksync.md - MIME type: text/markdown - blockscout-mcp://skill/references/chainscout-api.md - MIME type: text/markdown ## Prompts Not captured ## Metadata - Owner: com.blockscout - Version: 0.15.0 - Runtime: Streamable Http - Transports: HTTP - License: Not captured - Language: Not captured - Stars: Not captured - Updated: Mar 3, 2026 - Source: https://registry.modelcontextprotocol.io