{"id":"wrldrelief-etherscan-mcp-server","name":"etherscan-mcp-server","homepage":null,"repo_url":"https://github.com/WrldRelief/etherscan-mcp-server","category":"api-gateway","subcategories":[],"tags":["mcp","etherscan","blockchain","go","api","tools"],"what_it_does":"Provides a Model Context Protocol (MCP) server (Go) that wraps the Etherscan API V2 to let LLM applications query multi-chain blockchain data such as balances, blocks, transactions, contract ABI/source, gas oracle, and token/NFT transfers.","use_cases":["Building LLM tools/agents that answer blockchain data questions from user prompts","Retrieving account balances, token balances, and recent transfers across many EVM-compatible chains","Fetching block/transaction details and transaction status/receipts","Looking up verified contract ABI and source code for on-chain addresses","Getting gas price oracle data and latest block number for network-aware agents"],"not_for":["Writing/creating transactions on-chain (it appears focused on read-only data retrieval and contract read methods)","Use cases requiring strong contractual guarantees (no SLA or uptime/release stability info provided)","Environments where API key exposure risk or weak logging practices cannot be reviewed"],"best_when":"When you want an MCP-compatible interface to Etherscan API data so an LLM agent can call structured tools to fetch blockchain information.","avoid_when":"When you need an audited, fully specified API contract for error codes, rate limits, pagination, and idempotency behavior, or when you require advanced security controls beyond an environment-provided API key.","alternatives":["Direct Etherscan API integration (REST) from your application using Etherscan API V2 endpoints","Other blockchain data providers with APIs/SDKs (e.g., Alchemy/Infura-style providers) if you need richer tooling or clearer operational guarantees","A different MCP server/provider that wraps a blockchain indexer with documented schemas and robust error handling"],"af_score":47.8,"security_score":39.2,"reliability_score":20.0,"package_type":"mcp_server","discovery_source":["github"],"priority":"low","status":"evaluated","version_evaluated":null,"last_evaluated":"2026-04-04T19:45:37.058510+00:00","interface":{"has_rest_api":false,"has_graphql":false,"has_grpc":false,"has_mcp_server":true,"mcp_server_url":null,"has_sdk":false,"sdk_languages":[],"openapi_spec_url":null,"webhooks":false},"auth":{"methods":["Etherscan API key via ETHERSCAN_API_KEY environment variable"],"oauth":false,"scopes":false,"notes":"Only an API key is mentioned. No OAuth, scopes, or per-tool authorization model is documented in the provided README."},"pricing":{"model":null,"free_tier_exists":false,"free_tier_limits":null,"paid_tiers":[],"requires_credit_card":false,"estimated_workload_costs":null,"notes":"Pricing is not described for the MCP server itself; it relies on Etherscan API usage. Costs depend on the Etherscan plan and request volume."},"requirements":{"requires_signup":false,"requires_credit_card":false,"domain_verification":false,"data_residency":[],"compliance":[],"min_contract":null},"agent_readiness":{"af_score":47.8,"security_score":39.2,"reliability_score":20.0,"mcp_server_quality":55.0,"documentation_accuracy":45.0,"error_message_quality":0.0,"error_message_notes":null,"auth_complexity":90.0,"rate_limit_clarity":10.0,"tls_enforcement":70.0,"auth_strength":25.0,"scope_granularity":10.0,"dependency_hygiene":40.0,"secret_handling":55.0,"security_notes":"The README indicates the server uses an Etherscan API key provided via environment variable, but does not document transport security for the SSE endpoint (only an example uses http://localhost). It also does not describe whether requests to the MCP server require authentication, how logs redact secrets, or how tool inputs are validated. Dependency/security hygiene and vulnerability posture cannot be confirmed from the provided content.","uptime_documented":0.0,"version_stability":30.0,"breaking_changes_history":30.0,"error_recovery":20.0,"idempotency_support":"false","idempotency_notes":"Reads are typically safe/idempotent, but idempotency guarantees are not documented.","pagination_style":"none","retry_guidance_documented":false,"known_agent_gotchas":["Etherscan rate limits and transient API failures may affect tool calls; README does not describe retry/backoff behavior.","Contract-related tools depend on verified contracts; unverified contracts may fail or return empty results (not documented).","SSE mode exposes an HTTP SSE endpoint; ensure network access and auth boundaries are appropriate (auth for the MCP server is not documented)."]}}