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 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| 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
- Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)By Om-Shree-0709 on .mcpAgent IdentityOAuth 2.1
- 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