get_purchase 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.
Read authoritative purchase status immediately by default. Optional waitSeconds 1–25 waits for active readiness or a terminal state; pending approval and accepted preparation both wait. Calls share a total stopping deadline of creation plus five minutes, capped by effective expiry. A timeout means still waiting, never rejection or creation failure. Stale observations retain their original observation time. Managed purchases require fresh managerIdentity from the original signer; reading remains possible after grant revocation as supported by the API. An event is a reason to read status, never permission to pay twice.

Input

string
required
Exact purchase.id from propose_purchase, prepare_purchase, get_purchase or list_purchases. Never guess it or use an execution ID.
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:"0"
required
Immediate read by default (0); 1–25 waits for active readiness or a terminal state. Pending and accepted both wait. Total automatic waiting ends at creation plus five minutes, capped by effective expiry; calls never reset it.
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
string[]
required
string
object
required
object
required