io.etherscan/etherscan-mcp

Etherscan

Read-only Etherscan V2 blockchain data: balances, transactions, transfers, tokens, contracts, logs.

2.3.0
Version
remote
Transport
16
Tools

Security review

Review passed

Reviewed 22h ago.

  • tools: 16 tools scanned
  • metadata: scanned

No findings.

Tools (16)

  • get_native_balance

    Get the native coin (e.g. ETH) balance of an address, in wei.

  • get_transactions

    Get the list of normal (external) transactions for an address.

  • get_internal_transactions

    Get internal transactions for an address, or by a specific parent transaction hash.

  • get_token_transfers

    Get token transfer events for an address, optionally filtered by token contract. Select the token standard: erc20 (fungible, default), erc721 (NFT), or erc1155 (multi-token).

  • get_contract_source

    Get the verified source code and metadata for a contract address.

  • get_contract_abi

    Get the verified ABI (JSON) for a contract address.

  • get_contract_creation

    Get the creator address and creation transaction hash for up to 5 contract addresses. The multi-kilobyte creation bytecode is omitted by default to keep responses small; set include_creation_bytecode=true to include it.

  • get_transaction_receipt_status

    Get the receipt status of a transaction (1 = success, 0 = failed). Post-Byzantium only.

  • get_transaction_status

    Get the contract execution status of a transaction (detects failed/erroring executions).

  • get_gas_oracle

    Get current gas price recommendations (safe / propose / fast) from the gas tracker.

  • get_block_by_timestamp

    Get the block number closest to a given Unix timestamp (seconds).

  • get_supported_chains

    Get the chains / chain IDs supported by the Etherscan V2 API. In the hosted (proxy) deployment this returns a bundled snapshot shipped with the server, refreshed when the package is updated; in direct/stdio mode it queries the live chain-list endpoint. A chain's absence from the returned list is not proof that it lacks live support.

  • get_logs

    Search event logs by contract address and/or topics over a block range. Topics are 32-byte hex values; topic0 is usually the keccak256 event-signature hash. Adjacent-topic operators (and/or) combine multiple topic filters. Provide 'address' and/or at least one topic.

  • get_transaction_by_hash

    Get the full transaction object for a transaction hash (from, to, value, input data, gas, gas price, nonce, block number/hash, transaction index). Returns null if the hash is unknown.

  • get_transaction_receipt

    Get the transaction receipt for a transaction hash (execution status, gas used, cumulative gas used, effective gas price, logs, and the created contract address for deployments). Returns null if the hash is unknown or the transaction is still pending.

  • render_etherscan_widget

    Present exact facts returned by Etherscan data tools in a fast explorer-style card. Call the relevant Etherscan data tool first and copy only supported values into this tool. Never invent scores, risk labels, historical prices, forecasts, or audit conclusions.