Etherscan

io.etherscanPublished by etherscan.ioOfficial publisherv2.3.0Updated Oct 25, 2026

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

VerifiedStreamable HTTPWeb executableDatabasesFinance

Overview

AI-generated overview

Read-only Etherscan V2 blockchain data server that lets an assistant look up Ethereum balances, transactions, token transfers, contracts, logs and gas prices.

What you can do
Look up native coin balances and ENS names for addresses, resolving mainnet names to addresses (offchain wildcard names unsupported). Retrieve normal and internal transactions, full transaction objects, receipts, receipt status and contract execution status by hash. List ERC-20, ERC-721 and ERC-1155 token transfers, optionally filtered by contract. Fetch verified contract source code, ABI, and creator address and creation transaction for up to five contracts. Search event logs by address and topics over a block range, and get gas price recommendations or the block closest to a Unix timestamp. List supported chains and render explorer-style cards of facts already returned by the data tools.
When to use it
Useful when an assistant needs to answer questions about Ethereum on-chain activity: checking an address's balance or history, inspecting a transaction, verifying a contract's source or ABI, tracing token transfers, or reading event logs. It is read-only, so it suits investigation and reporting rather than sending transactions.
Requirements
A remote streamable HTTP endpoint; no local package. An Etherscan API key is required, sent as an Authorization header in the form Bearer followed by the key; a free key can be created on the Etherscan site. Network access to the hosted endpoint is needed.
Before you install
The API key is a secret passed in the Authorization header, so keep it out of logs and shared configuration. All tools are read-only lookups, but queries reveal which addresses and contracts you are investigating to Etherscan. The hosted deployment returns a bundled chain-list snapshot that may lag the live list, and some data is limited (for example, post-Byzantium receipts only and mainnet-only ENS resolution).

Installation

In SourceWeft

  1. Open Etherscan in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.etherscan%2Fetherscan-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

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

Tools

17

get_native_balance

Get Native Balance

Get the native coin (e.g. ETH) balance of an address, in wei.

Parameterstagaddressrequiredchainid

get_transactions

Get Transactions

Get the list of normal (external) transactions for an address.

Parameterspagesortoffsetaddressrequiredchainidendblockstartblock

get_internal_transactions

Get Internal Transactions

Get internal transactions for an address, or by a specific parent transaction hash.

Parameterspagesortoffsettxhashaddresschainidendblockstartblock

get_token_transfers

Get Token Transfers

Get token transfer events for an address, optionally filtered by token contract. Select the token standard: erc20 (fungible, default), erc721 (NFT), or erc1155 (multi-token).

Parameterspagesortoffsetaddresschainidendblockstandardstartblockcontractaddress

resolve_ens_name

Resolve Ens Name

Resolve an ENS name (or onchain subdomain, e.g. etherscan.eth or gm.etherscan.eth) to its Ethereum address. Ethereum mainnet only. Offchain names that require CCIP Read / wildcard resolution (e.g. *.base.eth) are not supported.

Parametersnamerequired

get_contract_source

Get Contract Source

Get the verified source code and metadata for a contract address.

Parametersaddressrequiredchainid

get_contract_abi

Get Contract Abi

Get the verified ABI (JSON) for a contract address.

Parametersaddressrequiredchainid

get_contract_creation

Get Contract Creation

Get 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.

Parameterschainidcontractaddressesrequiredinclude_creation_bytecode

get_transaction_receipt_status

Get Transaction Receipt Status

Get the receipt status of a transaction (1 = success, 0 = failed). Post-Byzantium only.

Parameterstxhashrequiredchainid

get_transaction_status

Get Transaction Status

Get the contract execution status of a transaction (detects failed/erroring executions).

Parameterstxhashrequiredchainid

get_gas_oracle

Get Gas Oracle

Get current gas price recommendations (safe / propose / fast) from the gas tracker.

Parameterschainid

get_block_by_timestamp

Get Block By Timestamp

Get the block number closest to a given Unix timestamp (seconds).

Parameterschainidclosesttimestamprequired

get_supported_chains

Get Supported Chains

Get 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.

Takes no parameters.

get_logs

Get Logs

Search 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.

Parameterspageoffsettopic0topic1topic2topic3addresschainidtoblockfromblocktopic0_1_oprtopic1_2_opr+1 more

get_transaction_by_hash

Get Transaction By Hash

Get 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.

Parameterstxhashrequiredchainid

get_transaction_receipt

Get Transaction Receipt

Get 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.

Parameterstxhashrequiredchainid

render_etherscan_widget

Show Etherscan Result

Present 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.

ParametersviewrequiredchainchartitemstitlerequiredfootermetricssectionssubtitleexplorerUrl

Version history

1
  1. v2.3.0LatestSep 16, 2026

Score

83% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts

    Declare a GitHub repository with a README, or serve resource_documentation in the OAuth protected-resource metadata.

  • LicenseNot applicable

    A hosted service is used under its provider's terms, so no license is expected here. This check is left out of the percentage.

Other Etherscan integrations

Etherscan Mcp

Published by GitHub account mrfentmen

Local MCP server that lets an assistant query the Etherscan v2 API for Ethereum balances, transactions and ERC-20 transfers.

STDIODesktop only
FinanceNot validated yetOct 26, 2026

Etherscan

Published by GitHub account pipeworx-io

Etherscan's hosted MCP server; no sign-in required; Streamable HTTP; 49 tools.

Streamable HTTPWeb executable
Finance49 toolsNov 3, 2026

Etherscan Api Mcp

Published by GitHub account junct-bot

A hosted MCP server exposing 71 Etherscan tools so an assistant can query blockchain data, metrics and on-chain analytics without an API key.

Streamable HTTPWeb executable
FinanceNot indexed yetOct 24, 2026

Etherscan Mcp Server

Published by GitHub account friendlygeorge

A local MCP server that gives an assistant read-only access to Etherscan's Ethereum data: balances, transactions, token transfers, contract ABIs and gas prices.

STDIODesktop only
FinanceNot validated yetOct 24, 2026