Blockscout MCP Server

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.

Is there a showcase to try the server’s capabilities?

Yes. The Blockscout X-Ray GPT on ChatGPT demonstrates the full capabilities of the MCP server for intelligent blockchain analysis.