Back to Home
blockscout icon

mcp-server

Verified Safe

by blockscout

Overview

Provides AI agents and development tools with contextual, curated access to blockchain data (balances, tokens, NFTs, contract metadata, transactions, logs) across multiple EVM-compatible chains via Blockscout APIs.

Installation

Run Command
docker run --rm -p 8000:8000 ghcr.io/blockscout/mcp-server:latest python -m blockscout_mcp_server --http --rest --http-host 0.0.0.0

Environment Variables

  • BLOCKSCOUT_BS_API_KEY
  • BLOCKSCOUT_DISABLE_COMMUNITY_TELEMETRY
  • BLOCKSCOUT_MCP_TRANSPORT
  • PORT
  • BLOCKSCOUT_MIXPANEL_TOKEN
  • BLOCKSCOUT_DIRECT_API_RESPONSE_SIZE_LIMIT

Security Notes

The server is designed as a wrapper for external Blockscout APIs. It implements several safety measures: no direct 'eval()' or obfuscation found; external API calls include timeouts and retries; API keys are expected via environment variables ('BLOCKSCOUT_BS_API_KEY'), preventing hardcoding. The 'direct_api_call' tool provides access to a curated list of Blockscout endpoints, not arbitrary URLs, mitigating SSRF risks, and enforces a response size limit for AI clients (with an explicit bypass header for REST clients). 'read_contract' uses web3.py for read-only 'eth_call' operations with input validation. Anonymous telemetry data (tool name, args, client info, IP for geolocation) is collected by default but offers an opt-out. No personal data, secrets, or private keys are collected. Overall, the design shows a proactive approach to security in an external API integration context.

Similar Servers

Stats

Interest Score41
Security Score9
Cost ClassMedium
Avg Tokens750
Stars24
Forks16
Last Update2026-01-17

Tags

blockchainweb3evmblockscoutmulti-chaindata-analysissmart-contractsnftstokens