get_account_statement 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 a reconciled main-account statement: opening/closing boundaries, activity, yield, price change and unexplained balance. Main only; no pod selector. from required, to defaults now, maximum 366 days; timezone defaults UTC. Date-only ends include the whole day; datetime ends are exclusive. detail summary omits transactions. Transactions are oldest first; first defaults to 250, maximum 500. Continue with transactionsPage.endCursor as after, keeping period, timezone and detail unchanged.

Input

string
required
Inclusive start. A calendar date starts at midnight in timezone (default UTC). Required.
string
Exclusive datetime end; a calendar date includes the entire end day in timezone (default UTC). Defaults to now. For today a calendar end is clipped to now; future datetime ends and future days are rejected.
string
IANA calendar timezone, default UTC. Date-only reporting bounds include the entire end day; maximum reporting interval is 366 days.
integer
Page size, default 250; maximum 500.
string
transactionsPage.endCursor from the previous statement. Keep period, timezone and detail unchanged.
enum
summary returns the period, boundaries, positions, summary and meta without the transactions list. One of: full, summary.
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
Account-level totals. Conversions and vault moves reallocate between positions and are not counted as inflow or outflow; their net shows as executionEffectValue. closingValue = openingValue + inflowValue - outflowValue + yieldValue + priceChangeValue + executionEffectValue + unexplainedValue.
object[]
required
object[]
required
Every transaction dated inside the period, whatever its status, plus earlier card purchases with allocation rows recorded inside it; each with legs (include=legs). Token and vault fields are {id} references into catalog. Legs are present only where money moved; card legs are limited to rows recorded in the period.
object
required
Pagination for transactions only; boundaries, positions, summary and meta always cover the whole period.
object
required
Token and vault metadata for the references inside transactions, carried once per response.
object
required
object
required
string[]
required