Skip to main content
Glama
imelon2

blockscout-mcp-server

by imelon2

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
CHAINS_FILENoPath to a JSON file of custom chains.
ONLY_CHAINS_FILENoWhen true, register only CHAINS_FILE chains (exclude bundled).false
BLOCKSCOUT_PAGE_SIZENoPage size hint.10
BLOCKSCOUT_TIMEOUT_MSNoTimeout for heavy list requests.30000
BLOCKSCOUT_MAX_RETRIESNoTransport-error retries for GET.3
BLOCKSCOUT_DIRECT_API_LIMITNoChar cap on direct_api_call responses.100000
BLOCKSCOUT_LIGHT_TIMEOUT_MSNoTimeout for point lookups.15000

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}
resources
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
__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 data fields are truncated. Paginated.

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription
usageHow to use the Blockscout MCP server.

Latest Blog Posts

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