Compatible with every major AI agent and IDE
What is the Etherscan MCP Server?
Connect your Etherscan API key to any AI agent and gain instant access to on-chain data across Ethereum and other EVM-compatible networks through natural conversation.
What you can do
- Native Balances — Retrieve the native token balance (ETH, MATIC, etc.) for single or multiple addresses (up to 20) using
get_balanceandget_balance_multi. - Transaction History — Fetch comprehensive lists of normal and internal transactions for any wallet address with
get_tx_listandget_tx_list_internal. - Token Tracking — Monitor transfers for ERC-20, ERC-721 (NFTs), and ERC-1155 tokens using specialized tools like
get_token_txandget_token_nft_tx. - Multi-Chain Support — Query data across different networks by specifying the
chainid(e.g., 1 for Ethereum, 137 for Polygon). - Granular Filtering — Filter transaction results by block range, pagination, and sort order to find exactly what you need.
How it works
- Subscribe to this server
- Enter your Etherscan API Key
- Start auditing wallets and tracking transfers from Claude, Cursor, or any MCP-compatible client
Who is this for?
- Web3 Developers — Debug smart contract interactions and verify transaction statuses directly from your IDE.
- Crypto Analysts — Track whale movements, token distributions, and wallet activity without manual block explorer searches.
- DeFi Users — Monitor your portfolio balances and transaction history through a simple chat interface.
Built-in capabilities (19)
Get Contract ABI
Get address name tag (PRO Plus)
Get address portfolio (PRO)
Get native token balance for an address
Get native token balances for multiple addresses
Get block number by timestamp
Get latest block number
Get Ether last price
Get total supply of Ether
Get Gas Oracle
Get event logs
Get Contract Source Code
Get ERC-1155 token transfers for an address
Get ERC-721 token transfers for an address
Get ERC-20 token transfers for an address
Get transaction by hash
Max 10,000 records. Get normal transactions for an address
Get internal transactions for an address
Verify Contract Source Code
Why OpenAI Agents SDK?
The OpenAI Agents SDK auto-discovers all 19 tools from Etherscan through native MCP integration. Build agents with built-in guardrails, tracing, and handoff patterns. chain multiple agents where one queries Etherscan, another analyzes results, and a third generates reports, all orchestrated through Vinkius.
- —
Native MCP integration via
MCPServerSse, pass the URL and the SDK auto-discovers all tools with full type safety - —
Built-in guardrails, tracing, and handoff patterns let you build production-grade agents without reinventing safety infrastructure
- —
Lightweight and composable: chain multiple agents and MCP servers in a single pipeline with minimal boilerplate
- —
First-party OpenAI support ensures optimal compatibility with GPT models for tool calling and structured output
Etherscan in OpenAI Agents SDK
Etherscan and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Etherscan to OpenAI Agents SDK through Vinkius don't need to source, host, or maintain individual MCP servers. Every tool call runs inside a hardened runtime with credential isolation, DLP, and a signed audit chain.
Raw MCP | Vinkius | |
|---|---|---|
| Server catalog | Find and host yourself | 4,000+ managed |
| Infrastructure | Self-hosted | Sandboxed V8 isolates |
| Credential handling | Plaintext in config | Vault + runtime injection |
| Data loss prevention | None | Configurable DLP policies |
| Kill switch | None | Global instant shutdown |
| Financial circuit breakers | None | Per-server limits + alerts |
| Audit trail | None | Ed25519 signed logs |
| SIEM log streaming | None | Splunk, Datadog, Webhook |
| Honeytokens | None | Canary alerts on leak |
| Custom domains | Not applicable | DNS challenge verified |
| GDPR compliance | Manual effort | Automated purge + export |
Why teams choose Vinkius for Etherscan in OpenAI Agents SDK
The Etherscan MCP Server runs on Vinkius-managed infrastructure inside AWS — a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts. All 19 tools execute in hardened sandboxes optimized for native MCP execution.
Your AI agents in OpenAI Agents SDK only access the data you authorize, with DLP that blocks sensitive information from ever reaching the model, kill switch for instant shutdown, and up to 60% token savings. Enterprise-grade infrastructure, zero maintenance.

* Every MCP server runs on Vinkius-managed infrastructure inside AWS - a purpose-built runtime with per-request V8 isolates, Ed25519 signed audit chains, and sub-40ms cold starts optimized for native MCP execution. See our infrastructure
How Vinkius secures
Etherscan for OpenAI Agents SDK
Every tool call from OpenAI Agents SDK to the Etherscan MCP Server is protected by DLP redaction, cryptographic audit chains, V8 sandbox isolation, kill switch, and financial circuit breakers.
Frequently asked questions
How can I check the balance of multiple Ethereum addresses at once?
You can use the get_balance_multi tool. Provide the chainid (e.g., 1 for Ethereum) and a comma-separated list of up to 20 addresses to retrieve all balances in a single request.
Can I track NFT transfers for a specific wallet?
Yes! Use the get_token_nft_tx tool. By providing the wallet address and the appropriate chainid, the agent will list ERC-721 transfer events associated with that account.
Does this support networks other than Ethereum Mainnet?
Yes, as long as you use the correct chainid. For example, use 1 for Ethereum, 137 for Polygon, or 10 for Optimism, provided your API key has access to those Etherscan-equivalent explorers.
How does the OpenAI Agents SDK connect to MCP?
Use MCPServerSse(url=...) to create a server connection. The SDK auto-discovers all tools and makes them available to your agent with full type information.
Can I use multiple MCP servers in one agent?
Yes. Pass a list of MCPServerSse instances to the agent constructor. The agent can use tools from all connected servers within a single run.
Does the SDK support streaming responses?
Yes. The SDK supports SSE and Streamable HTTP transports, both of which work natively with Vinkius.
MCPServerStreamableHttp not found
Ensure you have the latest version: pip install --upgrade openai-agents
Agent not calling tools
Make sure your prompt explicitly references the task the tools can help with.
Explore More MCP Servers
View all →
IP Address Parser
1 toolsValidate, parse, and classify any IPv4 or IPv6 address. Detect private vs public ranges, parse CIDR notation, and convert between IPv4 and IPv6. Powered by ipaddr.js — the engine behind Express.js.

Trimble
10 toolsEquip your AI agent with enterprise-grade truck routing, commercial geocoding, and advanced toll cost logistics algorithms.

AeroAPI (FlightAware)
5 toolsTrack global flights — audit departures, arrivals, and airports via IA.

Foodpanda
13 toolsAutomate food delivery operations via Foodpanda — manage vendor catalogs, track orders, and control restaurant status directly from any AI agent.
