Etherscan MCP - Etherscan

The Etherscan MCP server connects AI agents to live onchain data across all 60+ supported chains, over MCP. Connect it to a client like Claude Desktop, Claude Code, or Codex, then ask in plain language and get answers grounded in real Etherscan API responses.

One connection covers every chain, just pass the chainid. Ask about Arbitrum and the agent uses chainid=42161. See Supported chains for the full list.

Get started

First, create a free API key if you do not have one. Then pick your client below and follow it end to end.

Claude Desktop
Claude Code CLI
Codex Desktop
Codex CLI

Claude Desktop is Anthropic’s desktop chat app.

Add Etherscan to your config

In Claude Desktop, open Settings > Developer > Edit Config to open the claude_desktop_config.json file.

Claude Desktop Settings > Developer, showing the Edit Config button

In the file that opens, add the etherscan server (replace YourApiKey with your key):

claude_desktop_config.json

{
  "mcpServers": {
    "etherscan": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.etherscan.io/mcp",
        "--header",
        "Authorization:${AUTH_TOKEN}"
      ],
      "env": {
        "AUTH_TOKEN": "Bearer YourApiKey"
      }
    }
  }
}

Requires Node.js.

Confirm it's connected

Save, then fully quit Claude Desktop and reopen it. Then open Settings > Developer and look for etherscan under Local MCP servers with a running badge.

Claude Desktop Settings > Developer showing the Etherscan MCP server with a running badge

Ask your first question

Ask in plain language and approve the tool calls when prompted:

Give me a one-liner summary for this transaction: 0xa44757750f25d11d8d22434a68c39c6962a55ddf369ce202624950ada3080acf

In this example, it calls two tools:

get_transaction_by_hash for the sender, recipient, amount, and input data
get_transaction_receipt to confirm the transaction succeeded

It then answers with a one-line summary. Both tools work on the free API plan.

Claude Desktop giving a one-line summary of a USDT transfer via the Etherscan MCP, then adding Etherscan name tags: Bitstamp 61 sent 269,618.78 USDT to a Bitget deposit address

To label the addresses involved with their Etherscan name tags, follow up with:

Add the Etherscan name tags and labels for the sender and recipient

This uses get_address_labels, a Pro tool that requires a paid plan.

Claude Code is Anthropic’s coding assistant that runs in your terminal.

Add the server

Run this in your terminal, replacing YourApiKey with your key:

claude mcp add --transport http etherscan \
  https://mcp.etherscan.io/mcp \
  --header "Authorization: Bearer YourApiKey"

Confirm it's connected

Check the server’s status and look for Status: ✔ Connected:

claude mcp get etherscan

Ask your first question

Start a Claude Code session by running claude, then ask in plain language and let the agent pick the tools:

Give me a one-liner summary for this transaction: 0xa44757750f25d11d8d22434a68c39c6962a55ddf369ce202624950ada3080acf

In this example, it calls the tool get_transaction_by_hash for the sender, recipient, amount, and input data. It then answers with a one-line summary. This tool works on the free API plan.

Claude Code giving a one-line summary of a USDT transfer via the Etherscan MCP

To label the addresses involved with their Etherscan name tags, follow up with:

Add the Etherscan name tags and labels for the sender and recipient

This uses get_address_labels, a Pro tool that requires a paid plan.

Codex Desktop is the ChatGPT desktop app running OpenAI’s Codex agent, which can connect to MCP servers.

Add the server

In Codex Desktop, open Settings > Plugins > Add > Add MCP Server.

Codex Desktop Settings > Plugins showing the MCP servers list and the Add server button

Enter the following server details (replace YourApiKey with your key):

Name: Etherscan MCP
Type: Streamable HTTP
URL: https://mcp.etherscan.io/mcp
Headers: Key=AUTHORIZATION, Value=Bearer YourApiKey

Confirm it's connected

Save, then fully quit Codex Desktop and reopen it. Then run /mcp and confirm that etherscan is listed as an enabled server.

Codex Desktop showing the Etherscan MCP server enabled under Servers

Ask your first question

Ask in plain language:

Give me a one-liner summary for this transaction: 0xa44757750f25d11d8d22434a68c39c6962a55ddf369ce202624950ada3080acf. use mcp

In this example, it calls two tools:

