cancel_purchase Early access Write Cannot be undone
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.
End the Tuyo purchase authorization and return its current authoritative state, including a charge that won a cancellation race. Cancellation does not cancel a merchant order or refund a charge. While card issuance briefly blocks cancellation, this call retries for a few seconds; if cancellation is still incomplete, call cancel_purchase again as nextAction says and never read payment details meanwhile. Managed cancellation requires fresh managerIdentity from the original signer; cancellation can remain available after grant revocation. Reconcile merchant payment before any replacement and preserve the original approval path.

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.
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