MCP server for Blockscout
| Endpoint | https://mcp.blockscout.com/mcp (streamable-http) |
|---|---|
| Registry version | 0.19.0 |
| Now | 16 tools · grade C (67) · pin ts_7bfbc12a501d5043eed5ef774cb5e47e · protocol 2025-06-18 |
| First / last listed | 2026-10-30 02:13 UTC / 2026-10-30 02:13 UTC |
| Grade over time | 2026-10-30: C (67), 16 tools |
Is this your server? Own a server? ToolFit hosted watch re-checks it every 24 h ($0.25 per 30 days) or 6 h ($0.60) and sends you an HMAC-signed webhook when its tools or grade change: POST https://api.youraitools.co/toolfit/v1/watch. To opt out, see About & opt-out.
Tools: __unlock_blockchain_analysis__ get_block_info get_block_number get_address_by_ens_name get_transactions_by_address get_token_transfers_by_address lookup_token_by_symbol get_contract_abi inspect_contract_code read_contract get_address_info get_tokens_by_address nft_tokens_by_address get_transaction_info get_chains_list direct_api_call
__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.
params: none |
get_block_info |
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.
params: chain_id*, number_or_hash*, include_transactions, session_id |
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.
params: chain_id*, datetime, session_id |
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.
params: name*, session_id |
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.
Requ params: chain_id*, address*, age_from*, age_to, methods, cursor, session_id |
get_token_transfers_by_address |
Get 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.
params: chain_id*, address*, age_from*, age_to, token, cursor, session_id |
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
7 matches from the Blockscout API are returned.
params: chain_id*, symbol*, session_id |
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.
params: chain_id*, address*, session_id |
inspect_contract_code | Inspects a verified contract's source code or metadata. params: chain_id*, address*, file_name, session_id |
read_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": { params: chain_id*, address*, abi*, function_name*, args, block, session_id |
get_address_info |
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 infor params: chain_id*, address*, session_id |
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 t params: chain_id*, address*, cursor, session_id |
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.
params: chain_id*, address*, cursor, session_id |
get_transaction_info |
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; params: chain_id*, transaction_hash*, include_raw_input, session_id |
get_chains_list | Get 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
params: query, session_id |
direct_api_call | Call 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 Blocksc params: chain_id*, endpoint_path*, query_params, cursor, method, json_body, session_id |
Entries describe changes in tool definitions. They are not statements about a server, its quality or its author. The grade measures how the tool definitions fit model providers (token cost, schema compatibility, confusable names) as scored by the ToolFit engine at the time of the listing. JSON: append .json. Opt-out: how or hello@youraitools.co.