blockscout

This MCP server provides a standardized interface for AI models to interact with the Blockscout API. It exposes a comprehensive set of tools that cover core blockchain data access, including current block information, account balances, transaction counts (nonces), block and transaction details, and various contract-related queries. The available tools enable you to fetch blocks and transactions, query token transfers and token information, inspect smart contracts, obtain JSON-RPC URLs, and retrieve status and historical data across blocks, addresses, and tokens. The result set from these tools is designed to be consumed by AI agents for tasks such as auditing, analytics, or automated accounting against the Blockscout API.

To use the server, configure the MCP connection in Cursor (Settings > MCP > Add New Global Server) with the provided mcp.json snippet. After deployment, you’ll have access to a large suite of tools such as get_block_info, get_transaction_info, get_address_balances, get_token_holders, get_smart_contract, get_json_rpc_url, get_main_page_transactions, get_address_transactions, get_token_transfers, and many more. Each tool corresponds to a specific Blockscout API endpoint or a полезная aggregation of endpoints and can be invoked by your AI model to fetch data or verify on-chain state in a structured format.

Prerequisites:

• Node.js v16 or higher
• npm

Installation steps:

1. Clone the repository and navigate into it:

git clone <repository-url>
cd blockscout-mcp

2. Install dependencies:

npm install

3. Build the project:

npm run build

4. Install globally so the blockscout-mcp command is available system-wide:

npm install -g .

This global installation is required for Cursor to locate and execute the MCP server. Configuration can then be added to your mcp.json as shown below.

Tips and considerations:

• Ensure BLOCKSCOUT_API_URL is set to a valid Blockscout API endpoint (production or testnet).
• Use the -y flag with npx to install the MCP locally in the global context as shown.
• If you run into authentication or CORS issues, verify that the Blockscout API allows requests from your environment and that any required API keys are configured.
• The toolset includes a large number of endpoints; if you don’t need all of them, consider limiting exposure by adjusting the server settings or filtering tool usage in your client.
• When upgrading, rebuild and reinstall globally to ensure the latest changes are picked up by Cursor.