junct-bot avatar

Blockscout Mcp

junct-bot/blockscout-mcp

Gives you agent-ready access to Blockscout's blockchain explorer API with 56 tools covering transactions, addresses, tokens, smart contracts, and on-chain metrics. The server is deterministically generated from Blockscout's OpenAPI spec, so every tool maps directly to a real endpoint with no phantom methods. It's hosted and free to use with no authentication required. Reach for this when you need Claude to query blockchain data, analyze contract interactions, or pull network statistics without writing custom API integration code. Built by Junct as part of their agent-readiness layer for crypto infrastructure.

tools
15
transport
HTTP
last updated
Mar 19, 2026

Tools

15 tools

Public tool metadata for what this MCP can expose to an agent.

get_block_infoGet 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 chain...3 params

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 chain...

Parameters* required
chain_idstring
The ID of the blockchain
include_transactionsvalue
If true, includes a list of transaction hashes from the block.default: false
number_or_hashstring
Block number or hash
get_block_numberRetrieves 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 ti...2 params

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 ti...

Parameters* required
chain_idstring
The ID of the blockchain
datetimevalue
The date and time (ISO 8601 format, e.g. 2025-05-22T23:00:00.00Z) to find the block for. If omitted, returns the latest block.
get_address_by_ens_nameUseful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.1 params

Useful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.

Parameters* required
namestring
ENS domain name to resolve
get_transactions_by_addressRetrieves 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 hist...6 params

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 hist...

Parameters* required
addressstring
Address which either sender or receiver of the transaction
age_fromstring
Start date and time (e.g 2025-05-22T23:00:00.00Z).
age_tovalue
End date and time (e.g 2025-05-22T22:30:00.00Z).
chain_idstring
The ID of the blockchain
cursorvalue
The pagination cursor from a previous response to get the next page of results.
methodsvalue
A method signature to filter transactions by (e.g 0x304e6ade)
get_token_transfers_by_addressGet ERC-20 token transfers for an address within a specific time range. Use cases: - `get_token_transfers_by_address(address, age_from)` - get all transfers of any ERC-20 token to/from the address since the given date up to the current time - `get_token_transfers_by_address(ad...6 params

Get ERC-20 token transfers for an address within a specific time range. Use cases: - `get_token_transfers_by_address(address, age_from)` - get all transfers of any ERC-20 token to/from the address since the given date up to the current time - `get_token_transfers_by_address(ad...

Parameters* required
addressstring
Address which either transfer initiator or transfer receiver
age_fromstring
Start date and time (e.g 2025-05-22T23:00:00.00Z).
age_tovalue
End date and time (e.g 2025-05-22T22:30:00.00Z). Can be omitted to get all transfers up to the current time.
chain_idstring
The ID of the blockchain
cursorvalue
The pagination cursor from a previous response to get the next page of results.
tokenvalue
An ERC-20 token contract address to filter transfers by a specific token. If omitted, returns transfers of all tokens.
lookup_token_by_symbolSearch for token addresses by symbol or name. Returns multiple potential matches based on symbol or token name similarity. Only the first ``TOKEN_RESULTS_LIMIT`` matches from the Blockscout API are returned.2 params

Search for token addresses by symbol or name. Returns multiple potential matches based on symbol or token name similarity. Only the first ``TOKEN_RESULTS_LIMIT`` matches from the Blockscout API are returned.

Parameters* required
chain_idstring
The ID of the blockchain
symbolstring
Token symbol or name to search for
get_contract_abiGet 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.2 params

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.

Parameters* required
addressstring
Smart contract address
chain_idstring
The ID of the blockchain
inspect_contract_codeInspects a verified contract's source code or metadata.3 params

Inspects a verified contract's source code or metadata.

Parameters* required
addressstring
The address of the smart contract.
chain_idstring
The ID of the blockchain.
file_namevalue
The name of the source file to inspect. If omitted, returns contract metadata and the list of source files.
read_contractCalls 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...6 params

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...

Parameters* required
abiobject
The JSON ABI for the specific function being called. This should be a dictionary that defines the function's name, inputs, and outputs. The function ABI can be obtained using the `get_contract_abi`...
addressstring
Smart contract address
argsstring
A JSON string containing an array of arguments. Example: "["0xabc..."]" for a single address argument, or "[]" for no arguments. Order and types must match ABI inputs. Addresses: use 0x-prefixed st...default: []
blockvalue
The block identifier to read the contract state from. Can be a block number (e.g., 19000000) or a string tag (e.g., 'latest'). Defaults to 'latest'.default: latest
chain_idstring
The ID of the blockchain
function_namestring
The symbolic name of the function to be called. This must match the `name` field in the provided ABI.
get_address_infoGet 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) - Cont...2 params

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) - Cont...

