Etherscan

io.etherscan由 etherscan.io 发布官方发布者v2.3.0更新于 Oct 25, 2026

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

已验证Streamable HTTP可网页运行数据库金融

服务详情

标识符: io.etherscan/etherscan-mcp
传输: Streamable HTTP
运行时: Web executable
信任: Verified
发布于: Sep 16, 2026

安全提示

MCP 服务会接收对话中的工具调用请求，并可能执行外部操作。启用前请先了解该服务能做什么，并只授予它所需的权限。

注册中心已验证此服务的命名空间属于 etherscan.io，且该域名同时运行其端点。这可以确认发布者，但并不代表该服务的工具是安全的。

SourceWeft 的检查只涵盖条目是否完整、端点是否响应；不审查服务器的代码，也不审查其工具的行为。

在 README 中添加徽章

向读者展示该 MCP 服务已收录于 SourceWeft，徽章链接到本页。

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.etherscan%2Fetherscan-mcp.svg)](https://sourceweft.com/mcp/io.etherscan%2Fetherscan-mcp?utm_source=readme&utm_medium=badge)

概览

AI 生成的概览

只读的 Etherscan V2 区块链数据服务器，让助手查询以太坊余额、交易、代币转账、合约、日志和 Gas 价格。

可以做什么: 查询地址的原生代币余额和 ENS 名称，将以太坊主网名称解析为地址（不支持链下通配符名称）。按哈希获取普通交易、内部交易、完整交易对象、交易回执、回执状态和合约执行状态。列出 ERC-20、ERC-721 和 ERC-1155 代币转账，可按合约筛选。获取已验证合约的源代码、ABI，以及最多五个合约的创建者地址和创建交易。按地址和主题在区块范围内搜索事件日志，获取 Gas 价格建议或最接近某个 Unix 时间戳的区块。列出支持的链，并将数据工具已返回的事实渲染成浏览器风格的卡片。
适用场景: 适合助手需要回答以太坊链上活动问题时使用：查看地址余额或历史、检查某笔交易、核实合约源代码或 ABI、追踪代币转账或读取事件日志。它只读，适合调查和报告，不适合发送交易。
运行要求: 远程 streamable HTTP 端点，无需本地安装包。需要 Etherscan API 密钥，通过 Authorization 请求头以 Bearer 加密钥的形式发送；可在 Etherscan 网站创建免费密钥。需要能访问托管端点的网络。

安装前请注意

API 密钥是放在 Authorization 请求头中的机密，应避免出现在日志和共享配置中。所有工具都是只读查询，但查询会向 Etherscan 暴露你正在调查的地址和合约。托管部署返回随包附带的链列表快照，可能落后于实时列表；部分数据有限制，例如仅支持拜占庭之后的回执，ENS 解析仅限主网。

安装

在 SourceWeft 中

打开控制台中的 Etherscan，将其添加到工作区。
为需要使用其工具的对话启用该服务。

Web executable，通过 Streamable HTTP。远程服务在工作区中配置后即可从网页运行时运行。

交给智能体安装

把这段提示词粘贴到 Claude Code、Codex、Cursor 等智能体，或 SourceWeft 对话中。智能体会读取该服务器的安装指南，先向你展示发布者、端点和登录方式，经你同意后再把它添加到你的客户端。密钥不会写进任何命令。

阅读 https://sourceweft.com/mcp/io.etherscan%2Fetherscan-mcp/install.md，并按其中说明把这个 MCP 服务器接入我的客户端。修改任何配置之前，先告诉我它的发布者、端点和登录方式，等我确认。不要把 API 密钥写进命令或我会提交的文件；问我密钥应从哪里获取。

查看智能体所依据的安装指南

其他 MCP 客户端

把它添加到你客户端的 mcpServers 配置中。

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

工具

get_native_balance

Get Native Balance

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

输入参数tagaddress必填chainid

get_transactions

Get Transactions

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

输入参数pagesortoffsetaddress必填chainidendblockstartblock

get_internal_transactions

Get Internal Transactions

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

输入参数pagesortoffsettxhashaddresschainidendblockstartblock

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

输入参数pagesortoffsetaddresschainidendblockstandardstartblockcontractaddress

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.

输入参数name必填

get_contract_source

Get Contract Source

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

输入参数address必填chainid

get_contract_abi

Get Contract Abi

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

输入参数address必填chainid

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.

输入参数chainidcontractaddresses必填include_creation_bytecode

get_transaction_receipt_status

Get Transaction Receipt Status

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

输入参数txhash必填chainid

get_transaction_status

Get Transaction Status

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

输入参数txhash必填chainid

get_gas_oracle

Get Gas Oracle

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

输入参数chainid

get_block_by_timestamp

Get Block By Timestamp

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

输入参数chainidclosesttimestamp必填

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.

无需输入参数。

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.

输入参数pageoffsettopic0topic1topic2topic3addresschainidtoblockfromblocktopic0_1_oprtopic1_2_opr另有 1 个

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.

输入参数txhash必填chainid

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.

输入参数txhash必填chainid