get_holdings Production Read only
Production (https://mcp.tuyo.com/mcp) serves an earlier version of this tool. This page shows the early-access version.

Description

The model reads this text to decide when and how to call the tool.
Read an account holdings snapshot and whole-account/matching known-value subtotals. Omit accountId for the main account; use a pod accountId returned by list_pods or holdings.pods.items[].pod. A username is not an accountId. Current main reads include separate pod values by default; historical and pod reads omit that rollup. Include earnings for actual gains. first defaults to 25, maximum 100. Continue with page.endCursor as after, keeping account scope, filters, includes, time and sort unchanged.

Input

string
Omit accountId for the main account; use a pod accountId returned by list_pods or holdings.pods.items[].pod. A username is not an accountId.
enum[]
string[]
Concrete token ID from a returned token.id, identifying a token on a numeric chain; nullable IDs stay unresolved.
string[]
Exact vault.id values returned by search_vaults or an investment holding.vault.id; filters positions/activity linked to those vaults.
enum[]
Optional enrichments, default yield; a supplied array must be nonempty. With at only yield is accepted and historical yield is omitted. earnings returns actual gains, not projected rates.
boolean
default:"true"
required
Default true: enrich current main holdings with separate pod values, independently of main holding filters. Ignored for at or a selected account.
string
Historical snapshot instant. With at, include accepts only yield (omitted historically); earnings and current pod rollup are unavailable.
integer
Page size, default 25; maximum 100.
string
Continue with page.endCursor as after, keeping account scope, filters, includes, time and sort unchanged.
string[]
Cross-network asset ID from search_assets items[].id, holding.asset.id or token.assetId; never infer from a symbol.
enum[]
Supported network slugs from returned supportedNetworks[].id or network.id. Mutually exclusive with chainIds where both are offered.
integer[]
Numeric chain references from returned token.chainId or operations[].chainId, including external/historical chains. Mutually exclusive with networkIds.
string
Optional short explanation of the user goal. Do not include secrets or full addresses.

Output

The structured result is { data, meta }. meta has the requestId and the asOf time. These are the fields of data. An error returns { error, meta }; see Errors.
object
required
object[]
required
object
required
object
required
object
object
object
In preview. Value held in the user’s Pods, in Tuyo order (new Pods last). Pod values are not included in summary or items. The total across the main account and Pods is summary.portfolioValue plus pods.value. Read a Pod’s holdings with accountId. Omitted when reading a Pod’s holdings.
object
required
object
required
string[]
required
object
required