Parameters* required
addressstring
Address to get information about
chain_idstring
The ID of the blockchain
get_tokens_by_addressGet 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...3 params

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...

Parameters* required
addressstring
Wallet address
chain_idstring
The ID of the blockchain
cursorvalue
The pagination cursor from a previous response to get the next page of results.
nft_tokens_by_addressRetrieve 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). Ess...3 params

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). Ess...

Parameters* required
addressstring
NFT owner address
chain_idstring
The ID of the blockchain
cursorvalue
The pagination cursor from a previous response to get the next page of results.
get_transaction_infoGet 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 transact...3 params

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 transact...

Parameters* required
chain_idstring
The ID of the blockchain
include_raw_inputvalue
If true, includes the raw transaction input data.default: false
transaction_hashstring
Transaction hash
get_chains_listGet the list of known blockchain chains with their IDs. Useful for getting a chain ID when the chain name is known. This information can be used in other tools that require a chain ID to request information.

Get the list of known blockchain chains with their IDs. Useful for getting a chain ID when the chain name is known. This information can be used in other tools that require a chain ID to request information.

No parameter schema in public metadata yet.

direct_api_callCall a raw Blockscout API endpoint for advanced or chain-specific data. Do not include query strings in ``endpoint_path``; pass all query parameters via ``query_params`` to avoid double-encoding. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provide...4 params

Call a raw Blockscout API endpoint for advanced or chain-specific data. Do not include query strings in ``endpoint_path``; pass all query parameters via ``query_params`` to avoid double-encoding. **SUPPORTS PAGINATION**: If response includes 'pagination' field, use the provide...

Parameters* required
chain_idstring
The ID of the blockchain
cursorvalue
The pagination cursor from a previous response to get the next page of results.
endpoint_pathstring
The Blockscout API path to call (e.g., '/api/v2/stats'); do not include query strings.
query_paramsvalue
Optional query parameters forwarded to the Blockscout API.

Sponsors

Readme

Blockscout MCP Server

MCP server for Blockscout. Agent-ready API for Blockscout.

Hosted at blockscout.mcp.junct.dev/mcp. Free to use. No auth. No API key required.

Part of Junct — the agent-readiness layer for the crypto stack.

Quick Start

Add to your MCP client config (Claude Desktop, Cursor, Windsurf):

{
  "mcpServers": {
    "blockscout": {
      "url": "https://blockscout.mcp.junct.dev/mcp",
      "transport": "streamable-http"
    }
  }
}

About

This MCP server is deterministically generated from the Blockscout API specification. Every tool maps 1:1 to a real API endpoint — no hallucinated endpoints, no phantom tools.

Links


View the full README on GitHub

Details

Repository
github.com/junct-bot/blockscout-mcp
Website
blockscout.mcp.junct.dev
Categories
Monitoring & Observability, Data & Analytics
Transport
HTTP
Registry
MCP registry, active

More from junct-bot

Related Monitoring & Observability MCP servers

View all
1junct-bot avatarCoingecko Mcpjunct-bot/coingecko-mcpCoingecko - 36 tools for data, metrics, and on-chain analytics0stars
2jusspound-netizen avatarContext Bridgejusspound-netizen/context-bridgeAn MCP server that connects AI agents to Jira, Sentry, and GitHub Actions.0stars
3kcofoni avatarDuplicati Mcpkcofoni/duplicati-mcpMCP server for Duplicati backup management — list, run, monitor and configure jobs from an LLM.0stars
4kyurish avatarTrading212 Mcp Serverkyurish/trading212-mcp-serverMCP server for Trading 212 API - portfolio, orders, pies, dividends, and analytics0stars
5lazycipher avatarDelulu Biolazycipher/delulubio-mcpManage your Delulu Bio link-in-bio page: links, appearance, profile, analytics and inbox.0stars
6listingbureau avatarListing Bureau - Amazon Organic Ranking MCP Serverlistingbureau/listingbureau-mcpAmazon organic ranking MCP server. Run campaigns, track positions, monitor rank movement.0stars