protogrid

Search / io.etherscan/etherscan-mcp

Etherscan

R0· no sign-in

Read-only Etherscan V2 blockchain data: balances, transactions, transfers, tokens, contracts, logs.

v2.3.0 · active · website · descriptor JSON · versions

An agent can connect right now, no human step.Remote endpoint, no authentication, reachable on the last probe.
Quality91strong
Trust80of 100
Uptime, 30 days100%
Latency p50230 ms

Connect

8 clients · secrets stay placeholders
{
  "mcpServers": {
    "etherscan-mcp": {
      "type": "http",
      "url": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}
claude mcp add --transport http etherscan-mcp https://mcp-keyless.etherscan.io/mcp
[mcp_servers.etherscan-mcp]
url = "https://mcp-keyless.etherscan.io/mcp"
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "etherscan-mcp": {
      "type": "remote",
      "url": "https://mcp-keyless.etherscan.io/mcp",
      "enabled": true
    }
  }
}
{
  "mcpServers": {
    "etherscan-mcp": {
      "type": "http",
      "url": "https://mcp-keyless.etherscan.io/mcp"
    }
  },
  "deeplink": "cursor://anysphere.cursor-deeplink/mcp/install?name=etherscan-mcp&config=eyJ0eXBlIjoiaHR0cCIsInVybCI6Imh0dHBzOi8vbWNwLWtleWxlc3MuZXRoZXJzY2FuLmlvL21jcCJ9"
}
{
  "servers": {
    "etherscan-mcp": {
      "type": "http",
      "url": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}
{
  "mcpServers": {
    "etherscan-mcp": {
      "httpUrl": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}
extensions:
  "etherscan-mcp":
    enabled: true
    name: "etherscan-mcp"
    type: streamable_http
    uri: "https://mcp-keyless.etherscan.io/mcp"
    timeout: 300

Quality 91 / 100strong

protocol75 · weight 25
  • warn
    protocol.modernnewest supported version is 2025-11-25; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
  • n/a
    protocol.statelessonly applies to 2026-07-28 servers
  • pass
    protocol.transportstreamable HTTP
  • n/a
    protocol.list_ttlonly applies to 2026-07-28 servers
authorizationn/a · weight 15
  • n/a
    auth.prm, auth.as_metadata, auth.cimdno remote uses OAuth
  • n/a
    auth.secret_in_urlno templated URL
tool hygiene100 · weight 30
  • pass
    tools.descriptionsevery tool has a description
  • pass
    tools.description_lengthdescriptions are concise
  • pass
    tools.schemasevery tool has an object input schema
  • pass
    tools.annotations16 of 16 tools declare readOnlyHint or destructiveHint
  • pass
    tools.directory_hintsevery tool declares readOnlyHint, destructiveHint, idempotentHint and openWorldHint
  • pass
    tools.token_costabout 3,822 tokens to load every tool
  • pass
    tools.api_dumptools are not a one-to-one API dump
stability100 · weight 15
  • pass
    stability.changes3 tool changes in 30 days
  • pass
    stability.rug_pullno tool changed its meaning under the same name
dependenciesn/a · weight 15
  • n/a
    deps.known_vulns, deps.mcp_sdk_version, deps.resolvableno npm or PyPI package

16 tools, about 3,822 tokens to load them all · tool set 9e5b61ade8ac · tools last changed 2026-10-12 · checked 2026-10-20 09:31 UTC

Tool changes

  • get_token_transferschangedinput schema
  • get_internal_transactionschangedinput schema
  • get_transactionschangedinput schema

Full history: list_changes · trend: quality JSON.

Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed. How it is computed.

Trust 80 / 100

no-repository
provenance55
liveness100
freshness85
hygiene80

+dns-namespace +website +reachable +uptime-100% ~updated-46d-ago -no-repository

Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed. How it is computed.

Endpoints

remoteauthreachableuptime 30dp50protocollast ok
https://mcp-keyless.etherscan.io/mcp streamable-httpnoneyes100%230 ms2025-11-252026-10-20
https://mcp.etherscan.io/mcp streamable-httpapi_key ${ETHERSCAN_MCP_TOKEN}yes100%235 ms–2026-10-20

Tools (16)

get_block_by_timestampread-onlyGet the block number closest to a given Unix timestamp (seconds).
get_contract_abiread-onlyGet the verified ABI (JSON) for a contract address.
get_contract_creationread-onlyGet the creator address and creation transaction hash for up to 5 contract addresses. The multi-kilobyte creation bytecode is omitted by default to keep responses small; set include_creation_bytecode=true to include it.
get_contract_sourceread-onlyGet the verified source code and metadata for a contract address.
get_gas_oracleread-onlyGet current gas price recommendations (safe / propose / fast) from the gas tracker.
get_internal_transactionsread-onlyGet internal transactions for an address, or by a specific parent transaction hash.
get_logsread-onlySearch event logs by contract address and/or topics over a block range. Topics are 32-byte hex values; topic0 is usually the keccak256 event-signature hash. Adjacent-topic operators (and/or) combine multiple topic filters. Provide 'address' and/or at least one topic.
get_native_balanceread-onlyGet the native coin (e.g. ETH) balance of an address, in wei.
get_supported_chainsread-onlyGet the chains / chain IDs supported by the Etherscan V2 API. In the hosted (proxy) deployment this returns a bundled snapshot shipped with the server, refreshed when the package is updated; in direct/stdio mode it queries the live chain-list endpoint. A chain's absence from the returned list is not proof that it lacks live support.
get_token_transfersread-onlyGet token transfer events for an address, optionally filtered by token contract. Select the token standard: erc20 (fungible, default), erc721 (NFT), or erc1155 (multi-token).
get_transaction_by_hashread-onlyGet the full transaction object for a transaction hash (from, to, value, input data, gas, gas price, nonce, block number/hash, transaction index). Returns null if the hash is unknown.
get_transaction_receiptread-onlyGet the transaction receipt for a transaction hash (execution status, gas used, cumulative gas used, effective gas price, logs, and the created contract address for deployments). Returns null if the hash is unknown or the transaction is still pending.
get_transaction_receipt_statusread-onlyGet the receipt status of a transaction (1 = success, 0 = failed). Post-Byzantium only.
get_transactionsread-onlyGet the list of normal (external) transactions for an address.
get_transaction_statusread-onlyGet the contract execution status of a transaction (detects failed/erroring executions).
render_etherscan_widgetread-onlyPresent exact facts returned by Etherscan data tools in a fast explorer-style card. Call the relevant Etherscan data tool first and copy only supported values into this tool. Never invent scores, risk labels, historical prices, forecasts, or audit conclusions.

Schemas: list_tools.

Similar MCP servers

Official server.json
{
  "name": "io.etherscan/etherscan-mcp",
  "title": "Etherscan",
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
  "remotes": [
    {
      "url": "https://mcp-keyless.etherscan.io/mcp",
      "type": "streamable-http"
    },
    {
      "url": "https://mcp.etherscan.io/mcp",
      "type": "streamable-http",
      "headers": [
        {
          "name": "Authorization",
          "isSecret": true,
          "isRequired": true,
          "description": "Bearer <ETHERSCAN_API_KEY>. Create a free key at https://etherscan.io/apis."
        }
      ]
    }
  ],
  "version": "2.3.0",
  "websiteUrl": "https://docs.etherscan.io/build-with-ai/mcp",
  "description": "Read-only Etherscan V2 blockchain data: balances, transactions, transfers, tokens, contracts, logs."
}