list_purchases Early access Read only
This tool is in early access. It is available at https://mcp.tuyo.com/mcp-early-access to accounts with Pods early access. See Early access.

Description

The model reads this text to decide when and how to call the tool.
List this OAuth connection’s purchases newest first across all lifecycle states by default. Use after unknown creation outcomes or to recover exact IDs. Managed purchases require fresh managerIdentity from the original signer. Follow pages with unchanged filters; report multiple matches instead of choosing one. Results include original checkout, payer and approval path. An empty list does not prove a timed-out write failed; report unresolved outcomes instead of automatically creating again.

Input

enum | "any"
default:"\"any\""
required
Default any includes every lifecycle state; never recover only pending purchases.
string
Filter by this pod payer; omission includes main and pods accessible to this connection/signing key.
string
Fresh identity token from the original tuyo-signer key. This credential maps to the existing Tuyo-Agent-Identity header; never put it in reason or conversation.
integer
default:"20"
required
Newest-first purchases per page, default 20, maximum 50.
string
page.endCursor from list_purchases; preserve status, payer, first page size and manager signing key throughout pagination.
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
string[]
required