Servers Playground How we check Add a server Log in

Etherscan

Working · 1.8 s

io.etherscan/etherscan-mcpv2.3.0 Domain verified

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

Crypto & Web3

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

get_block_by_timestamp Read-only

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

timestampinteger, required

Unix timestamp in seconds.

chainidstring

Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

closeststring

Return closest block before or after. Default before.

Etherscan MCP server | mcptry

Tools (17)

get_block_by_timestamp

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

read-only

Argument	Type	Description
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).
closest	string	Return closest block before or after. Default before.
timestamp*	integer	Unix timestamp in seconds.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "timestamp"
  ],
  "properties": {
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    },
    "closest": {
      "enum": [
        "before",
        "after"
      ],
      "type": "string",
      "description": "Return closest block before or after. Default before."
    },
    "timestamp": {
      "type": "integer",
      "minimum": 0,
      "description": "Unix timestamp in seconds."
    }
  },
  "additionalProperties": false
}

get_contract_abi

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

read-only

Argument	Type	Description
address*	string	Contract address.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Contract address."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).
contractaddresses*	array	List of contract addresses (1-5).
include_creation_bytecode	boolean	Include the full contract creation bytecode (several KB per contract). Omitted by default.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "contractaddresses"
  ],
  "properties": {
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    },
    "contractaddresses": {
      "type": "array",
      "items": {
        "type": "string",
        "pattern": "^0x[a-fA-F0-9]{40}$"
      },
      "maxItems": 5,
      "minItems": 1,
      "description": "List of contract addresses (1-5)."
    },
    "include_creation_bytecode": {
      "type": "boolean",
      "description": "Include the full contract creation bytecode (several KB per contract). Omitted by default."
    }
  },
  "additionalProperties": false
}

get_contract_source

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

read-only

Argument	Type	Description
address*	string	Contract address.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "address"
  ],
  "properties": {
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Contract address."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

get_gas_oracle

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

read-only

Argument	Type	Description
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

get_internal_transactions

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

read-only

Argument	Type	Description
page	integer	Page number (1-based). Default 1.
sort	string	Sort order by block number. Default desc (newest first).
offset	integer	Records per page (max 10000). Default 100.
txhash	string	Parent transaction hash (omit if using address).
address	string	Account address (omit if using txhash).
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).
endblock	integer	End block number.
startblock	integer	Start block number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (1-based). Default 1."
    },
    "sort": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort order by block number. Default desc (newest first)."
    },
    "offset": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1,
      "description": "Records per page (max 10000). Default 100."
    },
    "txhash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Parent transaction hash (omit if using address)."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Account address (omit if using txhash)."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    },
    "endblock": {
      "type": "integer",
      "minimum": 0,
      "description": "End block number."
    },
    "startblock": {
      "type": "integer",
      "minimum": 0,
      "description": "Start block number."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
page	integer	Page number (1-based).
offset	integer	Records per page (max 1000).
topic0	string	Topic 0 — usually the keccak256 event-signature hash.
topic1	string	Topic 1 (first indexed argument).
topic2	string	Topic 2 (second indexed argument).
topic3	string	Topic 3 (third indexed argument).
address	string	Contract address to filter by (optional if filtering by topics).
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).
toblock	any

get_native_balance

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

read-only

Argument	Type	Description
tag	string	Block tag. Default latest.
address*	string	Account address to query.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "address"
  ],
  "properties": {
    "tag": {
      "enum": [
        "latest",
        "earliest",
        "pending"
      ],
      "type": "string",
      "description": "Block tag. Default latest."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Account address to query."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

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.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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

read-only

Argument	Type	Description
page	integer	Page number (1-based). Default 1.
sort	string	Sort order by block number. Default desc (newest first).
offset	integer	Records per page (max 10000). Default 100.
address	string	Account address.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).
endblock	integer	End block number.
standard	string	Token standard: erc20 (default), erc721, or erc1155.
startblock	integer	Start block number.
contractaddress	string	Token contract address to filter by.

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.

read-only

Argument	Type	Description
txhash*	string	Transaction hash.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "txhash"
  ],
  "properties": {
    "txhash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Transaction hash."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
txhash*	string	Transaction hash.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "txhash"
  ],
  "properties": {
    "txhash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Transaction hash."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

get_transaction_receipt_status

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

read-only

Argument	Type	Description
txhash*	string	Transaction hash.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "txhash"
  ],
  "properties": {
    "txhash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Transaction hash."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

get_transaction_status

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

read-only

Argument	Type	Description
txhash*	string	Transaction hash.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "txhash"
  ],
  "properties": {
    "txhash": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Transaction hash."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    }
  },
  "additionalProperties": false
}

get_transactions

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

read-only

Argument	Type	Description
page	integer	Page number (1-based). Default 1.
sort	string	Sort order by block number. Default desc (newest first).
offset	integer	Records per page (max 10000). Default 100.
address*	string	Account address to query.
chainid	string	Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1).
endblock	integer	End block number.
startblock	integer	Start block number.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "address"
  ],
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (1-based). Default 1."
    },
    "sort": {
      "enum": [
        "asc",
        "desc"
      ],
      "type": "string",
      "description": "Sort order by block number. Default desc (newest first)."
    },
    "offset": {
      "type": "integer",
      "maximum": 10000,
      "minimum": 1,
      "description": "Records per page (max 10000). Default 100."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Account address to query."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    },
    "endblock": {
      "type": "integer",
      "minimum": 0,
      "description": "End block number."
    },
    "startblock": {
      "type": "integer",
      "minimum": 0,
      "description": "Start block number."
    }
  },
  "additionalProperties": false
}

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.

