Tenzro Ethereum

Official17 tools

by tenzro

Ethereum tools over MCP: Chainlink feeds, ENS, ERC-8004 agents, EAS attestations, transactions.

Captured live from the server via tools/list.

eth_call_contract

Execute a read-only eth_call against a smart contract. Params: to (contract address), data (hex-encoded calldata), block (default 'latest'). Returns the raw hex result. Use eth_encode_function to build calldata from a function signature and arguments.

Parameters3

to	string	required	Contract address (hex, with or without 0x prefix)
data	string	required	Hex-encoded calldata (with or without 0x prefix)
block	string \| null	optional	Block parameter ('latest', 'earliest', 'pending', or hex block number). Default: 'latest'

Raw schema

{
  "type": "object",
  "properties": {
    "to": {
      "description": "Contract address (hex, with or without 0x prefix)",
      "type": "string"
    },
    "data": {
      "description": "Hex-encoded calldata (with or without 0x prefix)",
      "type": "string"
    },
    "block": {
      "description": "Block parameter ('latest', 'earliest', 'pending', or hex block number). Default: 'latest'",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "to",
    "data"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthCallContractParams"
}

eth_encode_function

ABI-encode a function call. Computes the 4-byte selector from the canonical function signature via Keccak-256, then left-pads each argument to 32 bytes. Returns the complete hex-encoded calldata ready for eth_call or a transaction. Example: function_sig='transfer(address,uint256)', args=['0xd8dA6BF26964aF9D7eEd9e03E53415D37aA96045', '0xde0b6b3a7640000'].

Parameters2

function_sig	string	required	Canonical function signature (e.g. 'transfer(address,uint256)', 'approve(address,uint256)', 'balanceOf(address)')
args	array	required	Arguments as JSON array of hex-encoded values (each will be left-padded to 32 bytes). E.g. ['0xRecipientAddress', '0xde0b6b3a7640000']

Raw schema

{
  "type": "object",
  "properties": {
    "function_sig": {
      "description": "Canonical function signature (e.g. 'transfer(address,uint256)', 'approve(address,uint256)', 'balanceOf(address)')",
      "type": "string"
    },
    "args": {
      "description": "Arguments as JSON array of hex-encoded values (each will be left-padded to 32 bytes). E.g. ['0xRecipientAddress', '0xde0b6b3a7640000']",
      "type": "array",
      "items": {
        "type": "string"
      }
    }
  },
  "required": [
    "function_sig",
    "args"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthEncodeFunctionParams"
}

eth_estimate_gas

Estimate gas required for a transaction via eth_estimateGas. Params: to (required), from/data/value (optional). Returns estimated gas in decimal and hex.

Parameters4

from	string \| null	optional	Sender address (hex, with or without 0x prefix)
to	string	required	Recipient/contract address (hex, with or without 0x prefix)
data	string \| null	optional	Hex-encoded calldata (with or without 0x prefix)
value	string \| null	optional	Value in wei (hex string, e.g. '0xde0b6b3a7640000' for 1 ETH)

Raw schema

{
  "type": "object",
  "properties": {
    "from": {
      "description": "Sender address (hex, with or without 0x prefix)",
      "type": [
        "string",
        "null"
      ]
    },
    "to": {
      "description": "Recipient/contract address (hex, with or without 0x prefix)",
      "type": "string"
    },
    "data": {
      "description": "Hex-encoded calldata (with or without 0x prefix)",
      "type": [
        "string",
        "null"
      ]
    },
    "value": {
      "description": "Value in wei (hex string, e.g. '0xde0b6b3a7640000' for 1 ETH)",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "to"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthEstimateGasParams"
}

eth_get_attestation

Query an attestation from Ethereum Attestation Service (EAS) by UID. Posts a GraphQL query to the EAS indexer at easscan.org. Returns attester, recipient, schema, data, timestamp, revocation status, and decoded data when available.

Parameters1

uid

string

required

Attestation UID (bytes32 hex, with or without 0x prefix)

Raw schema

{
  "type": "object",
  "properties": {
    "uid": {
      "description": "Attestation UID (bytes32 hex, with or without 0x prefix)",
      "type": "string"
    }
  },
  "required": [
    "uid"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetAttestationParams"
}

eth_get_balance

Get the ETH balance of an address via eth_getBalance. Returns balance in wei, Gwei, and ETH.

Parameters2

address	string	required	Ethereum address (hex, with or without 0x prefix)
block	string \| null	optional	Block parameter ('latest', 'earliest', 'pending', or hex block number). Default: 'latest'

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Ethereum address (hex, with or without 0x prefix)",
      "type": "string"
    },
    "block": {
      "description": "Block parameter ('latest', 'earliest', 'pending', or hex block number). Default: 'latest'",
      "type": [
        "string",
        "null"
      ]
    }
  },
  "required": [
    "address"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetBalanceParams"
}

eth_get_block

Get block by number via eth_getBlockByNumber. Params: block_number (hex or 'latest'), full_transactions (bool, default false). Returns block header, transactions, and metadata.

Parameters2

block_number	string \| null	optional	Block number as hex string (e.g. '0x10d4f') or tag ('latest', 'earliest', 'pending'). Default: 'latest'
full_transactions	boolean \| null	optional	If true, return full transaction objects instead of just hashes. Default: false

Raw schema

{
  "type": "object",
  "properties": {
    "block_number": {
      "description": "Block number as hex string (e.g. '0x10d4f') or tag ('latest', 'earliest', 'pending'). Default: 'latest'",
      "type": [
        "string",
        "null"
      ]
    },
    "full_transactions": {
      "description": "If true, return full transaction objects instead of just hashes. Default: false",
      "type": [
        "boolean",
        "null"
      ]
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetBlockParams"
}

eth_get_fee_history

Get fee history for recent blocks via eth_feeHistory. Returns base fees per gas, gas used ratios, and reward percentiles for EIP-1559 gas estimation.

Parameters3

block_count	string \| null	optional	Number of blocks to return (default '5')
newest_block	string \| null	optional	Newest block ('latest' by default, or hex block number)
reward_percentiles	array \| null	optional	Reward percentiles as JSON array of floats (e.g. [25.0, 50.0, 75.0])

Raw schema

{
  "type": "object",
  "properties": {
    "block_count": {
      "description": "Number of blocks to return (default '5')",
      "type": [
        "string",
        "null"
      ]
    },
    "newest_block": {
      "description": "Newest block ('latest' by default, or hex block number)",
      "type": [
        "string",
        "null"
      ]
    },
    "reward_percentiles": {
      "description": "Reward percentiles as JSON array of floats (e.g. [25.0, 50.0, 75.0])",
      "type": [
        "array",
        "null"
      ],
      "items": {
        "type": "number",
        "format": "double"
      }
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetFeeHistoryParams"
}

eth_get_gas_price

Get the current gas price from the Ethereum network via eth_gasPrice JSON-RPC. Returns the gas price in wei, Gwei, and hex.

Parameters

No parameters.

Raw schema

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

eth_get_price

Get token price from a Chainlink AggregatorV3Interface data feed via eth_call to latestRoundData(). Default feed: ETH/USD on mainnet (0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419). Returns price with 8 decimal precision, round ID, and update timestamps.

Parameters2

feed_address	string \| null	optional	Chainlink AggregatorV3Interface data feed address (default: ETH/USD 0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419)
chain_id	integer \| null	optional	Chain ID — 1 for mainnet (default), 8453 for Base, 42161 for Arbitrum. Selects the dRPC chain-specific URL for the feed read.

Raw schema

{
  "type": "object",
  "properties": {
    "feed_address": {
      "description": "Chainlink AggregatorV3Interface data feed address (default: ETH/USD 0x5f4eC3Df9cbd43714FE2740f5E3616155c5b8419)",
      "type": [
        "string",
        "null"
      ]
    },
    "chain_id": {
      "description": "Chain ID — 1 for mainnet (default), 8453 for Base, 42161 for Arbitrum. Selects the dRPC chain-specific URL for the feed read.",
      "type": [
        "integer",
        "null"
      ],
      "format": "uint64",
      "minimum": 0
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetPriceParams"
}

eth_get_token_balance

Get ERC-20 token balance for an address via eth_call to balanceOf(address). Params: token_address (ERC-20 contract), owner_address. Returns raw balance (caller must divide by 10^decimals for human-readable amount).

Parameters2

token_address	string	required	ERC-20 token contract address (hex, with or without 0x prefix)
owner_address	string	required	Owner address to check balance for (hex, with or without 0x prefix)

Raw schema

{
  "type": "object",
  "properties": {
    "token_address": {
      "description": "ERC-20 token contract address (hex, with or without 0x prefix)",
      "type": "string"
    },
    "owner_address": {
      "description": "Owner address to check balance for (hex, with or without 0x prefix)",
      "type": "string"
    }
  },
  "required": [
    "token_address",
    "owner_address"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetTokenBalanceParams"
}

eth_get_transaction

Get transaction details by hash via eth_getTransactionByHash. Returns sender, recipient, value, gas, input data, block number, and nonce.

Parameters1

tx_hash

string

required

Transaction hash (hex, with or without 0x prefix)

Raw schema

{
  "type": "object",
  "properties": {
    "tx_hash": {
      "description": "Transaction hash (hex, with or without 0x prefix)",
      "type": "string"
    }
  },
  "required": [
    "tx_hash"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetTransactionParams"
}

eth_get_transaction_receipt

Get transaction receipt by hash via eth_getTransactionReceipt. Returns status (0x0=failure, 0x1=success), gas used, logs, contract address (if deployment), and block info.

Parameters1

tx_hash

string

required

Transaction hash (hex, with or without 0x prefix)

Raw schema

{
  "type": "object",
  "properties": {
    "tx_hash": {
      "description": "Transaction hash (hex, with or without 0x prefix)",
      "type": "string"
    }
  },
  "required": [
    "tx_hash"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthGetTransactionReceiptParams"
}

eth_lookup_agent_8004

Look up an AI agent in the ERC-8004 Agent Registry by agent ID (uint256) or owner address. Builds the calldata for getAgent(uint256) or getAgentsByOwner(address) that can be used with eth_call_contract against a deployed ERC-8004 registry.

Parameters1

agent_id_or_address

string

required

Agent ID (uint256 hex) or owner address (hex) to look up

Raw schema

{
  "type": "object",
  "properties": {
    "agent_id_or_address": {
      "description": "Agent ID (uint256 hex) or owner address (hex) to look up",
      "type": "string"
    }
  },
  "required": [
    "agent_id_or_address"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthLookupAgent8004Params"
}

eth_lookup_ens

Reverse-lookup an Ethereum address to its ENS name via the Universal Resolver on-chain. Constructs <address>.addr.reverse and calls resolve(). Falls back to OnchainKit ENS API. Params: address (hex).

Parameters1

address

string

required

Ethereum address to reverse-lookup (hex, with or without 0x prefix)

Raw schema

{
  "type": "object",
  "properties": {
    "address": {
      "description": "Ethereum address to reverse-lookup (hex, with or without 0x prefix)",
      "type": "string"
    }
  },
  "required": [
    "address"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthLookupEnsParams"
}

eth_register_agent_8004

Build transaction data for registering an AI agent via ERC-8004 Agent Registry. ERC-8004 defines an on-chain registry for autonomous AI agents with capabilities, metadata URI, and owner tracking. Returns the ABI-encoded function selector and parameter breakdown for registerAgent(string,string[],string). The caller must sign and submit the transaction to the registry contract.

Parameters3

agent_name	string	required	Human-readable agent name
capabilities	array	required	List of capability strings (e.g. ['nlp', 'code-generation', 'web-search'])
metadata_uri	string	required	IPFS or HTTPS URI pointing to full agent metadata JSON

Raw schema

{
  "type": "object",
  "properties": {
    "agent_name": {
      "description": "Human-readable agent name",
      "type": "string"
    },
    "capabilities": {
      "description": "List of capability strings (e.g. ['nlp', 'code-generation', 'web-search'])",
      "type": "array",
      "items": {
        "type": "string"
      }
    },
    "metadata_uri": {
      "description": "IPFS or HTTPS URI pointing to full agent metadata JSON",
      "type": "string"
    }
  },
  "required": [
    "agent_name",
    "capabilities",
    "metadata_uri"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthRegisterAgent8004Params"
}

eth_resolve_ens

Resolve an ENS name to an Ethereum address. Tries the ENS Universal Resolver on-chain via eth_call (resolve(bytes,bytes) at 0xc0497E381f536Be9ce14B0dD3817cBcAe57d2F62). Falls back to the OnchainKit ENS API as a secondary source. Params: name (e.g. 'vitalik.eth').

Parameters1

name

string

required

ENS name to resolve (e.g. 'vitalik.eth')

Raw schema

{
  "type": "object",
  "properties": {
    "name": {
      "description": "ENS name to resolve (e.g. 'vitalik.eth')",
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthResolveEnsParams"
}

eth_send_raw_transaction

Broadcast a pre-signed Ethereum transaction via eth_sendRawTransaction. Params: raw_tx (hex-encoded RLP-signed transaction, with or without 0x prefix). Returns the resulting transaction hash as plain text. Use eth_encode_function + eth_estimate_gas + an external signer (or tenzro_signTransaction with chain_id matching the target EVM chain) to build the raw_tx.

Parameters1

raw_tx

string

required

Signed RLP-encoded transaction as hex (0x-prefixed). Build with the tenzro_signTransaction helper or any EIP-1559/legacy signer.

Raw schema

{
  "type": "object",
  "properties": {
    "raw_tx": {
      "description": "Signed RLP-encoded transaction as hex (0x-prefixed). Build with the tenzro_signTransaction helper or any EIP-1559/legacy signer.",
      "type": "string"
    }
  },
  "required": [
    "raw_tx"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "title": "EthSendRawTransactionParams"
}

Install

Tools (17)

eth_call_contracteth_encode_functioneth_estimate_gaseth_get_attestationeth_get_balanceeth_get_blocketh_get_fee_historyeth_get_gas_price

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://ethereum-mcp.tenzro.xyz/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "tenzro-ethereum": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://ethereum-mcp.tenzro.xyz/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.