Read
chain_statusChain status
Robinhood Chain (chain id 4663, gas paid in ETH) right now: latest block number and time, gas price and base fee in gwei, and which RPC answered. Use it first to confirm the chain is reachable.
No arguments.
get_balanceWallet balance
ETH and token balances of an address on Robinhood Chain with USD values where a price is known. Uses the block explorer's token list when it is available to the server; otherwise reads balanceOf on-chain for every known token (USDG, WETH, the Robinhood stock tokens and the LI.FI token list, about 400) and says so with complete:false (tokens outside that list, such as small Pons launches, are then not shown). Tokens that copy the symbol of an official token at another address are flagged lookalike and not counted in the USD total.
| Argument | Type | Meaning |
|---|
| address | string | Wallet or contract address (0x + 40 hex). |
Example arguments
{
"address": "0x15d24b87794b22c283138149560136fce2e0aca1"
}get_transactionTransaction
One transaction by hash: status (success, reverted, pending), from, to, ETH value, fee in ETH and USD, the decoded method and arguments (built-in ABIs, then the 4byte directory), token transfers read from the receipt logs, and a one-line plain-words summary.
| Argument | Type | Meaning |
|---|
| hash | string | Transaction hash (0x + 64 hex). |
Example arguments
{
"hash": "0x35c2889bd6cd5ecbd2f417f699642a858afc2ea394901ee4c9009c07ab1993ab"
}get_blockBlock
A block header: number, hash, time, transaction count, gas used and limit, base fee, and the first transactions (hash, from, to, method). Leave number empty for the latest block.
| Argument | Type | Meaning |
|---|
| number optional | string | Block number (decimal like "116217680" or hex), or "latest". Empty = latest. |
Example arguments
{
"number": "latest"
}read_contractRead contract
Calls a view function with eth_call and decodes the answer. signature is "name(inputTypes)(outputTypes)", e.g. "balanceOf(address)(uint256)", "getReserves()(uint112,uint112,uint32)" or "symbol()(string)". Supports uint/int (8 to 256), address, bool, bytes1 to bytes32, bytes, string, fixed and dynamic arrays and tuples of these. If the output types are left out, the raw return data is given. Reverts come back decoded (Error(string), Panic codes, custom error selectors).
| Argument | Type | Meaning |
|---|
| address | string | Contract address. |
| signature | string | Function signature with output types, e.g. "balanceOf(address)(uint256)". Output part optional. |
| args optional | array | Arguments in order. Numbers as decimal strings, addresses as 0x strings, bools as true/false, arrays/tuples as JSON arrays. |
| block optional | string | Block number or "latest" (default). |
Example arguments
{
"address": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"signature": "totalSupply()(uint256)",
"args": []
}get_activityAddress activity
The latest transactions of an address (newest first) with a one-line summary each: method, counterparty, ETH value, status and age. An address history needs a block-explorer index (a chain node cannot list it): the tool uses the Blockscout API, and when that API is not available to the server it returns an error with the sent-transaction count and the explorer link instead of guessing.
| Argument | Type | Meaning |
|---|
| address | string | Wallet or contract address. |
| limit optional | integer | How many transactions (1 to 25, default 10). |
Example arguments
{
"address": "0x15d24b87794b22c283138149560136fce2e0aca1",
"limit": 10
}Explain & guard
explain_transactionExplain a transaction
Explains a transaction in plain words. Reads and decodes it first (same data as get_transaction), then an AI model writes a short paragraph using ONLY that decoded data. If the AI is unavailable, a deterministic explanation is returned instead (source:"template").
| Argument | Type | Meaning |
|---|
| hash | string | Transaction hash. |
Example arguments
{
"hash": "0x35c2889bd6cd5ecbd2f417f699642a858afc2ea394901ee4c9009c07ab1993ab"
}simulate_transactionSimulate a transaction
Dry-runs a transaction against the latest block (eth_call + eth_estimateGas), nothing is sent. Returns: would it revert and why (Error(string), Panic, custom error), gas and fee in ETH and USD, the decoded intent, balance changes when they can be derived (ETH value, ERC-20 transfer/transferFrom, approve, WETH deposit/withdraw) and risk flags: unlimited approval, setApprovalForAll, Permit2 approval, unverified target, calldata sent to a wallet (EOA), target deployed in the last 24 h, value sent to a contract that rejects it, known lookalike token. Leave "to" empty to simulate a contract deployment.
| Argument | Type | Meaning |
|---|
| from | string | Sender address (the wallet that would sign). |
| to optional | string | Target address. Empty or null = contract creation. |
| data optional | string | Calldata as 0x hex (default 0x). |
| value optional | string | ETH to send: wei as 0x hex or a decimal integer string, or ETH with a unit like "0.01 ETH". Default 0. |
Example arguments
{
"from": "0x15d24b87794b22c283138149560136fce2e0aca1",
"to": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"data": "0x095ea7b3000000000000000000000000b477751b76cf82d00a686a1232f5fcd772414af3ffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffffff",
"value": "0"
}check_addressCheck an address
What an address is: a wallet (EOA), an EIP-7702 smart wallet (code 0xef0100… = still a wallet) or a contract; verified source and contract name, first-seen age, transaction count, ETH balance, token info if it is a token, Pons launch info if it was launched on Pons, and plain-word flags.
| Argument | Type | Meaning |
|---|
| address | string | Any address. |
Example arguments
{
"address": "0xB477751B76CF82d00a686A1232f5fCD772414Af3"
}scan_tokenScan a token
Safety scan of an ERC-20 on Robinhood Chain: name, symbol, decimals, supply; Pons launch data when it is a Pons token (deployer, creator tax, whitelist, stage, graduated, creator earnings); top-10 holder concentration and the deployer's holding (Blockscout); price, liquidity and volume (DexScreener); verified source; lookalike check. Score 0 to 100 starts at 100 and subtracts: unverified source -15 (not applied to Pons launches, whose code is the launchpad's), top-10 holders (excluding pools, burn and the curve) over 50% -20 or over 30% -10, deployer holds over 10% -15 or over 5% -8, Pons whitelisted wallets hold over 20% -15 or over 10% -8 (read on-chain), liquidity under $1,000 -20 or under $10,000 -10 (not applied while still on the Pons bonding curve), creator tax over 5% -15 or over 0% -5, whitelist launch -5, token younger than 24 h -10, lookalike of an official symbol -40, top-holder list unavailable (it needs the block explorer API) -5, marked partial. Every deduction is listed in reasons. A score is a summary of these checks, not advice.
| Argument | Type | Meaning |
|---|
| address | string | Token contract address. |
Example arguments
{
"address": "0x51250b135174ca09450ec01c4aff73cf69dbb590"
}get_approvalsToken approvals
Token approvals an owner has given (who can spend their tokens), with the CURRENT allowance read on-chain, unlimited flags and a risk level. With the block explorer: found from the owner's approve / setApprovalForAll / Permit2 transactions (latest 200), including NFT operators and unknown spenders. Without it: checks the tokens the owner holds (plus USDG and WETH) against the routers seen on Robinhood Chain and Permit2 only, marked partial:true with a note. Approvals made through permit signatures can be missing in both modes. Use prepare_revoke to remove one.
| Argument | Type | Meaning |
|---|
| address | string | Owner wallet address. |
Example arguments
{
"address": "0x15d24b87794b22c283138149560136fce2e0aca1"
}Markets
pons_launchesPons launches
Token launches on the Pons launchpad on Robinhood Chain: name, symbol, address, stage (curve or graduated), market cap and volume in USD, price, creator tax, whitelist, deployer and age. Sort by newest, market cap or volume; optional search text.
| Argument | Type | Meaning |
|---|
| sort optional | new | marketCap | volume | Order (default new). |
| limit optional | integer | 1 to 25 (default 10). |
| q optional | string | Optional search by name or symbol. |
Example arguments
{
"sort": "marketCap",
"limit": 10
}token_priceToken price
USD price of a Robinhood Chain token by address or symbol (ETH, WETH, USDG, stock tokens like AAPL, or any symbol listed on Pons): price, 24h change, liquidity, 24h volume and the main pool (DexScreener), with the LI.FI token list as a fallback. When a symbol matches several tokens, the official one is used and the others are listed.
| Argument | Type | Meaning |
|---|
| token | string | Token address (0x…) or symbol, e.g. "USDG", "AAPL", "ETH". |
Example arguments
{
"token": "AAPL"
}perps_marketsLighter perps
Perpetual futures on Lighter's Robinhood Chain venue (public API): last and mark price, 24h change, 24h volume, open interest and the current hourly funding rate. Give a symbol (BTC, ETH, NVDA, TSLA...) for one market, or nothing for all of them.
| Argument | Type | Meaning |
|---|
| symbol optional | string | Market symbol, e.g. "BTC" or "NVDA". Empty = all markets. |
Example arguments
{
"symbol": "ETH"
}Prepare (you sign)
prepare_transferPrepare a transfer
Builds a transfer of ETH or an ERC-20 (USDG, a stock token, any token address) as a signing link. Amount is in human units (e.g. "25.5"); decimals are read on-chain. If from is given, the transfer is simulated and the balance checked. Nothing is sent: give the user the link, they open it, check it and sign in their own wallet.
| Argument | Type | Meaning |
|---|
| from optional | string | Sender wallet (optional, enables the balance check and simulation). |
| to | string | Recipient address. |
| amount | string | Amount in human units, e.g. "0.01" or "25". "max" is not supported. |
| token optional | string | "ETH" (default), a token symbol (USDG, AAPL...) or a token address. |
Example arguments
{
"from": "0x15d24b87794b22c283138149560136fce2e0aca1",
"to": "0x000000000000000000000000000000000000dEaD",
"amount": "1",
"token": "USDG"
}prepare_swapPrepare a swap
Gets a live LI.FI quote for a swap on Robinhood Chain (same chain, e.g. ETH to USDG or USDG to a stock token) and builds a signing link with an approve step first when the token allowance is too low. Amount is in human units of the token you sell. The quote expires in a few minutes, so the link is valid for 10 minutes. Shows the expected and minimum amount out, the route and the fees.
| Argument | Type | Meaning |
|---|
| from | string | Wallet that will sign and receive. |
| sell | string | Token to sell: "ETH", a symbol (USDG, AAPL...) or an address. |
| buy | string | Token to buy: "ETH", a symbol or an address. |
| amount | string | Amount of the sell token in human units, e.g. "0.01". |
| slippage optional | number | Max slippage in percent (default 0.5). |
Example arguments
{
"from": "0x15d24b87794b22c283138149560136fce2e0aca1",
"sell": "ETH",
"buy": "USDG",
"amount": "0.001",
"slippage": 0.5
}prepare_revokePrepare a revoke
Builds a signing link that removes an approval: approve(spender, 0) for an ERC-20, or setApprovalForAll(operator, false) for an NFT collection (detected on-chain). Reads the current allowance first and says if there is nothing to revoke.
| Argument | Type | Meaning |
|---|
| owner | string | Wallet that gave the approval (it signs the revoke). |
| token | string | Token or NFT contract address. |
| spender | string | Spender or operator to remove. |
Example arguments
{
"owner": "0x15d24b87794b22c283138149560136fce2e0aca1",
"token": "0x5fc5360D0400a0Fd4f2af552ADD042D716F1d168",
"spender": "0xB477751B76CF82d00a686A1232f5fCD772414Af3"
}Build
prepare_token_deployPrepare a token deploy
Builds a signing link that deploys a new fixed-supply ERC-20 from Toolhood's open-source contract (compiled once with solc, source on /docs): 18 decimals, the whole supply minted to owner (or to the signer when owner is empty), no owner powers, no mint, no tax, no pause. Supply is in whole tokens. The deploy is estimated on-chain when owner is given. After signing, the user can ask their AI to read the new token back with scan_token.
| Argument | Type | Meaning |
|---|
| name | string | Token name, e.g. "Harbor Coin". |
| symbol | string | Ticker, letters and digits, e.g. "HARBOR". |
| supply | string | Total supply in whole tokens, e.g. "1000000000" (1 to 10^30). |
| owner optional | string | Receives the whole supply and is the expected signer. Optional: empty = whoever signs. |
Example arguments
{
"name": "Harbor Coin",
"symbol": "HARBOR",
"supply": "1000000000",
"owner": "0x15d24b87794b22c283138149560136fce2e0aca1"
}