blockscout-mcp-server
Server Details
Provide AI agents and automation tools with contextual access to blockchain data including balance…
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- blockscout/mcp-server
- GitHub Stars
- 46
- Server Listing
- Blockscout MCP Server
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 16 tools
Most tools target distinct resources or actions (address, block, transaction, token, NFT, contract), and descriptions clarify boundaries. The raw `direct_api_call` slightly overlaps every specific tool, but it is positioned as an advanced fallback, and `read_contract`/`inspect_contract_code`/`get_contract_abi` are related yet reasonably differentiated.
Nearly all tools use snake_case, and most follow a predictable verb_noun pattern such as `get_address_info` or `get_token_transfers_by_address`. Minor deviations exist: `nft_tokens_by_address` starts with a noun, and `__unlock_blockchain_analysis__` uses dunder/init-style naming rather than the standard pattern.
16 tools is slightly above the ideal compact range but reasonable for a blockchain explorer covering addresses, blocks, transactions, tokens, NFTs, contracts, chains, and ENS. Each tool has a plausible role, though the raw API catch-all reduces the need for some specialized wrappers.
The surface covers core explorer workflows: address info, balances, token holdings and transfers, NFTs, transactions, blocks, contract ABI/source/read, ENS, and chain lookup. Notable gaps like dedicated event-log or transaction-receipt tools can be handled through `direct_api_call`, so the set is mostly complete with minor workarounds.
Available Tools
16 toolsdirect_api_callDirect Blockscout API CallARead-onlyInspect
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 Blockscout API knowledge is not a substitute:
endpoint paths, parameters, and response shapes vary across Blockscout
versions and per-chain deployments.
Supports POST requests with a JSON body for endpoints like JSON RPC.
**SUPPORTS PAGINATION**: If response includes 'pagination' field,
use the provided next_call to get additional pages (GET only).
Inputs: chain_id (required), endpoint_path (required), cursor, method, +3 more. Returns: data, notes, pagination, content_text, +2 more
get_address_by_ens_nameGet Address by ENS NameARead-onlyInspect
Useful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.
Inputs: name (required), session_id. Returns: data, notes, pagination, content_text, +2 more
get_address_infoGet Address InformationARead-onlyInspect
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.
Inputs: address (required), chain_id (required), session_id. Returns: data, notes, pagination, content_text, +2 more
get_block_infoGet Block InformationARead-onlyInspect
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.
Inputs: chain_id (required), number_or_hash (required), session_id, include_transactions. Returns: data, notes, pagination, content_text, +2 more
get_block_numberGet Block NumberARead-onlyInspect
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.
Inputs: chain_id (required), datetime, session_id. Returns: data, notes, pagination, content_text, +2 more
get_chains_listGet List of ChainsARead-onlyInspect
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
as `1`, because matching is substring-based and may return many chains.
Inputs: query, session_id. Returns: data, notes, pagination, content_text, +2 more
get_contract_abiGet Contract ABIARead-onlyInspect
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.
Inputs: address (required), chain_id (required), session_id. Returns: data, notes, pagination, content_text, +2 more
get_tokens_by_addressGet Tokens by AddressARead-onlyInspect
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.
Inputs: address (required), chain_id (required), cursor, session_id. Returns: data, notes, pagination, content_text, +2 more
get_token_transfers_by_addressGet Token Transfers by AddressARead-onlyInspect
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.
Inputs: address (required), age_from (required), chain_id (required), token, +3 more. Returns: data, notes, pagination, content_text, +2 more
get_transaction_infoGet Transaction InformationARead-onlyInspect
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.
Inputs: chain_id (required), transaction_hash (required), session_id, include_raw_input. Returns: data, notes, pagination, content_text, +2 more
get_transactions_by_addressGet Transactions by AddressARead-onlyInspect
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.
Requires an `age_from` date to scope results for performance and relevance.
**SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provided next_call to get additional pages.
Inputs: address (required), age_from (required), chain_id (required), age_to, +3 more. Returns: data, notes, pagination, content_text, +2 more
inspect_contract_codeInspect Contract CodeARead-onlyInspect
Inspects a verified contract's source code or metadata.
Inputs: address (required), chain_id (required), file_name, session_id. Returns: data, notes, pagination, content_text, +2 more
lookup_token_by_symbolLookup Token by SymbolARead-onlyInspect
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.
Inputs: symbol (required), chain_id (required), session_id. Returns: data, notes, pagination, content_text, +2 more
nft_tokens_by_addressGet NFT Tokens by AddressARead-onlyInspect
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.
Inputs: address (required), chain_id (required), cursor, session_id. Returns: data, notes, pagination, content_text, +2 more
read_contractRead from ContractARead-onlyInspect
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"]"
}
}
Inputs: abi (required), address (required), chain_id (required), function_name (required), +3 more. Returns: data, notes, pagination, content_text, +2 more
__unlock_blockchain_analysis__Unlock Blockchain AnalysisARead-onlyInspect
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.
Inputs: no named parameters. Returns: data, notes, pagination, content_text, +2 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Pay-per-call on-chain data for AI agents: token, wallet, risk, whale, NFT, tx. No API keys.
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Blockchain analytics API for AI agents. Smart Money signals, wallet profiling, token analytics.
Read-only on-chain intelligence for AI agents on Base: balances, tokens, gas, tx status.
Related MCP Servers
- AlicenseNot gradedqualityBmaintenanceEnables AI assistants to access live blockchain data across multiple networks, including wallet holdings, payment verification, token prices, swaps, and scam checks.MIT
- AlicenseAqualityDmaintenanceEnables AI agents to check balances and send transactions across multiple blockchains with automatic spending limit protection and policy enforcement.3MIT

Noves MCP Serverofficial
AlicenseBqualityDmaintenanceEnables AI assistants to access and explain blockchain data across 100+ networks using natural language, without requiring authentication.9943 npmMIT- FlicenseNot gradedqualityDmaintenanceEnables AI applications to retrieve on-chain context from EVM-compatible blockchains via the Model Context Protocol.-
Glama MCP Gateway
Add one secure layer between your agents and this server.