Blockscout MCP Server

This is a Model Context Protocol (MCP) server implementation for interacting with the Blockscout API. It provides a standardized interface for AI models to interact with the Blockscout API.

Features

• Support for any Blockscout API endpoint

• Get current block number

• Check account balances

• Get transaction counts (nonces)

• Retrieve block information

• Get transaction details

• Make contract calls

Related MCP server: MCP Etherscan Server

Prerequisites

• Node.js (v16 or higher)

• npm (Node Package Manager)

Installation

1. Clone the repository:

git clone <repository-url>
cd blockscout-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Install globally:

npm install -g .

This global installation makes the blockscout-mcp command available system-wide, which is required for Cursor to find and execute the MCP server.

Configuration

The server uses the following environment variable:

• BLOCKSCOUT_API_URL: The Blockscout API endpoint URL to connect to (e.g., 'https://mainnet.game7.io/api' or 'https://testnet.game7.io/api')

Cursor MCP Configuration

Add the following to your mcp.json file in your Cursor (Settings > MCP > Add New Global Server):

{
  "mcpServers": {
    "blockscout-mcp": {
      "command": "npx",
      "args": ["-y", "blockscout-mcp"],
      "env": {
        "BLOCKSCOUT_API_URL": "YOUR_API_ENDPOINT"
      }
    }
  } 
}

This configuration will make the following tools available in Cursor:

• search

• get_transactions

• get_blocks

• get_token_transfers

• get_stats

• get_transaction_info

• get_transaction_token_transfers

• get_transaction_internal_txs

• get_transaction_logs

• get_block_info

• get_block_transactions

• get_address_info

• get_address_token_transfers

• get_token_info

• get_token_holders

• get_internal_transactions

• get_main_page_transactions

• get_main_page_blocks

• get_indexing_status

• get_transaction_chart

• get_market_chart

• get_transaction_raw_trace

• get_transaction_state_changes

• get_transaction_summary

• get_block_withdrawals

• get_address_counters

• get_address_internal_transactions

• get_address_logs

• get_address_blocks_validated

• get_address_coin_balance_history

• get_address_coin_balance_history_by_day

• get_smart_contracts

• get_smart_contract_counters

• get_smart_contract

• get_json_rpc_url

• get_account_abstraction_status

• get_addresses

• get_address_transactions

• get_address_token_balances

• get_address_tokens

• get_address_withdrawals

• get_address_nfts

• get_address_nft_collections

• get_tokens

• get_token_transfers_list

• get_token_counters

• get_token_instances

• get_token_instance_by_id

• get_token_instance_transfers

• get_token_instance_holders

• get_token_instance_transfers_count

• refetch_token_instance_metadata

• get_withdrawals

• search_redirect