How to integrate Etherscan MCP with Atomic Agent

Execute a read-only eth_call at latest state and return raw ABI-encoded data; no transaction is created.

Estimate confirmation time in seconds for an optional exact gas price in wei.

Estimate gas required for a transaction-like call without submitting a transaction.

Get the first transaction and address that funded an externally owned account.

Get Etherscan nametags, labels, reputation, notes, and provider-defined metadata for up to 100 addresses.

Get the number of transactions sent from an address at an optional block tag, as hexadecimal.

Get API credits used, available, and allowed for the connected API key's current interval.

Get JSON-RPC block information for an explicit hexadecimal block number or the latest block, returning transaction hashes or full transaction objects.

Estimate blocks and seconds remaining until a future block is mined.

Get the decimal block number closest before or after a Unix timestamp in seconds.

Get a block's miner reward, uncle inclusion reward, and included uncle records.

Get a block's total JSON-RPC transaction count as hexadecimal, without transfer-type breakdowns.

Get Ethereum mainnet normal, internal, ERC20, ERC721, and ERC1155 transaction counts for a decimal block number.

Get the JSON-encoded ABI string for a verified contract.

Get bytecode stored at an address for an optional named or hexadecimal block tag.

Get creator, creation transaction, block, Unix-second timestamp, factory, and creation bytecode for up to five contracts on one chain.

Get whether a transaction's contract execution failed and any provider error description.

Get source code plus compiler, proxy, implementation, license, and verification metadata for one contract.

Get the raw value at a contract storage position for an optional block tag.

Get the canonical JSON-RPC current gas price in wei as hexadecimal; use Get Gas Oracle for recommendations.

Get one address's ERC20 token balance in exact smallest units, optionally at a historical block.

Get an ERC20 token's current total supply, or its historical supply when block_number is provided; historical lookup requires Standard+, is mainnet-only, and is unavailable on testnets.

Get Ether supply in wei, either the basic block-reward supply or the ETH-specific component breakdown including staking, EIP-1559 burned fees, and staking withdrawals.

Get current safe, proposed, and fast gas-price recommendations and the suggested base fee as gwei strings.

Get the latest block number as an exact hexadecimal JSON-RPC quantity.

Get the latest native-token prices in BTC and USD with their Unix-second timestamps.

Get one address's native-token balance in exact wei, optionally at a historical block.

Get native-token balances for up to 20 addresses in one call, returning wei as exact decimal strings on one chain.

Get the current discoverable-node count or daily historical counts over a UTC date range.

Get the number of addresses currently holding an ERC20 token.

Get token identity, standard, supply, verification, project links, price, and logo metadata for an ERC20, ERC721, or ERC1155 contract.

Get one full JSON-RPC transaction by hash or by hexadecimal block number and transaction index.

Get a full JSON-RPC transaction receipt, including event logs, by hash on one chain.

Get a transaction receipt's success or failure status string.

Get an uncle block by optional hexadecimal parent block number and uncle index.

Check source-code or proxy verification status for a GUID returned by a prior verification submission.

List one page of beacon-chain withdrawals, optionally filtered by recipient and inclusive block range.

List daily Ethereum node-chain size measurements for one client and sync mode over a date range.

List daily mined-block counts and corresponding block rewards in ether over a UTC date range.

List daily minimum, average, and maximum gas prices in wei over a UTC date range.

List one normalized daily scalar metric over a UTC date range.

List daily uncle-block counts and uncle rewards in ether over a UTC date range.

List one page of ERC721 token IDs owned by an address for one collection.

List one provider page of event logs over an inclusive block range, filtered by an emitting address, indexed topics, or both.

List internal transactions by address, transaction hash, or an unfiltered block range.

List one page of canonical L2 deposits from Ethereum or withdrawals to Ethereum for an address on a supported L2.

List one provider page of an address's normal transactions, optionally filtered by start and end block.

List one page of Plasma deposit transactions on documented Polygon, Gnosis, or BitTorrent Chain networks, optionally filtered by recipient address.

List current Etherscan mainnet and testnet chains, explorer and API URLs, and service status.

List one page of ERC20 holders or up to 1000 top holders for a token.

List one page of ERC20 token balances or ERC721 collection quantities held by an address.

List one provider page of ERC20, ERC721, or ERC1155 transfers, selected by token_standard and filtered by an account, token contract, or both on one chain.

List one page of full blocks or pre-Merge uncle blocks validated by an address.

Resolve an ENS name or supported onchain subdomain to an address on Ethereum mainnet.