# Blockscout MCP server

> Query blockchain explorer data across EVM chains: blocks, addresses, tokens, NFTs, transactions and smart contracts.

- Listing: https://mcp.tc/i/blockscout
- Connect: use the server's own URL `https://mcp.blockscout.com/mcp` (no sign-in); clients connect to it directly. The listing link is a page, not an MCP endpoint.
- Type: remote (Streamable HTTP)
- Auth: none
- Category: [Finance & Payments](https://mcp.tc/c/finance-payments)
- Vendor: Blockscout
- Homepage: <https://www.blockscout.com/>
- Repository: <https://github.com/blockscout/mcp-server>

## About

Blockscout connects an assistant to Blockscout explorer APIs for EVM chains. It can look up blocks, transactions, addresses, ENS names, token and NFT holdings, token transfers, and verified contract code and ABIs. It can also read contract state and call raw Blockscout API endpoints for chain-specific data.

It runs as a hosted streamable-HTTP endpoint at https://mcp.blockscout.com/mcp. The endpoint accepts connections without sign-in, but the README says most data tools route through the Blockscout PRO API and need a PRO API key (prefixed proapi\_) sent in a request header.

## What it can do

- Look up blocks by number, hash or date
- Inspect transactions with decoded input and token transfers
- Get address balances, ENS names and contract status
- List ERC-20 token holdings and transfers for an address
- List NFTs owned by an address
- Read verified contract source, ABIs and call view functions
- Find supported chains and their chain IDs
- Call raw Blockscout API endpoints for chain-specific data

## Tools (16)

- `__unlock_blockchain_analysis__`: Initialize a session and return reference data and the analysis skill pointer; call once first. (read-only)
- `get_block_info`: Get block details such as timestamp, gas used, burnt fees and transaction count. (read-only)
- `get_block_number`: Find the block number for a date/time or the latest block. (read-only)
- `get_address_by_ens_name`: Resolve an ENS domain name to an Ethereum address. (read-only)
- `get_transactions_by_address`: List native transfers and contract interactions for an address, excluding token transfers. (read-only)
- `get_token_transfers_by_address`: List ERC-20 token transfers for an address in a time range. (read-only)
- `lookup_token_by_symbol`: Search token addresses by symbol or name. (read-only)
- `get_contract_abi`: Get the ABI of a smart contract. (read-only)
- `inspect_contract_code`: Inspect a verified contract's source code or metadata. (read-only)
- `read_contract`: Call a contract function and return the decoded result. (read-only)
- `get_address_info`: Get balance, first transaction, ENS, contract and proxy details for an address. (read-only)
- `get_tokens_by_address`: Get ERC-20 holdings for an address with metadata and market data. (read-only)
- `nft_tokens_by_address`: List NFTs owned by an address, grouped by collection. (read-only)
- `get_transaction_info`: Get enriched transaction data with decoded input, transfers and fee breakdown. (read-only)
- `get_chains_list`: List supported chains and chain IDs, with optional name query. (read-only)
- `direct_api_call`: Call a raw Blockscout API endpoint for advanced or chain-specific data. (read-only)

## Example prompts

- "Show the latest block on Ethereum Mainnet and its gas used."
- "What ERC-20 tokens does vitalik.eth hold?"
- "Explain what happens in transaction 0x... on Base."
- "Get the ABI of this verified contract on Optimism."

## Install

### Claude Code

1. Run this in a terminal, in your project folder:

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

2. Start Claude Code and type `/mcp`. **blockscout** should show as connected.

Add `--scope user` to make it available in every project, not just this one.

### Claude Desktop

1. Open **Settings → Connectors** and click **Add custom connector**.

2. Name it **Blockscout** and paste this URL:

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

3. Click **Add**. Its tools appear in the chat’s tools menu.

Claude Desktop’s JSON config file only starts local servers. Remote servers go through Connectors, and connectors you add on claude.ai show up here too.

### claude.ai

1. Open the connector form on claude.ai. This button fills in the name and URL for you:

[Add to claude.ai](<https://claude.ai/customize/connectors?modal=add-custom-connector&connectorName=Blockscout&connectorUrl=https%3A%2F%2Fmcp.blockscout.com%2Fmcp>) (opens connector settings)

2. Check that the URL reads `https://mcp.blockscout.com/mcp` and click **Add**.

3. Turn it on in a chat from the tools menu.

Free plans allow one custom connector. On Team and Enterprise plans an owner adds it under **Organization settings → Connectors**.

### ChatGPT

1. On chatgpt.com, open **Settings → Security and login** and turn on **Developer mode**.

2. Go to `chatgpt.com/plugins` and click **+** to create an app for a remote MCP server.

3. Paste `https://mcp.blockscout.com/mcp` as the server URL and choose **No authentication**.

Developer mode is available on the web for Plus, Pro, Business, Enterprise and Education accounts.

### Cursor

[Add to Cursor](<https://cursor.com/install-mcp?name=blockscout&config=eyJ1cmwiOiJodHRwczovL21jcC5ibG9ja3Njb3V0LmNvbS9tY3AifQ%3D%3D>) (opens Cursor)

Or add it by hand to `~/.cursor/mcp.json` (all projects) or `.cursor/mcp.json` (this project):

`mcp.json`:

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

### VS Code

[Install in VS Code](<https://vscode.dev/redirect/mcp/install?name=blockscout&config=%7B%22type%22%3A%22http%22%2C%22url%22%3A%22https%3A%2F%2Fmcp.blockscout.com%2Fmcp%22%7D>) (opens VS Code)

Or from a terminal:

```bash
code --add-mcp '{"name":"blockscout","type":"http","url":"https://mcp.blockscout.com/mcp"}'
```

Or commit it to the repo in `.vscode/mcp.json`:

`.vscode/mcp.json`:

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

### Devin Desktop

1. Add it to `~/.config/devin/mcp_config.json` (macOS and Linux) or `%APPDATA%\devin\mcp_config.json` (Windows):

`mcp_config.json`:

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

2. Refresh the MCP server list in Cascade.

Devin Desktop is the new name for Windsurf. It reads `serverUrl` (or `url`) for remote servers.

### Codex

```bash
codex mcp add blockscout --url https://mcp.blockscout.com/mcp
```

Or edit `~/.codex/config.toml` directly:

`config.toml`:

```toml
[mcp_servers.blockscout]
url = "https://mcp.blockscout.com/mcp"
```

### Gemini CLI

```bash
gemini mcp add --transport http blockscout https://mcp.blockscout.com/mcp
```

This adds it to the current project. Add `-s user` to use it everywhere.

### Any client

Most clients accept this shape. Some name the URL field differently: `serverUrl` in Devin Desktop, `httpUrl` in Gemini CLI’s settings file.

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

Zed puts servers under `context_servers` in its settings. Cline needs `"type": "streamableHttp"`, or it assumes SSE.

Client only starts local servers? Bridge it with `npx -y mcp-remote https://mcp.blockscout.com/mcp`.

## Details

- Server version: 1.26.0
- MCP protocol version: 2025-11-25
- Last checked: 2026-10-03 (reachable)
- Listed: 2026-10-03
- Updated: 2026-10-04

---
Source: https://mcp.tc/i/blockscout (mcp.tc is an independent directory, not affiliated with this server's publisher). Corrections: https://mcp.tc/report
