# blockscout-mcp-server

Feeds an AI agent balances, tokens, NFTs and contract metadata from Blockscout. Handy when you want to inspect a wallet or contract without leaving the editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 46
- Author: blockscout
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/blockscout/mcp-server
- Updated: 2026-09-08
- HTML: https://affpapa.org/en/nevibecode/mcp/blockscout-mcp-server

## What it does

The server wraps Blockscout APIs and exposes blockchain data over MCP. An agent can pull balances, tokens, NFTs and contract metadata, then work with them in context. Multi-chain setups run through the Blockscout PRO API with Chainscout metadata enrichment.

Context stays manageable: responses are sliced into pages of a configurable size, oversized fields get truncated with a marker and a hint on how to reach the rest. Pagination uses opaque Base64URL cursors rather than long parameter lists. A versioned REST API exposes the same toolset over plain HTTP.

A Blockscout PRO API key is required. Most data tools route through the authenticated gateway, and an invalid key makes them fail before any upstream call. Keys carry the `proapi_` prefix and come from the Blockscout developer portal, where the free tier needs no credit card. In Claude the key travels in the `Blockscout-MCP-Pro-Api-Key` header.

## Requirements
- Remote server: `https://server.smithery.ai/@blockscout/mcp-server/mcp`

## Install

### Claude Code (native platform)

**Platform CLI: remote server**
```bash
claude mcp add --transport http blockscout-mcp-server https://server.smithery.ai/@blockscout/mcp-server/mcp
```

### Codex

**Platform CLI: remote server**
```bash
codex mcp add blockscout-mcp-server --url https://server.smithery.ai/@blockscout/mcp-server/mcp
```

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "blockscout-mcp-server": {
            "url": "https://server.smithery.ai/@blockscout/mcp-server/mcp"
        }
    }
}
```

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "blockscout-mcp-server": {
            "type": "http",
            "url": "https://server.smithery.ai/@blockscout/mcp-server/mcp"
        }
    }
}
```

### Gemini CLI

**Platform CLI: remote server**
```bash
gemini mcp add -t http blockscout-mcp-server https://server.smithery.ai/@blockscout/mcp-server/mcp
```

## When to use it
- check a wallet balance and its tokens without leaving the editor
- read contract metadata for an address
- list NFTs held by a wallet
- query several chains through one server
- give an agent blockchain data without blowing up context

## Example prompts
- Show the balances and tokens for 0x... using blockscout
- Fetch the metadata for contract 0x... and explain what it does
- List the NFTs in this wallet, grouped by collection

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md