propose_convert Production Write
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.
Create a buy, sell, swap or conversion approval request; this does not execute a trade. Spend exact amountIn; received output remains an estimate. First call quote_convert with identical payer, assets, networks and amount, disclose the estimate, and obtain agreement for a value-loss warning above 5%. This user-approval path needs no signer or management setup. To pay from a pod you already manage, read all pages of list_managed_pods with the same signer and use prepare_send or prepare_convert instead; never prepare to probe authority. Each call creates a separate request; after an unknown outcome, check list_proposals instead of repeating it. Read get_proposal for the decision, then get_transaction for settlement and actual output.

Input

object
required
Owned token balance to spend in the payer scope.
object
required
Token/network to receive; estimated output only.
string
required
Exact input to spend in whole units of from, at most its token decimals from get_asset/get_holding metadata. Reject excess precision; never round. Never the requested receive amount.
string
Payer accountId from list_pods or holdings.pods.items[].pod. Omit for main; keep identical between quote and proposal.
integer
Approval lifetime in seconds, 60–86400; omission uses 900.
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
"user_approval"
required
"not_established"
required
object
required
string[]
required