๐ ๏ธ Tools reference
Every MCP tool Sentio Connect exposes, with arguments and results
Sentio Connect exposes the tools below. Most are read-only; the write tools change your tracked-address list and need a connection with the mcp:write scope. Each tool belongs to a capability you can turn off.
You don't call these tools yourself โ your assistant picks them based on your question. This page helps you understand what the assistant can do and write better prompts.
| Tool | Capability | Access | Arguments |
|---|---|---|---|
get_wallet_balances | Token balances | read-only | chain?, address? |
get_token_price | Token prices | read-only | symbol?, address?, chain? |
get_token_history_price | Token prices | read-only | symbol?, address?, chain?, timestamps |
get_portfolio_value | Portfolio value | read-only | โ |
open_portfolio | Portfolio value | read-only | โ |
list_wallet_addresses | Tracked addresses | read-only | โ |
get_defi_positions | DeFi positions | read-only | address? |
get_token_balance_history | Token balances | read-only | address, chain, symbol, token?, range? |
get_defi_position_history | DeFi positions | read-only | address, chain, protocol, label, group?, range? |
add_wallet_address | Tracked addresses | write | address |
remove_wallet_address | Tracked addresses | write, destructive | address |
call_rpc | Blockchain RPC | read-only | chain, method, params? |
Arguments marked ? are optional.
Common arguments
| Argument | Format |
|---|---|
address | EVM: a 0x address (40 hex chars) or an ENS name such as vitalik.eth. Sui: a 0x address (64 hex chars). |
chain | 1 (Ethereum), 10 (Optimism), 56 (BNB Chain), 143 (Monad), 8453 (Base), 42161 (Arbitrum), 43114 (Avalanche) or sui_mainnet. |
token | EVM: the token contract address (omit for the chain's native coin). Sui: the coin type, such as 0x2::sui::SUI โ always required on Sui. |
range | 24h or 7d. Defaults to 24h. |
A tracked wallet is an address, not an (address, chain) pair: an EVM address covers every supported EVM chain, and a Sui address covers Sui. Newly supported chains are picked up automatically.
Wallet & balances
get_wallet_balances
Capability: Token balances ยท read-only
Native coin and token balances, each valued in USD.
| Call with | Returns |
|---|---|
address + chain | That wallet on that chain |
address + a list of chains | That wallet on several chains in one call (EVM chains together, or sui_mainnet alone) |
address only | That wallet on every chain of its kind (every EVM chain, or Sui) |
| No arguments | Every tracked wallet, listing only the chains each one holds tokens on |
Each token row includes symbol, address, decimals, amount, price and value. Balances only โ DeFi positions are in get_defi_positions and get_portfolio_value.
get_token_balance_history
Capability: Token balances ยท read-only
How the USD value of one wallet token changed over the last 24 hours or 7 days.
- Arguments:
address,chain,symbol,token(see above),rangeโ identify the holding from aget_wallet_balancesrow - Returns:
points, each withtimestampandvalueUsd, valued at the price at that instant - Ordinary tokens come back as hourly points from stored history and return quickly;
amountandpriceUsdare not reported for them. - A chain's native coin and its wrapped twin (ETH, WETH, โฆ) are read by replaying the portfolio at each point on a coarser grid (every 2 hours for
24h, every 12 hours for7d), withamountandpriceUsdreported. This takes tens of seconds.
get_portfolio_value
Capability: Portfolio value ยท read-only
Total USD value across every tracked wallet: token balances plus DeFi positions (net of debt). Takes no arguments.
- Returns:
totalValue=walletValue+defiValue, overall and per address and chain. - Receipt and LP tokens already counted by a DeFi position are not counted again as wallet balances.
- A row with
walletValue: nullis a chain where the address holds DeFi positions but whose wallet balances Sentio Connect doesn't read.
open_portfolio
Capability: Portfolio value ยท read-only
Opens your portfolio as an interactive view: token balances and DeFi positions of every tracked wallet, with filters and per-holding history charts. Takes no arguments and returns the same data as get_portfolio_value.
Assistants use it when you ask to open, show or explore your portfolio, and get_portfolio_value for a quick figure. Claude opens the view in its side panel; other hosts that support interactive cards render it inline.
list_wallet_addresses
Capability: Tracked addresses ยท read-only
The wallets you track, each with the chains it covers (chains). Takes no arguments.
add_wallet_address
Capability: Tracked addresses ยท write (mcp:write)
Start tracking a wallet from the conversation.
- Arguments:
addressโ a0xEVM address, a.ethname, or a Sui address. No chain is needed: the wallet covers every supported chain of its kind, listed in the result'schains. - ENS names are resolved before saving; the result includes
ensName. - Idempotent: adding a wallet you already track returns the existing entry, flagged
alreadyTracked.
remove_wallet_address
Capability: Tracked addresses ยท write (mcp:write), destructive
Stop tracking a wallet from the conversation, on every chain it covers.
- Arguments:
addressโ a0xaddress, a.ethname, or a Sui address. - Returns the removed entry, or a "not tracked" error when the address isn't tracked.
- The tool is marked destructive, so assistants typically ask you to confirm before running it.
Prices
get_token_price
Capability: Token prices ยท read-only
USD spot price for a token.
- By symbol:
symbol, for exampleETHorSUI - By token:
address+chainโ a contract address on EVM chains, or a coin type such as0x2::sui::SUIon Sui
get_token_history_price
Capability: Token prices ยท read-only
Historical USD prices for one token at the instants you ask for. No wallet or tracked holding is required.
- Arguments:
symbolalone, oraddress+chain(as inget_token_price);timestampsโ 1 to 100 ISO 8601 date-times withZor a timezone offset, none in the future - Returns:
prices, each withprice,timestampand an optionalsource. The timestamp is the actual sample time, which can differ from the instant requested. - Instants without a sample are left out; an empty list means no historical price was found, never a price of zero.
DeFi positions
get_defi_positions
Capability: DeFi positions ยท read-only
Lending, staking, liquidity and reward positions across every chain the Sentio portfolio API covers.
- Arguments: optional
address. Omit it to get every tracked wallet in one call. - Returns: per-protocol totals (asset, debt and reward value) and individual positions, each with
protocolId,protocolName,chain,label,valueUsdand its asset / debt / reward components.
get_defi_position_history
Capability: DeFi positions ยท read-only
How the size of one DeFi position changed over the last 24 hours or 7 days, valued at today's prices โ so the curve shows deposits, withdrawals, accrued debt and rewards, not price moves.
- Arguments:
address,chain,protocol(the position'sprotocolId),label, optionalgroup(the position's id โ labels can repeat within a protocol, such as one "Lending" row per market),range - One portfolio scan per point (every 2 hours for
24h, every 12 hours for7d), so it takes tens of seconds and runs for one position at a time.
Blockchain RPC
call_rpc
Capability: Blockchain RPC ยท read-only
Runs one read-only JSON-RPC method against a chain node through Sentio's RPC service, for on-chain data the other tools don't cover: contract storage or code, an eth_call to a view function, a transaction or receipt, a block, event logs.
- Arguments:
chainโ an EVM chain id from the list above (Sui is not supported);methodโ the node's method name;paramsโ its positional parameter array, exactly as the node expects (hex quantities,0xaddresses) - Returns:
{ chain, method, result }, with values raw (hex, not scaled by token decimals) - Methods: standard Ethereum JSON-RPC read methods (
eth_call,eth_getLogs,eth_getTransactionReceipt, โฆ). See the Ethereum JSON-RPC API reference for each method's parameters and results.
Sending transactions, signing, and debug / trace / filter methods are always rejected. eth_call and eth_estimateGas are capped at 10M gas. eth_getLogs needs a blockHash, or hex fromBlock and toBlock at most 1,000 blocks apart. Results over 100k characters are refused rather than truncated โ narrow the request.
Interactive cards
In hosts that support MCP Apps, such as Claude and ChatGPT, get_wallet_balances, get_portfolio_value and get_defi_positions render as interactive cards, and open_portfolio renders the full portfolio view. Click a row to chart that holding's history without leaving the conversation โ the card calls get_token_balance_history or get_defi_position_history for you. In Claude, a card can also expand into the side panel. Other hosts, such as Codex, show the same data as text.