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 Windsurf?
Windsurf's Cascade agent chains multiple Etherscan tool calls autonomously. query data, analyze results, and generate code in a single agentic session. Paste Vinkius Edge URL, reload, and all 19 tools are immediately available. Real-time tool feedback appears inline, so you see API responses directly in your editor.
- —
Windsurf's Cascade agent autonomously chains multiple tool calls in sequence, solving complex multi-step tasks without manual intervention
- —
Purpose-built for agentic workflows. Cascade understands context across your entire codebase and integrates MCP tools natively
- —
JSON-based configuration means zero code changes: paste a URL, reload, and all 19 tools are immediately available
- —
Real-time tool feedback is displayed inline, so you see API responses directly in your editor without switching contexts
Etherscan in Windsurf
Etherscan and 4,000+ other MCP servers. One platform. One governance layer.
Teams that connect Etherscan to Windsurf 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 Windsurf
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 Windsurf 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 Windsurf
Every tool call from Windsurf 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 Windsurf discover MCP tools?
Windsurf reads the mcp_config.json file on startup and connects to each configured server via Streamable HTTP. Tools are listed in the MCP panel and available to Cascade automatically.
Can Cascade chain multiple MCP tool calls?
Yes. Cascade is an agentic system. it can plan and execute multi-step workflows, calling several tools in sequence to accomplish complex tasks without manual prompting between steps.
Does Windsurf support multiple MCP servers?
Yes. Add as many servers as needed in mcp_config.json. Each server's tools appear in the MCP panel and Cascade can use tools from different servers in a single flow.
Server not connecting
Check Settings → MCP for the server status. Try toggling it off and on.
Explore More MCP Servers
View all →
Document Paginator Engine
1 toolsMathematically slice massive text blocks into token-safe chunks without ever truncating critical sentences.

General Motors
14 toolsAI connected car: control GM vehicles, check diagnostics, and track location via agents.

Hub Planner
10 toolsManage resources, projects, and bookings via Hub Planner API.

Sender.net
11 toolsSend email and SMS campaigns that convert with an affordable marketing platform built for e-commerce and small businesses.
