Blockscout MCP Server

Name: Blockscout MCP Server
Author: blockscout

@blockscout

Repository

About Blockscout MCP Server

Wraps Blockscout APIs and exposes blockchain data by Model Context Protocol

#blockscout #mcp-server #blockchain-data

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-server-blockscout": {
      "command": "uv",
      "args": [
        "pip",
        "install",
        "-e",
        ".",
        "#",
        "or",
        "`pip",
        "install",
        "-e",
        ".`"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Blockscout MCP Server?

The Blockscout MCP Server wraps Blockscout APIs and exposes blockchain data—balances, tokens, NFTs, contract metadata—via the Model Context Protocol (MCP). It enables AI agents, IDEs, and automation tools (like Claude, Cursor, or ChatGPT) to consume and analyze structured blockchain data contextually, with multi-chain support through the Blockscout PRO API and Chainscout metadata enrichment.

How to use Blockscout MCP Server?

Obtain a Blockscout PRO API key from the Blockscout Developer Portal (free tier, no credit card). Configure your MCP client to connect to the hosted server at https://mcp.blockscout.com/mcp using streamable HTTP transport, supplying the API key via the Blockscout-MCP-Pro-Api-Key header. Alternatively, install via the Anthropic Connectors Directory (Claude Web/Desktop) or the ChatGPT Apps marketplace. Developers can run the server locally using Docker from ghcr.io/blockscout/mcp-server:latest.

Key features of Blockscout MCP Server

Contextual blockchain data access for AI tools
Multi-chain support via Blockscout PRO API configuration
Versioned REST API with comprehensive web-friendly interface
Intelligent context optimization to conserve LLM tokens
Opaque cursor pagination using Base64URL-encoded strings
Automatic truncation of large data fields with clear indicators
Standardized ToolResponse model with structured JSON responses
Enhanced observability with MCP progress notifications

Use cases of Blockscout MCP Server

Check token approvals (e.g., OP token on Optimism) for a given ENS address
Calculate total gas fees paid by an address on a specific chain over a time period
Retrieve the most recent logs emitted by a smart contract before a given timestamp
Investigate transaction details, including decoded input and token transfers, on any supported chain
Query the latest block on a chain and check recent fund movements from the block miner

FAQ from Blockscout MCP Server

What is required to use the Blockscout MCP server?

A valid Blockscout PRO API key is required. Most data tools route requests through the authenticated PRO API gateway; without a valid key, tools fail fast.

How do I obtain a Blockscout PRO API key?

Register on the Blockscout Developer Portal (free tier, no credit card needed) and generate an API key. Keys are prefixed proapi_.

Which MCP clients are supported?

Claude (Desktop, Code, and Web via Anthropic Connectors), ChatGPT Apps, Codex (App and CLI), and Cursor are officially documented. The server uses a streamable HTTP transport at https://mcp.blockscout.com/mcp.

Can I run the Blockscout MCP server locally?

Yes. Developers can run the server locally using the Docker image ghcr.io/blockscout/mcp-server:latest. Example configuration for Claude Desktop is provided in the README.