blockscout-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| CHAINS_FILE | No | Path to a JSON file of custom chains. | |
| ONLY_CHAINS_FILE | No | When true, register only CHAINS_FILE chains (exclude bundled). | false |
| BLOCKSCOUT_PAGE_SIZE | No | Page size hint. | 10 |
| BLOCKSCOUT_TIMEOUT_MS | No | Timeout for heavy list requests. | 30000 |
| BLOCKSCOUT_MAX_RETRIES | No | Transport-error retries for GET. | 3 |
| BLOCKSCOUT_DIRECT_API_LIMIT | No | Char cap on direct_api_call responses. | 100000 |
| BLOCKSCOUT_LIGHT_TIMEOUT_MS | No | Timeout for point lookups. | 15000 |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| __unlock_blockchain_analysis__A | MANDATORY FIRST STEP for AI agents. Returns usage rules and conventions for this server. Call this once before invoking any other tool. |
| get_chains_listA | List all chains this server can query (bundled registry + any custom chains from CHAINS_FILE). Optionally filter by name or chain ID. |
| get_address_infoA | Get balance, type (account vs contract), and metadata for an address on a chain. Use this first when asked about a wallet or contract. |
| get_tokens_by_addressA | List ERC-20/721/1155 token balances held by an address. Paginated. |
| get_token_transfers_by_addressA | List token transfer events involving an address (in and out). Paginated. |
| get_transactions_by_addressA | List native transactions involving an address (sent and received). Paginated. |
| get_transaction_infoB | Get full details for a transaction by hash: status, value, gas, and decoded input. |
| get_token_transfers_by_transactionC | List token transfers that occurred within a single transaction. |
| get_block_infoA | Get details for a block by number or hash: timestamp, miner, gas used, and tx count. |
| get_block_numberA | Get the latest (most recent) block height for a chain. |
| get_logsA | List event logs emitted by a contract/address. Large |
| get_contract_abiA | Get the ABI of a verified smart contract. Returns the ABI array only. |
| inspect_contract_codeA | Get verified source code and compiler metadata for a smart contract. |
| nft_tokens_by_addressA | List NFT (ERC-721/1155) tokens owned by an address. Paginated. |
| lookup_token_by_symbolA | Search for tokens by symbol or name on a chain. Returns candidate tokens with their contract addresses. |
| direct_api_callA | Escape hatch: call any Blockscout REST v2 endpoint not covered by a dedicated tool. endpoint_path is relative to /api/v2 (e.g. "/addresses/0x.../counters"). Response is capped in size. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| usage | How to use the Blockscout MCP server. |
Latest Blog Posts
- Your AI Chatbot Just Exposed Your CEO's Salary to an InternBy Om-Shree-0709 on .Agent IdentityMCP SecurityOAuth Delegation
- Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)By Om-Shree-0709 on .Agentic AiPrompt InjectionWebAssembly
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/imelon2/blockscout-mcp-server'
If you have feedback or need assistance with the MCP directory API, please join our Discord server