get_transaction_by_hash for the sender, recipient, amount, and input data
get_transaction_receipt to confirm the transaction succeeded

It then answers with a one-line summary. Both tools work on the free API plan.

Codex Desktop giving a one-line summary of a USDT transfer via the Etherscan MCP

To label the addresses involved with their Etherscan name tags, follow up with:

Add the Etherscan name tags and labels for the sender and recipient

This uses get_address_labels, a Pro tool that requires a paid plan.

Codex CLI is OpenAI’s coding agent in your terminal.

Set your API key as an environment variable

Run this in your terminal (replace YourApiKey with your key):

export ETHERSCAN_API_KEY=YourApiKey

Add the server

Run this in your terminal:

codex mcp add etherscan \
  --url https://mcp.etherscan.io/mcp \
  --bearer-token-env-var ETHERSCAN_API_KEY

Confirm it's connected

Check the server and look for enabled: true:

codex mcp get etherscan

Ask your first question

Start a Codex session by running codex, then ask in plain language and let the agent pick the tools:

Give me a one-liner summary for this transaction: 0xa44757750f25d11d8d22434a68c39c6962a55ddf369ce202624950ada3080acf. use mcp

In this example, it calls two tools:

get_transaction_by_hash for the sender, recipient, amount, and input data
get_transaction_receipt to confirm the transaction succeeded

It then answers with a one-line summary. Both tools work on the free API plan.

Codex CLI giving a one-line summary of a USDT transfer via the Etherscan MCP

To label the addresses involved with their Etherscan name tags, follow up with:

Add the Etherscan name tags and labels for the sender and recipient

This uses get_address_labels, a Pro tool that requires a paid plan.

Example prompts

Ask in plain language and let the agent pick the tools. Copy one to try it:

Build a wallet snapshot for 0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045 on Ethereum and Arbitrum: native balance, top token holdings, and the 10 most recent transactions.

Is 0xdAC17F958D2ee523a2206206994597C13D831ec7 verified? Summarize what the contract does and who deployed it.

Who are the top 10 holders of USDT (0xdAC17F958D2ee523a2206206994597C13D831ec7), and what share does each hold?

Trace transaction 0x<hash>: show its internal transfers and whether it succeeded.

Resolve vitalik.eth, show its balance, and include any name tags or labels Etherscan has for it.

Tools

The server exposes 20 tools. The agent selects and calls them for you; you rarely name a tool yourself.

Category	Tool	Returns
Balances	`get_native_balance`	Native coin balance for an address
	`get_token_balances`	ERC-20 token holdings for an address, with USD values
Transactions	`get_transactions`	Normal (external) transactions an address signed
	`get_internal_transactions`	Contract-triggered internal transfers for an address
	`get_transaction_by_hash`	Full transaction details for a hash: sender, recipient, value, input, gas
	`get_transaction_receipt`	Receipt for a transaction: status, gas used, logs, and any created contract
	`get_transaction_status`	Contract execution status for a transaction
	`get_transaction_receipt_status`	Receipt status (success or fail) for a transaction
Transfers	`get_token_transfers`	Token transfers for an address or contract: ERC-20, ERC-721, or ERC-1155
Tokens	`get_token_info`	Project and metadata for a token contract
	`get_token_top_holders`	Largest holders of a token
Contracts	`get_contract_source`	Verified source code for a contract
	`get_contract_abi`	ABI for a verified contract
	`get_contract_creation`	Deployer address and creation transaction for a contract
Logs	`get_logs`	Event logs filtered by contract address and topics over a block range
Address intelligence	`get_address_labels`	Etherscan name tag, labels, and attributes for an address
	`get_funded_by`	The address and transaction that first funded an address
Network	`get_supported_chains`	Supported chains and their chain IDs
	`get_gas_oracle`	Current gas price recommendations
	`get_block_by_timestamp`	The block number at a given timestamp

Good to know

Read-only. Every tool reads public onchain data. Nothing signs or sends a transaction.
Every tool call uses your API quota. Each MCP tool call makes one or more Etherscan API requests, and every request counts toward your API plan’s rate limits, exactly like calling the API directly. See Rate limits.
Guard against prompt injection. Enable your client’s human-confirmation prompts, and be cautious when combining Etherscan with other MCP servers in the same session.

​Get started

​Example prompts

​Tools

​Good to know

Get started

Example prompts

Tools

Good to know