Etherscan is an MCP server published by io.etherscan, hosted at mcp-keyless.etherscan.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 17 tools, including get_native_balance, get_transactions, get_internal_transactions, get_token_transfers, resolve_ens_name.
Read-only Etherscan V2 blockchain data: balances, transactions, transfers, tokens, contracts, logs.
2 connections through 4 shared values. Tap any node.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Get the native coin (e.g. ETH) balance of an address, in wei.
| Parameter | 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). |
{
"name": "get_native_balance",
"title": "Get Native Balance",
"description": "Get the native coin (e.g. ETH) balance of an address, in wei.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Native Balance",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the list of normal (external) transactions for an address.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more. |
| 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. |
{
"name": "get_transactions",
"title": "Get Transactions",
"description": "Get the list of normal (external) transactions for an address.",
"inputSchema": {
"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. page x offset must be at most 10000; narrow the block range to see more."
},
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Transactions",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get internal transactions for an address, or by a specific parent transaction hash.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more. |
| 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. |
{
"name": "get_internal_transactions",
"title": "Get Internal Transactions",
"description": "Get internal transactions for an address, or by a specific parent transaction hash.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more."
},
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Internal Transactions",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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).
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more. |
| 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. |
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. A name that does not resolve returns ok:true with a null result.
| Parameter | Type | Description |
|---|---|---|
| name * | string | ENS name to resolve, e.g. 'etherscan.eth' or a subdomain like 'gm.etherscan.eth'. |
{
"name": "resolve_ens_name",
"title": "Resolve Ens Name",
"description": "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. A name that does not resolve returns ok:true with a null result.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Resolve Ens Name",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the verified source code and metadata for a contract address.
| Parameter | 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). |
{
"name": "get_contract_source",
"title": "Get Contract Source",
"description": "Get the verified source code and metadata for a contract address.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Contract Source",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the verified ABI (JSON) for a contract address.
| Parameter | 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). |
{
"name": "get_contract_abi",
"title": "Get Contract Abi",
"description": "Get the verified ABI (JSON) for a contract address.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Contract Abi",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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. |
{
"name": "get_contract_creation",
"title": "Get Contract Creation",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Contract Creation",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the receipt status of a transaction (1 = success, 0 = failed). Post-Byzantium only.
| Parameter | 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). |
{
"name": "get_transaction_receipt_status",
"title": "Get Transaction Receipt Status",
"description": "Get the receipt status of a transaction (1 = success, 0 = failed). Post-Byzantium only.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Transaction Receipt Status",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the contract execution status of a transaction (detects failed/erroring executions).
| Parameter | 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). |
{
"name": "get_transaction_status",
"title": "Get Transaction Status",
"description": "Get the contract execution status of a transaction (detects failed/erroring executions).",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Transaction Status",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get current gas price recommendations (safe / propose / fast) from the gas tracker.
| Parameter | Type | Description |
|---|---|---|
| chainid | string | Numeric chain id (e.g. 1=Ethereum, 56=BNB, 137=Polygon). If omitted, defaults to Ethereum Mainnet (1). |
{
"name": "get_gas_oracle",
"title": "Get Gas Oracle",
"description": "Get current gas price recommendations (safe / propose / fast) from the gas tracker.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Gas Oracle",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}Get the block number closest to a given Unix timestamp (seconds).
| Parameter | 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. |
{
"name": "get_block_by_timestamp",
"title": "Get Block By Timestamp",
"description": "Get the block number closest to a given Unix timestamp (seconds).",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Block By Timestamp",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
No parameters.
{
"name": "get_supported_chains",
"title": "Get Supported Chains",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Supported Chains",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more. |
| offset | integer | Records per page (max 1000). Default 100. |
| 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 | End block number, or "latest". Default latest. |
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.
| Parameter | 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). |
{
"name": "get_transaction_by_hash",
"title": "Get Transaction By Hash",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Transaction By Hash",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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). |
{
"name": "get_transaction_receipt",
"title": "Get Transaction Receipt",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Transaction Receipt",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}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.
| Parameter | 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 |
Read-only blockchain explorer. Tools only retrieve public Etherscan or Blockscan data; they cannot sign or broadcast transactions, verify contracts, manage API keys, or modify state.
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
{
"name": "get_token_transfers",
"title": "Get Token Transfers",
"description": "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).",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more."
},
"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."
},
"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."
},
"standard": {
"enum": [
"erc20",
"erc721",
"erc1155"
],
"type": "string",
"description": "Token standard: erc20 (default), erc721, or erc1155."
},
"startblock": {
"type": "integer",
"minimum": 0,
"description": "Start block number."
},
"contractaddress": {
"type": "string",
"pattern": "^0x[a-fA-F0-9]{40}$",
"description": "Token contract address to filter by."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Token Transfers",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}| fromblock |
| any |
| Start block number, or "latest". Default 0. |
| topic0_1_opr | string | Combine topic0 and topic1: and | or. |
| topic1_2_opr | string | Combine topic1 and topic2: and | or. |
| topic2_3_opr | string | Combine topic2 and topic3: and | or. |
{
"name": "get_logs",
"title": "Get Logs",
"description": "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.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"minimum": 1,
"description": "Page number (1-based). Default 1. page x offset must be at most 10000; narrow the block range to see more."
},
"offset": {
"type": "integer",
"maximum": 1000,
"minimum": 1,
"description": "Records per page (max 1000). Default 100."
},
"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
},
"outputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"data"
],
"properties": {
"data": {
"anyOf": [
{
"type": "object",
"additionalProperties": {}
},
{
"type": "array",
"items": {}
},
{
"type": "string"
},
{
"type": "number"
},
{
"type": "boolean"
},
{
"type": "null"
}
],
"description": "The JSON result returned by the Etherscan data tool."
}
},
"additionalProperties": false
},
"annotations": {
"title": "Get Logs",
"readOnlyHint": true,
"openWorldHint": true,
"idempotentHint": true,
"destructiveHint": false
}
}{
"name": "render_etherscan_widget",
"title": "Show Etherscan Result",
"description": "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.",
"inputSchema": {
"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
},
"outputSchema": {
"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
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}
}