Etherscan

@pipeworx/etherscan

Etherscan V2 MCP — 多链（50+ 个 EVM 链）区块浏览器访问。

属于 Pipeworx — 一个将 AI Agent 连接到 1879+ 个实时数据源的 MCP 网关。这是一个独立的非官方集成，与上游提供方无关联、未获其背书，也未由其发布。

工具

• get_balance(address, chain?) — 原生代币余额。
• get_token_balance(address, contract_address, chain?) — ERC-20 余额。
• list_transactions(address, type?, chain?, ...) — 普通 / 内部 / erc20 / erc721 / erc1155。
• get_contract_abi(address, chain?) — 已验证的 ABI。
• get_contract_source(address, chain?) — 已验证的源代码 + 元数据。

身份验证

采用自带密钥（BYO）的方案已最终确定（Bruce，2026-10-07，fleet #2690）。 Etherscan 于 2026-10-01 更改了条款：Free/Lite/Standard 套餐仅供个人和研究用途；商业用途（由企业运营或代表企业运营的应用，而 Pipeworx 就属于此类）需要 Advanced 套餐（每月 $299 或更高）。Pipeworx 的平台密钥属于 Free 层级，不符合这些条款；对于此工具包每天约 6 次调用的用量，也不值得支付每月 $299。平台密钥不再提供；不带密钥的调用会拒绝请求，并提示“requires an API key”，同时指向注册页面。

• 自带密钥（BYO）： 在 https://etherscan.io/apis 注册后使用 ?_apiKey=<key>（免费额度为每天 100k 次调用、每秒 5 个请求）——使用调用者自己的密钥和套餐层级，条款责任也由调用者承担。

数据源

https://api.etherscan.io/v2/api — 使用 chainid 参数，一个密钥即可用于所有受支持的链。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "etherscan": {
      "url": "https://gateway.pipeworx.io/etherscan/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/etherscan/mcp 上的 tools/list 会返回上表中的工具，以及 Pipeworx 的共享元工具——ask_pipeworx、discover_tools、search_within、remember/recall 和网关级别的其他工具。因此，你看到的工具数量会多于本表所列：目前，单工具包端点除了工具包自身的工具外，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是了解具体某一天情况的权威依据。

这是有意为之，并非意外的多路复用。元工具可以让限定范围的连接回答本工具包未涵盖的问题——通过 ask_pipeworx 在整个目录中进行路由——无需你再添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构定义所占用的上下文比路由功能带来的价值更大，请连接一次完整网关，而不是连接多个工具包端点。

或者连接完整的 Pipeworx 网关，直接获取所有工具包列出的工具，而不仅是此工具包的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1879+ 个数据源。直接列出的工具所属工具包不同，这是唯一的区别；从任一端点都可以通过 ask_pipeworx 访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

curl -X POST https://gateway.pipeworx.io/v1/tools/etherscan_get_balance \
  -H 'Content-Type: application/json' \
  -d '{"address":"0x1234567890123456789012345678901234567890"}'

首次调用无需账户。检查任意工具：GET https://gateway.pipeworx.io/v1/tools/etherscan_get_balance。查找工具：使用 {"query":"..."} 向 https://gateway.pipeworx.io/v1/tools/search_packs 发送 POST 请求。

独立运行（无需网关账户）

此软件包也可作为本地 stdio MCP 服务运行——无需 Pipeworx 账户，也无需经由网关往返：

{
  "mcpServers": {
    "etherscan": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-etherscan"]
    }
  }
}

或者直接运行，以确认它能够启动：

npx -y @pipeworx/mcp-etherscan

它通过 stdin/stdout 使用 MCP，并为仅此工具包的工具响应 initialize/tools/list/tools/call——不包含上述网关连接所添加的任何共享元工具。相同的源代码、相同的工具，但没有 ask_pipeworx 路由功能。

与 ask_pipeworx 搭配使用

你也可以用通俗英语提问，而不是直接调用工具——此方式既适用于上面的工具包端点，也适用于完整网关：

ask_pipeworx({ question: "your question about Etherscan data" })

网关会选择合适的工具并自动填入参数。

更多信息

• 文档与指南
• pipeworx.io

许可证

MIT