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 Pydantic AI?
Pydantic AI validates every Etherscan tool response against typed schemas, catching data inconsistencies at build time. Connect 19 tools through Vinkius and switch between OpenAI, Anthropic, or Gemini without changing your integration code. full type safety, structured output guarantees, and dependency injection for testable agents.
- —
Full type safety: every MCP tool response is validated against Pydantic models, catching data inconsistencies before they reach your application
- —
Model-agnostic architecture. switch between OpenAI, Anthropic, or Gemini without changing your Etherscan integration code
- —
Structured output guarantee: Pydantic AI ensures tool results conform to defined schemas, eliminating runtime type errors
- —
Dependency injection system cleanly separates your Etherscan connection logic from agent behavior for testable, maintainable code
Etherscan in Pydantic AI
Etherscan and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Etherscan to Pydantic AI 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 Pydantic AI
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 Pydantic AI 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 Pydantic AI
Every tool call from Pydantic AI 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 Pydantic AI discover MCP tools?
Create an MCPServerHTTP instance with the server URL. Pydantic AI connects, discovers all tools, and generates typed Python interfaces automatically.
Does Pydantic AI validate MCP tool responses?
Yes. When you define result types as Pydantic models, every tool response is validated against the schema. Invalid data raises a clear error instead of silently corrupting your pipeline.
Can I switch LLM providers without changing MCP code?
Absolutely. Pydantic AI abstracts the model layer. your Etherscan MCP integration works identically with OpenAI, Anthropic, Google, or any supported provider.
MCPServerHTTP not found
Update: pip install --upgrade pydantic-ai
Explore More MCP Servers
View all →
BrasilAPI
6 toolsAccess Brazilian institutional data — audit CEP, CNPJ, and banks via AI.

EBI InterPro
16 toolsClassify protein sequences into families, predict functional domains, and explore evolutionary relationships across species.

Shopline
7 toolsEquip your AI agent to autonomously manage your Shopline store. Audit products, track order fulfillment, fetch customer profiles, and monitor store collections seamlessly.

Plecto
11 toolsAutomate KPI dashboards and data tracking via Plecto — manage registrations, dashboards, and teams directly from any AI agent.
