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
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.
Concrete token ID from a returned token.id, identifying a token on a numeric chain; nullable IDs stay unresolved.
Exact vault.id values returned by search_vaults or an investment holding.vault.id; filters positions/activity linked to those vaults.
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.
Default true: enrich current main holdings with separate pod values, independently of main holding filters. Ignored for at or a selected account.
Historical snapshot instant. With at, include accepts only yield (omitted historically); earnings and current pod rollup are unavailable.
Continue with page.endCursor as after, keeping account scope, filters, includes, time and sort unchanged.
Cross-network asset ID from search_assets items[].id, holding.asset.id or token.assetId; never infer from a symbol.
Supported network slugs from returned supportedNetworks[].id or network.id. Mutually exclusive with chainIds where both are offered.
Numeric chain references from returned token.chainId or operations[].chainId, including external/historical chains. Mutually exclusive with networkIds.
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.
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.