read-only

Argument	Type	Description
view*	string	The factual Etherscan result category to display.
chain	string
chart	object
items	array
title*	string
footer	string
metrics	array
sections	array
subtitle	string
explorerUrl	string

resolve_ens_name

Resolve an ENS name (or onchain subdomain, e.g. etherscan.eth or gm.etherscan.eth) to its Ethereum address. Ethereum mainnet only. Offchain names that require CCIP Read / wildcard resolution (e.g. *.base.eth) are not supported.

read-only

Argument	Type	Description
name*	string	ENS name to resolve, e.g. 'etherscan.eth' or a subdomain like 'gm.etherscan.eth'.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "name"
  ],
  "properties": {
    "name": {
      "type": "string",
      "pattern": "^[^\\s.]+(\\.[^\\s.]+)+$",
      "description": "ENS name to resolve, e.g. 'etherscan.eth' or a subdomain like 'gm.etherscan.eth'."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "page": {
      "type": "integer",
      "minimum": 1,
      "description": "Page number (1-based)."
    },
    "offset": {
      "type": "integer",
      "maximum": 1000,
      "minimum": 1,
      "description": "Records per page (max 1000)."
    },
    "topic0": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Topic 0 — usually the keccak256 event-signature hash."
    },
    "topic1": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Topic 1 (first indexed argument)."
    },
    "topic2": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Topic 2 (second indexed argument)."
    },
    "topic3": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{64}$",
      "description": "Topic 3 (third indexed argument)."
    },
    "address": {
      "type": "string",
      "pattern": "^0x[a-fA-F0-9]{40}$",
      "description": "Contract address to filter by (optional if filtering by topics)."
    },
    "chainid": {
      "type": "string",
      "pattern": "^\\d+$",
      "description": "Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1)."
    },
    "toblock": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "string",
          "const": "latest"
        }
      ],
      "description": "End block number, or \"latest\". Default latest."
    },
    "fromblock": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 0
        },
        {
          "type": "string",
          "const": "latest"
        }
      ],
      "description": "Start block number, or \"latest\". Default 0."
    },
    "topic0_1_opr": {
      "enum": [
        "and",
        "or"
      ],
      "type": "string",
      "description": "Combine topic0 and topic1: and | or."
    },
    "topic1_2_opr": {
      "enum": [
        "and",
        "or"
      ],
      "type": "string",
      "description": "Combine topic1 and topic2: and | or."
    },
    "topic2_3_opr": {
      "enum": [
        "and",
        "or"
      ],
      "type": "string",
      "description": "Combine topic2 and topic3: and | or."
    }
  },
  "additionalProperties": false
}

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "view",
    "title"
  ],
  "properties": {
    "view": {
      "enum": [
        "wallet",
        "token",
        "transaction",
        "contract",
        "gas",
        "general"
      ],
      "type": "string",
      "description": "The factual Etherscan result category to display."
    },
    "chain": {
      "type": "string",
      "maxLength": 80
    },
    "chart": {
      "type": "object",
      "required": [
        "title",
        "points"
      ],
      "properties": {
        "title": {
          "type": "string",
          "maxLength": 80,
          "minLength": 1
        },
        "points": {
          "type": "array",
          "items": {
            "type": "number"
          },
          "maxItems": 40,
          "minItems": 2
        },
        "endLabel": {
          "type": "string",
          "maxLength": 40
        },
        "startLabel": {
          "type": "string",
          "maxLength": 40
        }
      },
      "additionalProperties": false
    },
    "items": {
      "type": "array",
      "items": {
        "$ref": "#/properties/metrics/items"
      },
      "default": [],
      "maxItems": 12
    },
    "title": {
      "type": "string",
      "maxLength": 100,
      "minLength": 1
    },
    "footer": {
      "type": "string",
      "maxLength": 240
    },
    "metrics": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "label",
          "value"
        ],
        "properties": {
          "label": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1
          },
          "value": {
            "type": "string",
            "maxLength": 240,
            "minLength": 1
          },
          "detail": {
            "type": "string",
            "maxLength": 300
          }
        },
        "additionalProperties": false
      },
      "default": [],
      "maxItems": 6
    },
    "sections": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title",
          "items"
        ],
        "properties": {
          "items": {
            "type": "array",
            "items": {
              "$ref": "#/properties/metrics/items"
            },
            "maxItems": 12
          },
          "title": {
            "type": "string",
            "maxLength": 80,
            "minLength": 1
          },
          "layout": {
            "enum": [
              "cards",
              "rows",
              "chips"
            ],
            "type": "string",
            "default": "rows"
          }
        },
        "additionalProperties": false
      },
      "default": [],
      "maxItems": 4
    },
    "subtitle": {
      "type": "string",
      "maxLength": 180
    },
    "explorerUrl": {
      "type": "string",
      "format": "uri"
    }
  },
  "additionalProperties": false
}