search_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.Find individual activity records, not period totals or reconciled statements. 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. Date-only boundaries include the whole end date in UTC; datetime ends are exclusive. Default sort date_desc. 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.
Exact cardTransaction.merchant.id values returned by transaction search/detail; not merchant names or raw MCCs.
Stable category codes returned by list_transaction_categories or cardTransaction.category.code.
Stable group codes returned by list_transaction_categories or cardTransaction.category.groupCode.
Four-digit merchant category codes from cardTransaction.rawMerchant.mcc; distinct from reviewed budgeting category codes.
Exact cardTransaction.card.id values returned by transaction search/detail; not last4 or purchase IDs.
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.Three-letter uppercase currency for money amountField filters. Required for money fields, forbidden for token fields.
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.
Inclusive decimal lower bound; requires amountField and its currency or tokenId. Must not exceed maxAmount.
Inclusive decimal upper bound; requires amountField and its currency or tokenId. Must be at least minAmount.
Optional operations/legs enrichment. [] requests neither optional enrichment; card settlements are already included by default.
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.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.