# Etherscan MCP for AI Agents AI Agent Connect

> Etherscan MCP lets you query Ethereum and EVM-compatible blockchain data directly through your AI agent. Check balances, transaction history, and token transfers across networks like Polygon or BSC without switching tabs. It brings real-time on-chain data into your chat interface.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_GgbqIUEwTkBGL2VRWDJSeJ8YqzmAM0hbJRWkisTL/ai-agent-connect
- **Tags:** ethereum, evm, block-explorer, wallet-tracker, smart-contracts

## Description

This Connector lets you pull live blockchain data into your AI client without having to navigate multiple block explorers or copy-paste long wallet addresses. If you are trying to figure out where a specific whale moved their funds or want to see the current gas price on Polygon, you can just ask your agent. It handles the heavy lifting of querying Etherscan data, meaning you get straight answers on native balances, internal transactions, and token movements for ERC-20 or NFT standards. Instead of hunting through filters on a website, you can just describe the parameters you need. It is a big part of what makes the Vinkius catalog so useful for web3 work because it puts the data where you are already typing. You will get specific details on contract source code, gas prices, and even address tags if you have the right permissions. It is about moving from manual searching to direct querying.

## Tools

### get_eth_supply
See the total circulating supply of Ether. This provides a high-level view of the total amount of native tokens.

### get_balance_multi
Get native token balances for up to 20 different addresses in one go. This helps you quickly see how much ETH or MATIC an account holds.

### get_balance
Check the native token balance for a single specific wallet address. This helps you quickly see how much ETH or MATIC an account holds.

### get_abi
Retrieve the Application Binary Interface for a specific smart contract. This allows your agent to understand how to interact with the contract code.

### get_address_tag
Fetch the name tag for an address if you have a PRO Plus account. It helps identify known wallets or projects by name.

### get_block_no_by_time
Find the block number associated with a specific timestamp. Use this to locate a transaction that happened at a known time.

### get_block_number
Get the most recent block number on the current network. This is useful for checking the latest state of the blockchain.

### get_eth_price
Check the current last price of Ether. Use this to get real-time market values for ETH.

### get_gas_oracle
Get the current gas price from the oracle. It helps you determine the cost of sending transactions in real-time.

### get_logs
Retrieve event logs for specific blockchain interactions. This is useful for tracking specific smart contract events.

### get_source_code
Pull the source code for a deployed smart contract. You can use this to review the logic of a contract directly.

### get_transaction_by_hash
Look up the details of a specific transaction using its hash. This lets you see the status and details of any individual move.

### get_token_1155_tx
Fetch ERC-1155 token transfers for a specific address. Use this to track multi-token standard transfers.

### get_token_nft_tx
Get ERC-721 NFT transfer history for a wallet. This helps you see who owned a specific NFT and when.

### get_token_tx
View ERC-20 token transfers for a given address. Use this to track the flow of common tokens like USDC or LINK.

### get_tx_list_internal
Pull internal transactions for an address that aren't visible in normal lists. This is vital for seeing contract-to-contract movements.

### get_tx_list
Fetch up to 10,000 normal transactions for a specific wallet. This allows you to audit a large volume of history quickly.

### verify_source_code
Verify the source code of a smart contract on the blockchain. Use this to ensure the deployed code matches the intended logic.

### get_address_token_balance
View a complete portfolio of tokens for a specific address. This gives you a full snapshot of all assets held by a wallet.

## Prompt Examples

**Prompt:** 
```
What's the current ETH price and gas fee?
```

**Response:** 
```
Here is the current data for Ethereum:

| Metric | Value |
| :--- | :--- |
| **Ether Price** | $2,450.12 |
| **Current Gas Price** | 12 Gwei |
| **Network Status** | Stable
```

**Prompt:** 
```
Show me the last 3 ERC-20 transfers for 0x123...
```

**Response:** 
```
I've retrieved the recent ERC-20 transfers for that address:

* **500 USDT** to 0xabc... (10 mins ago)
* **100 LINK** to 0xdef... (1 hour ago)
* **250 USDC** to 0xghi... (3 hours ago)
```

**Prompt:** 
```
Get the source code for this contract [address].
```

**Response:** 
```
I've pulled the source code for the contract at that address:

```solidity
// SPDX-License-Identifier: MIT
pragma solidity ^0.8.0;

contract Example {
    function hello() public pure returns (string memory) {
        return "Hello World";
    }
}
```
```

## Capabilities

### Check native balances for multiple addresses
Get the current ETH or MATIC balance for up to 20 wallets in one request.

### View full transaction history
Pull a complete list of normal and internal transactions for any specific wallet.

### Track ERC-20 and NFT transfers
Monitor the movement of ERC-20 tokens, ERC-721 NFTs, and ERC-1155 assets.

### Get real-time gas and supply data
Check the current gas price and the total supply of Ether instantly.

### Fetch contract source code and ABIs
Retrieve the source code and ABI for deployed smart contracts to audit logic.

## Use Cases

### Debugging a failed swap
A developer asks the agent to check a transaction hash using `get_transaction_by_hash` to see why a contract interaction failed.

### Whale tracking
An analyst asks for the last 10 NFT transfers for a specific wallet using `get_token_nft_tx` to see recent movements.

### Portfolio auditing
A user asks for a full list of balances for 10 different addresses using `get_balance_multi` to see their total holdings.

### Smart contract review
A security researcher pulls the ABI and source code using `get_abi` and `get_source_code` to audit a new project.

## Benefits

- Stop manual searching by using `get_tx_list` to pull thousands of transactions into your chat.
- Monitor multiple wallets simultaneously with `get_balance_multi` to save time on portfolio checks.
- Verify smart contracts faster by using `get_source_code` and `verify_source_code` directly in your workspace.
- Track whale movements across chains by requesting `get_token_tx` for specific ERC-20 assets.
- Get instant gas updates with `get_gas_oracle` so you do not have to check external sites before sending.

## How It Works

The bottom line is you get live blockchain data in your chat window instead of digging through a web explorer.

1. Connect your Etherscan API key to the Connector.
2. Ask your AI client to query a specific address, transaction hash, or network.
3. Receive structured data on balances, logs, or transaction history in your chat.

## Frequently Asked Questions

**Can the Etherscan MCP check balances on Polygon?**
Yes, it supports multiple EVM chains including Polygon, BSC, and others by specifying the correct chain ID.

**Does it support NFT transfers?**
Yes, it can track both ERC-721 and ERC-1155 token transfers for specific wallet addresses.

**How do I get my data?**
You just need to provide your Etherscan API key in the setup. Once connected, you can ask for any data via your AI client.

**Can it see internal transactions?**
Yes, it has a specific tool to pull internal transactions that are often hidden from standard transaction lists.

**Is it for any blockchain?**
It is specifically for Ethereum and other EVM-compatible networks. It won't work for non-EVM chains like Bitcoin.

**Can I check multiple wallets?**
Yes, you can query the native balances for up to 20 different addresses in a single request.

**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.