Blockscout MCP Server

This server wraps Blockscout APIs and exposes blockchain data—balances, tokens, NFTs, contract metadata—via the Model Context Protocol (MCP) so that AI agents and tools (like Claude, Cursor, or IDEs) can access and analyze it contextually.

Key Features

Enhanced Analysis with Agent Skills

For more powerful blockchain analysis, install the Blockscout Analysis skill from the agent-skills repository. This skill provides AI agents with structured guidance for execution strategies, response handling, security best practices, and workflow orchestration.

See the agent-skills README for full capabilities and installation instructions.

Configuration

Authorization

Tools reach Blockscout data through the Blockscout PRO API. Therefore you must supply your own PRO API key in the Blockscout-MCP-Pro-Api-Key request header. The server also accepts the key in an x-api-key header for clients that can only send header names from a fixed list, such as Claude Custom Connectors.

  1. Obtain an API key: Register for a Blockscout PRO account at Blockscout Developer Portal, then generate an API key from your dashboard.
  2. Add your API key via HTTP headers:
    When making requests (either directly or via an AI agent), include your Blockscout PRO API key in the Blockscout-MCP-Pro-Api-Key header. If your client cannot set that name, use x-api-key instead; when both are present, Blockscout-MCP-Pro-Api-Key wins.
  3. Using with MCP clients:
    Some AI tools and MCP clients allow you to specify custom headers when adding a server connection. Paste your API key as described above.
  4. If no API key is configured: The server will default to a shared gateway key, which enforces stricter rate limits and may restrict access to certain chains or datasets.

Claude Setup

Common (Web, Desktop, Cowork)

The official hosted server gives you a native, managed installation experience with automatic updates. Add it as a Custom Connector with your own PRO API key:

  1. Go to Customize > Connectors (Team and Enterprise: an organization Owner uses Organization settings > Connectors) and click Add custom connector.
  2. Set the name to Blockscout and the URL to https://mcp.blockscout.com/mcp, then continue.
  3. Leave Authentication as None. A warning that the connector has no credentials is expected.
  4. Under Request headers, select x-api-key (exactly this name) and paste your PRO API key as the value, then click Add.

Note: The Request headers section is in beta. If your dialog does not show it, install the Blockscout connector from the Anthropic Connectors Directory instead. It uses a shared access key, so access and capabilities may be restricted.

Note: Authentication settings cannot be edited after a connector is added. To change the key, remove the connector and add it again.

Claude Code


    claude mcp add --transport http blockscout https://mcp.blockscout.com/mcp \
        --header "Blockscout-MCP-Pro-Api-Key: <YOUR_BLOCKSCOUT_PRO_API_KEY>"

ChatGPT Apps Setup

Install the Blockscout app from the ChatGPT Apps marketplace (or search for "Blockscout" in the Apps directory), then click "Connect" to enable it for your ChatGPT account.

Limitations: Access may be limited if using a shared PRO API key.

Codex Setup

App

  1. Open Codex and go to Settings > MCP Servers > Add server.
  2. Set Name to Blockscout, select the Streamable HTTP tab, and set URL to https://mcp.blockscout.com/mcp.
  3. Under Headers, add a header with key Blockscout-MCP-Pro-Api-Key and value <YOUR_BLOCKSCOUT_PRO_API_KEY>.
  4. Save and restart the Codex app.

CLI

Codex CLI cannot attach a custom header from the command line, so configure it in two steps:

  1. Scaffold the server entry:

    codex mcp add Blockscout --url https://mcp.blockscout.com/mcp

  2. Edit ~/.codex/config.toml to add the PRO API key header and enable the streamable-HTTP MCP client (required for remote MCP servers to connect). The resulting configuration should look like this:

    [features]
experimental_use_rmcp_client = true

[mcp_servers.Blockscout]
url = "https://mcp.blockscout.com/mcp"
http_headers = { "Blockscout-MCP-Pro-Api-Key" = "<YOUR_BLOCKSCOUT_PRO_API_KEY>" }

Cursor Setup

Add the server to your Cursor MCP configuration — either the project-level .cursor/mcp.json or the global ~/.cursor/mcp.json — supplying your PRO API key via the Blockscout-MCP-Pro-Api-Key header: 

{
  "mcpServers": {
    "blockscout": {
      "url": "https://mcp.blockscout.com/mcp",
      "timeout": 180000,
      "headers": {
        "Blockscout-MCP-Pro-Api-Key": "<YOUR_BLOCKSCOUT_PRO_API_KEY>"
      }
    }
  }
}

Available Endpoints

Available Tools (via MCP and REST API)

For more details, please refer to the project's GitHub repository.