summarize_transactions 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.
Compute period-wide spending/activity totals independently of the current group page. Requires from/to and metrics; maximum 366 days. Calendar dates include the whole end day in timezone (default UTC); datetime ends are exclusive. Choose statuses for the activity measured. 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. 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.
string
string
required
Inclusive start. A calendar date starts at midnight in timezone (default UTC).
string
required
Exclusive datetime end; a calendar date includes the entire end day in timezone (default UTC). Required.
enum[]
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.
string[]
Exact cardTransaction.merchant.id values returned by transaction search/detail; not merchant names or raw MCCs.
string[]
Stable category codes returned by list_transaction_categories or cardTransaction.category.code.
string[]
Stable group codes returned by list_transaction_categories or cardTransaction.category.groupCode.
string[]
Four-digit merchant category codes from cardTransaction.rawMerchant.mcc; distinct from reviewed budgeting category codes.
string[]
Exact cardTransaction.card.id values returned by transaction search/detail; not last4 or purchase IDs.
enum
Native amount selector. Required when currency, tokenId, minAmount, maxAmount or amount sorting is supplied. Money fields require currency and forbid tokenId; action.amount, action.amountOut and deposit.amount require tokenId and forbid currency. No historical USD conversion. One of: cardTransaction.amount, cardTransaction.coverage.customerShare, action.amount, action.amountOut, action.fiatCurrencyAmountOut, deposit.amount, virtualBankAccountTransaction.sentAmount.
string
Three-letter uppercase currency for money amountField filters. Required for money fields, forbidden for token fields.
string
Amount unit selector: Concrete token ID from a returned token.id, identifying a token on a numeric chain; nullable IDs stay unresolved. Required for token amount fields; forbidden with currency.
string
Inclusive decimal lower bound; requires amountField and its currency or tokenId. Must not exceed maxAmount.
string
Inclusive decimal upper bound; requires amountField and its currency or tokenId. Must be at least minAmount.
enum[]
Optional operations/legs enrichment. [] requests neither optional enrichment; card settlements are already included by default.
enum
Default date_desc; amount sorting requires amountField and its explicit currency or tokenId. Keep sort unchanged during pagination. One of: date_desc, date_asc, amount_desc, amount_asc.
integer
Page size, default 25; maximum 100.
string
Continue with page.endCursor as after, keeping account scope, filters, includes, time and sort unchanged.
enum[]
required
enum[]
string
IANA calendar timezone, default UTC. Date-only reporting bounds include the entire end day; maximum reporting interval is 366 days.
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
required
object
required
string[]
required