Etherscan MCP. Audit on-chain data across multiple EVM chains.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Etherscan gives your AI agent instant access to all on-chain data across Ethereum and other EVM networks. Check native token balances, pull transaction history for any wallet address, and track specific transfers for NFTs or ERC-20 tokens using natural conversation.
What your AI agents can do
Get abi
Retrieves the Application Binary Interface (ABI) needed to understand how a smart contract functions.
Get address tag
Fetches an associated name tag for a specific wallet address.
Get address token balance
Calculates the total portfolio value of tokens held by an address.
Get the native token balance for single or multiple wallet addresses across various chains.
Fetch a full list of both normal and internal transactions associated with any given address.
Isolate transfers for specific types of tokens, including ERC-20 standard tokens, NFTs (ERC-721), or multi-standard assets (ERC-1155).
Retrieve the contract's full source code and check for specific event logs generated during transactions.
Get basic network metrics, like the latest block number or the current ETH price, to give context to your audit.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Etherscan: 19 Tools for Blockchain Data Retrieval
These tools let you programmatically retrieve everything from contract ABI definitions to the full transaction history, allowing deep technical analysis of any EVM-compatible chain.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Etherscan on Vinkius019e3892get abi
Retrieves the Application Binary Interface (ABI) needed to understand how a smart contract functions.
019e3892get address tag
Fetches an associated name tag for a specific wallet address.
019e3892get address token balance
Calculates the total portfolio value of tokens held by an address.
019e3892get balance
Retrieves the native token balance (like ETH) for a single specified address.
019e3892get balance multi
Calculates the native token balances for up to 20 different addresses at once.
019e3892get block no by time
Determines the block number corresponding to a specific timestamp.
019e3892get block number
Gets the most recent block number on the network.
019e3892get eth price
Provides the current market price for Ether (ETH).
019e3892get eth supply
Returns the total circulating supply of Ether.
019e3892get gas oracle
Provides current estimated gas costs for network transactions.
019e3892get logs
Retrieves all event logs generated by a specific contract interaction.
019e3892get source code
Fetches the readable source code of a smart contract address.
019e3892get token 1155 tx
Tracks transfers for ERC-1155 multi-standard tokens associated with an address.
019e3892get token nft tx
Lists the transfer history specifically for non-fungible tokens (ERC-721) linked to an address.
019e3892get token tx
Retrieves all standard ERC-20 token transfers that occurred for an address.
019e3892get transaction by hash
Pulls all details, including status and gas used, using a specific transaction hash.
019e3892get tx list
Lists the most recent standard transactions for an address up to 10,000 records.
019e3892get tx list internal
Retrieves internal smart contract calls that occurred within a wallet's transaction history.
019e3892verify source code
Checks and confirms whether the deployed source code for a contract matches its verified state.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Etherscan, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Etherscan. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 19 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Figuring out where money actually went used to mean endless clicking.
Today, tracking a single transaction means opening a block explorer, searching by hash, then manually checking the 'Internal Transactions' tab. If you need token history, you might have to run separate searches for ERC-20 transfers and NFT movements, copy-pasting addresses into multiple forms just to piece together one wallet’s activity.
With this MCP, your agent does that work instantly. You ask: 'Show me the full asset movement.' It runs a chain of specialized calls—like `get_token_tx` combined with `get_logs`—and gives you a single, consolidated narrative showing every token and contract interaction for that address.
Getting Contract Source Code
Manual verification requires finding the contract page, navigating to the code tab, and comparing the displayed source code against the transaction logs you observed. This is slow, tedious, and prone to human error when debugging a complex system.
Now, your agent runs `get_source_code` and provides the clean code alongside the data. You can immediately cross-reference what the contract *is* supposed to do with what it *actually* did during a transaction.
What you can do with this MCP connector
You can use this connector to audit blockchain activity across multiple chains—it’s like having a real-time block explorer built into your chat window. Need to know what's happening with a contract? You don't have to jump between tabs and search through endless records. Your agent pulls up the native balance, then gets a full list of transactions for that wallet address across various chains.
It can filter down to show only ERC-20 token movements or track specific NFTs (ERC-721). If you need to debug smart contract logic, you can even pull the raw source code and verify it against recorded event logs. Because all this financial data passes through Vinkius's zero-trust proxy, every transaction is recorded in a cryptographically signed audit trail, giving you total confidence in what your agent sees.
019e3892-bdf5-725d-88d9-3d230d1783ab 
How Etherscan MCP Works
- 1 Provide the address and chain ID you want to examine.
- 2 Tell your agent what kind of data you need: 'Show me all ERC-20 transfers' or 'What is the current balance?'
- 3 The agent runs the specialized tool, pulling the structured data directly into the conversation for review.
The bottom line is that you get a full audit trail of asset movements and contract activity without leaving your chat interface.
Who Is Etherscan MCP For?
Crypto analysts, DeFi developers, and smart contract auditors. If your job involves tracing where digital assets came from or verifying complex on-chain interactions, this is for you.
Debugging cross-contract calls by pulling transaction logs and checking the required source code.
Tracking large 'whale' movements or analyzing token distribution across multiple addresses without manual block explorer searches.
Verifying that a contract's recorded behavior matches its published source code and checking for specific event emissions.
What Changes When You Connect
- Track full asset movements: You can pull specific histories for ERC-20 tokens, unique NFTs (ERC-721), and multi-standard assets (ERC-1155) using specialized tools like
get_token_txorget_token_nft_tx. - Get a complete picture of wallet activity: Access both normal transactions (
get_tx_list) and internal contract calls (get_tx_list_internal) for deep auditing. - Verify code integrity: Don't just trust the numbers; use
verify_source_codeto pull the actual source code and confirm what the contract is supposed to do. - Contextual data points: Get immediate network context by checking the current ETH price (
get_eth_price) or gas costs (get_gas_oracle) alongside transaction details. - Build complex workflows: Combine multiple chains in one query, specifying the
chainidto compare activity across networks like Ethereum and Polygon.
Real-World Use Cases
Tracking a Suspect Token Transfer
A user notices an unexpected token withdrawal. They ask their agent to use get_token_tx to list all ERC-20 transfers for the address and then run get_transaction_by_hash on the suspicious transaction hash to see exactly where the funds went.
Auditing a DeFi Vault
A developer needs to ensure a vault contract is behaving as expected. They use get_abi to understand its methods, then call get_logs on key transactions and finally run verify_source_code to confirm the logic hasn't been compromised.
Analyzing NFT Ownership Chains
A collector wants to know the entire history of an NFT. They use get_token_nft_tx and then run get_address_token_balance to see if the owner holds other related assets.
Comparing Multi-Chain Activity
An analyst needs a total picture of funds. They tell their agent to use get_balance_multi and specify multiple chain IDs (e.g., 1, 137) to compare the native ETH holdings across chains.
The Tradeoffs
Listing tools manually
Trying to find out if an address has tokens by running separate queries for ERC-20, then another for NFTs, and hoping they all come back.
→
Start with a general portfolio check using get_address_token_balance or combine checks: use get_token_tx and get_token_nft_tx in sequence to cover both types of assets.
Ignoring transaction type
Assuming a simple transfer is always a standard ERC-20 event, missing the underlying contract interaction details.
→
Always run get_tx_list_internal and check for logs using get_logs. This captures the complex interactions that basic searches miss.
Using old data
Relying on a cached view of contract code or balances, thinking it's current.
→
Always confirm freshness by pulling get_block_number first. This tells you the latest state before running any reads like get_balance.
When It Fits, When It Doesn't
Use this MCP if your task requires tracing immutable financial data from a blockchain—specifically, tracking token movements (ERC-20, NFTs) or auditing contract behavior. Don't use it if you just need to read public data that isn't on the chain, like an internal company database; those require different connection types. If you only need simple account balances and nothing more, a dedicated balance tool is fine, but for deep analysis involving transactions, source code verification (verify_source_code), or multi-asset tracking (like get_address_token_balance), this MCP is necessary. It’s the primary source of truth for anything that moves on Ethereum.
Common Questions About Etherscan MCP
How do I track multiple token types using get_token_tx and get_token_nft_tx? +
You ask your agent for both. It runs get_token_tx to list all ERC-20 movements, and then separately uses get_token_nft_tx to pull the corresponding NFT history, giving you a complete view of assets.
Do I need get_transaction_by_hash for every transaction? +
No. If you want a list of recent activity, use get_tx_list. But if you have one specific hash and need all the details—like gas usage or status—use get_transaction_by_hash.
What is the difference between get_balance and get_balance_multi? +
get_balance only checks one address. Use get_balance_multi if you need to check 10 or more addresses at the same time, which saves multiple calls.
Can I see contract source code using get_source_code? +
Yes, this tool pulls the readable source code for a smart contract address. This is crucial for auditing because it lets you verify the logic that was deployed.
If I need to check balances across multiple addresses or networks, should I use `get_balance_multi`? +
Yes, start with get_balance_multi. This tool lets your agent pull native token balances for a batch of up to 20 different addresses in one call. It's much faster than running individual checks.
How do I get the full picture of activity by combining transaction types, like using `get_tx_list` and `get_tx_list_internal`? +
You must call both tools. get_tx_list gives you standard, visible transactions for an address. Use get_tx_list_internal to find the underlying contract calls that aren't always displayed on the main ledger.
If I need more than 10,000 transaction records using `get_tx_list`, what should I do? +
The tool has a record limit of 10,000 per call. You'll need to use the provided pagination parameters in your prompt to process history in chunks. Don't try to pull everything at once.
What does `get_abi` provide, and why should I run it before analyzing a contract? +
get_abi retrieves the Application Binary Interface (ABI) for a contract. This data defines how functions work, telling your agent exactly what inputs are required to interact with that specific smart contract.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.