Sentio Connect

View saved version →

---
name: sentio-connect
description: Answer questions about tracked crypto wallets using the Sentio Connect MCP tools — USD-valued token balances, token spot prices, total portfolio value, DeFi positions, 24h/7d holding history, and adding or removing a wallet in the user's tracked list. Use whenever the user mentions a wallet address, an ENS name, a Sui address, a token price, "my wallets", or their portfolio.
---

# Sentio Connect

All data comes from the `sentio` MCP server (hosted at `https://connect.sentio.xyz/v1/mcp`).
The user signs in once via OAuth; if a tool returns an authorization error, tell the user to run
`codex mcp login sentio` (CLI) or re-authorize Sentio Connect in the app's MCP settings.

## Tools

| Tool | Use it when |
| --- | --- |
| `list_wallet_addresses` | The user says "my wallets" / "the addresses I track". Call this first to resolve which wallets exist. No arguments. |
| `get_wallet_balances` | Native + token holdings valued in USD. One wallet on one chain (`address` + `chain`), on several chains in one call (`address` + a list in `chain`; EVM chains together, or `sui_mainnet` alone), on every chain it is tracked on (`address` alone), or every tracked wallet (no arguments). Prefer one call with a chain list, or `address` alone, over one call per chain. |
| `get_token_price` | USD spot price by `symbol` (e.g. `ETH`, `SUI`), or by `address` + `chain` for a specific token: a contract address on EVM chains, a coin type such as `0x2::sui::SUI` on Sui. |
| `get_portfolio_value` | Total USD value across all tracked wallets, broken down per address and chain. No arguments. |
| `get_defi_positions` | Lending, staking, LP and reward positions across chains — one wallet (`address`) or every tracked wallet (no arguments). Prefer the no-argument form when the user has several wallets. Each position carries its `chain` id. |
| `get_token_balance_history` | The user asks how one token holding changed over the last day or week. Take `address`, `chain`, `symbol` and `token` (contract address, omitted for an EVM chain's native coin; on Sui the coin type, always required — SUI too) from a `get_wallet_balances` row; `range` is `24h` or `7d`. Points carry amount, USD price at that instant and USD value. Slow (tens of seconds) — one holding per call, never every token in a wallet. |
| `get_defi_position_history` | The user asks how one DeFi position changed over the last day or week. Take `address`, `chain`, `protocol` (its `protocolId`) and `label` from a `get_defi_positions` row; `range` is `24h` or `7d`. Values are position size at today's prices, so the curve shows deposits, withdrawals, accrued debt and rewards — not price moves. Slow — one position per call. |
| `add_wallet_address` | The user asks to track / watch / add a wallet. `address` is a `0x` EVM address or a `.eth` ENS name (resolved before saving) on EVM chains, or a 64-hex Sui address on `sui_mainnet`; `chain` defaults to `1` (Ethereum). Idempotent — re-adding a tracked address returns the existing entry. Only affects the user's own list. |
| `remove_wallet_address` | The user asks to stop tracking / untrack / remove / delete a wallet. `address` is a `0x` address, a `.eth` name or a Sui address; pass `chain` to untrack it on one chain only, omit it to untrack it everywhere. Fails with "not tracked" when nothing matched. Confirm the address and chain scope with the user before calling. Removal affects only the tracked list, never the wallet or its funds; the address can be tracked again later. |

Supported `chain` ids: Ethereum `1`, BNB Chain `56`, Base `8453`, Arbitrum `42161`, Sui `sui_mainnet`. Default is `1`. One wallet is either EVM or Sui, never both. Sui wallet addresses are 64 hex chars (`0x…`); Sui tokens are identified by coin type (`0x2::sui::SUI`) wherever a tool takes a token `address` or `token`.

## Guidance

- Prefer one `get_portfolio_value` call over looping `get_wallet_balances` when the user asks for a total.
- Report wallet holdings and DeFi positions separately. Use the returned `get_portfolio_value` total for tracked wallet holdings; do not add DeFi values to it unless the API explicitly establishes that they do not overlap.
- Pass ENS names directly to `add_wallet_address` and `remove_wallet_address`; the server resolves them. For balances, DeFi, and history, use the resolved `0x` wallet address from the tracked list or an earlier result.
- Some tools may be disabled by the user in their Sentio Connect settings ("capability disabled"). Report that plainly and point them to https://connect.sentio.xyz rather than retrying.
- Write tools require an `mcp:write` connection. If `add_wallet_address` / `remove_wallet_address` are missing from the tool list, the connection is read-only.

- If a tool returns an error, missing prices, empty history, or partial data, report that scope plainly. Never invent balances, prices, history points, or successful writes.
- History accepts only `24h` and `7d`. Ask the user to choose one when they request another period; retrieve one holding or position at a time.
- Tracking a public wallet does not establish ownership. This plugin cannot obtain private keys, swap tokens, send funds, or execute blockchain transactions.