blockscout-mcp-server

blockscout-mcp-server

0
developer_toolsblockchain

This project implements a Model Context Protocol server for the Blockscout API. It offers an interface allowing AI models to seamlessly interact with Blockscout API endpoints and supports a wide range of functionalities, including accessing block and transaction information.

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
  1. Install dependencies:
npm install
  1. Build the project:
npm run build
  1. 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:

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