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

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