Etherscan

About

Connects to the Etherscan V2 API for read-only onchain data. You can check native balances, list normal and internal transactions, fetch token transfers (ERC-20, ERC-721, ERC-1155), read verified contract source and ABI, search event logs, check transaction status and get gas price recommendations. A chainid parameter selects the chain.

The keyless endpoint at https://mcp-keyless.etherscan.io/mcp is hosted over Streamable HTTP and needs no sign-in or API key, with limited tools and its own rate limits. A second endpoint, https://mcp.etherscan.io/mcp, accepts your Etherscan API key in an Authorization header. The tools cannot sign or broadcast transactions or change state.

What you can do

• Check native coin balances for an address
• List normal and internal transactions
• Get ERC-20, ERC-721 and ERC-1155 token transfers
• Read verified contract source code and ABI
• Search event logs by address and topics
• Look up transaction status, receipt and details
• Get gas price recommendations
• Find the block closest to a timestamp

Tools 16

• get_native_balanceRead-only

  Get the native coin balance of an address, in wei.

• get_transactionsRead-only

  List normal (external) transactions for an address.

• get_internal_transactionsRead-only

  List internal transactions by address or parent transaction hash.

• get_token_transfersRead-only

  Get ERC-20, ERC-721 or ERC-1155 transfer events for an address.

• get_contract_sourceRead-only

  Get verified source code and metadata for a contract.

• get_contract_abiRead-only

  Get the verified ABI (JSON) for a contract.

• get_contract_creationRead-only

  Get creator address and creation transaction for up to 5 contracts.

• get_transaction_receipt_statusRead-only

  Get receipt status of a transaction (1 success, 0 failed).

• get_transaction_statusRead-only

  Get contract execution status of a transaction.

• get_gas_oracleRead-only

  Get safe, propose and fast gas price recommendations.

• get_block_by_timestampRead-only

  Get the block number closest to a Unix timestamp.

• get_supported_chainsRead-only

  List chains and chain IDs supported by the Etherscan V2 API.

Read from the live server on 3 Oct 2026. Read-only, Writes and Can delete are hints the server declares; your client decides whether to ask before running a tool.

Example prompts

• What is the ETH balance of vitalik.eth's address on Ethereum?

• Summarize this transaction: 0xa44757750f25d11d8d22434a68c39c6962a55ddf369ce202624950ada3080acf

• Show the latest ERC-20 transfers for this address on Arbitrum.

• What are the current gas price recommendations on Ethereum?

Set up

Every client connects to mcp-keyless.etherscan.io. Pick yours; the page remembers your choice.

claude mcp add --transport http etherscan https://mcp-keyless.etherscan.io/mcp

https://mcp-keyless.etherscan.io/mcp

{
  "mcpServers": {
    "etherscan": {
      "url": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}

code --add-mcp '{"name":"etherscan","type":"http","url":"https://mcp-keyless.etherscan.io/mcp"}'

{
  "servers": {
    "etherscan": {
      "type": "http",
      "url": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}

{
  "mcpServers": {
    "etherscan": {
      "serverUrl": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}

codex mcp add etherscan --url https://mcp-keyless.etherscan.io/mcp

[mcp_servers.etherscan]
url = "https://mcp-keyless.etherscan.io/mcp"

gemini mcp add --transport http etherscan https://mcp-keyless.etherscan.io/mcp

{
  "mcpServers": {
    "etherscan": {
      "type": "http",
      "url": "https://mcp-keyless.etherscan.io/mcp"
    }
  }
}

FAQ

Embed

Show Etherscan in a README or on your site. Each embed links to this page, uses the server’s own URL, and sets no cookies. How embeds work

README badge Website card iframe JSON

README badge

Markdown

[![Etherscan on mcp.tc](https://mcp.tc/i/etherscan/badge.svg)](https://mcp.tc/i/etherscan)

HTML

<a href="https://mcp.tc/i/etherscan"><img src="https://mcp.tc/i/etherscan/badge.svg" alt="Etherscan on mcp.tc" height="20"></a>

It follows the reader’s light or dark mode. Add ?theme=light or ?theme=dark to fix it, or ?style=compact to show the mark without the word.

Website card

HTML

<script src="https://mcp.tc/w/etherscan.js" async></script>

The card appears where the tag is. Add data-theme="dark" or data-size="compact" to the tag to change it. The file holds everything it needs, so it makes no other requests and sets no cookies.

iframe

HTML

<iframe src="https://mcp.tc/embed/etherscan" title="Etherscan on mcp.tc" width="420" height="200" loading="lazy" allow="clipboard-write" style="border:0;border-radius:8px;max-width:100%"></iframe>

Use it on pages that don’t allow scripts. Add ?theme=light or ?theme=dark to the address to fix the colors.

JSON

The listing as data for your own pages and tools: name, tagline, the server’s own URL, tools and the “Add to” links. Any site can read it (CORS is open).

https://mcp.tc/i/etherscan.json

What each field means