# Blockscout

> Blockscout is a freemium MCP server for cloud and infrastructure. MCP server giving AI agents and IDEs read access to Blockscout blockchain explorer data. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Self-hosted, Web
- **Website:** https://blockscout.com
- **Repository:** https://github.com/blockscout/mcp-server
- **MCP Registry name:** com.blockscout/mcp-server
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-21

## About

The README describes this as a Model Context Protocol server that wraps Blockscout APIs, so AI clients such as Claude, Cursor or other MCP hosts can query onchain data like balances, token holdings, NFTs and contract metadata through a set of named tools. Requests are routed through the Blockscout PRO API, so a PRO API key from the Blockscout Developer Portal is required for most data tools.

The server supports multiple chains and uses chain metadata to resolve which network a query targets. Responses are trimmed and paginated with opaque cursors to keep large results from overflowing an LLM's context window. The project also offers a REST API alongside the MCP endpoint and can be run over stdio, HTTP streamable transport or Docker.

It is aimed at developers and analysts who want an assistant to investigate transactions, addresses, tokens or contracts on EVM chains without writing their own explorer integration.

## Features

- **Multichain data access:** Queries span many EVM networks, with a chain list tool for finding supported chain identifiers.
- **Address and token inspection:** Tools return balances, ERC-20 holdings, NFT ownership and public address tags.
- **Contract reading:** Fetch ABIs, verified source files and run read-only contract functions.
- **Transaction and block lookup:** Retrieve decoded transaction inputs, token transfers and block details by number or timestamp.
- **Context-friendly responses:** Large fields are truncated and results are paginated to conserve LLM tokens.
- **Flexible deployment:** Runs over stdio, HTTP streamable transport, optional REST API or Docker.

## Good for

- Asking an AI assistant which approvals an address has granted on a given chain
- Calculating gas fees paid by a wallet over a chosen month
- Checking whether a token contract includes blacklisting functions
- Finding the block that was current at a specific date and time
- Reviewing the source code of a verified smart contract from an IDE

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http mcp-server https://mcp.blockscout.com/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://mcp.blockscout.com/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "url": "https://mcp.blockscout.com/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.blockscout.com/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-server": {
      "serverUrl": "https://mcp.blockscout.com/mcp"
    }
  }
}
```

### Grok Bot (Grok Bot desktop app → Connect apps → Add a custom connector)

```sh
https://mcp.blockscout.com/mcp
```

Enter a Name (for example "Blockscout"), choose Type: Remote HTTPS, paste this as the Server URL and choose Add plugin.

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-server": {
      "type": "http",
      "url": "https://mcp.blockscout.com/mcp"
    }
  }
}
```

## Tools

All 16 tools say they're read-only. From the server's own tool annotations; not verified by us.

- `__unlock_blockchain_analysis__` (says read-only): 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.
- `get_block_info` (says read-only): 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.
- `get_block_number` (says read-only): 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.
- `get_address_by_ens_name` (says read-only): Useful for when you need to convert an ENS domain name (e.g. "blockscout.eth") to its corresponding Ethereum address.
- `get_transactions_by_address` (says read-only): 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
- `get_token_transfers_by_address` (says read-only): 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.
- `lookup_token_by_symbol` (says read-only): 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.
- `get_contract_abi` (says read-only): 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.
- `inspect_contract_code` (says read-only): Inspects a verified contract's source code or metadata.
- `read_contract` (says read-only): 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": "0xdAC17F958D2ee523a2206206994
- `get_address_info` (says read-only): 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): deter
- `get_tokens_by_address` (says read-only): 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. **SU
- `nft_tokens_by_address` (says read-only): 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 PAGINA
- `get_transaction_info` (says read-only): 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 w
- `get_chains_list` (says read-only): 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 mat
- `direct_api_call` (says read-only): 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 

## FAQ

### Do I need an API key to use Blockscout?

Yes. The README says most data tools route through the Blockscout PRO API, and a key from the Blockscout Developer Portal is required, with a free tier that needs no credit card.

### How do I connect Blockscout to Claude or Cursor?

The README gives setup steps for Claude custom connectors, Claude Code, Codex, Cursor and ChatGPT Apps, using the hosted endpoint at https://mcp.blockscout.com/mcp.

### Can I run Blockscout myself?

Yes. The README documents local installation, running in stdio or HTTP mode, and a Docker image at ghcr.io/blockscout/mcp-server.

### Does Blockscout collect telemetry?

Community instances collect anonymous usage data by default, according to the README, and it can be turned off with BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY=true.

### Is Blockscout free?

Blockscout has a free plan, with paid plans for more usage or features.

### How do I add Blockscout to Claude Code?

Run this command in your terminal: claude mcp add --transport http mcp-server https://mcp.blockscout.com/mcp

### What are the best alternatives to Blockscout?

The closest alternatives to Blockscout are Universal Blockchain MCP, Komodo MCP Server, awslabs and Azure MCP Server.

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Status and tools: checked automatically by AIPoweredBot on 20 November 2026.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Universal Blockchain MCP](https://ai-powered.com/mcp/universal-blockchain-mcp): Universal Blockchain MCP is an open-source MCP server for finance and payments.
- [Komodo MCP Server](https://ai-powered.com/mcp/komodo-mcp-server-2): Komodo MCP Server is an open-source MCP server for cloud and infrastructure.
- [awslabs](https://ai-powered.com/mcp/awslabs): awslabs is an open-source MCP server for cloud and infrastructure.
- [Azure MCP Server](https://ai-powered.com/mcp/azure-mcp-server): Azure MCP Server is an open-source MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/blockscout-2
