prepare_convert Early access Write
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.
Prepare a buy, sell, swap or conversion under existing pod management without another owner approval. Requires secure code execution and tuyo-signer. First use list_managed_pods with the same signer and follow all pages; never prepare to probe authority. Main or unavailable access uses the matching propose tool. First quote_convert with identical payer, assets, networks and amountIn; disclose estimated output and obtain agreement for value loss above 5%. Exact input only. Sign the unchanged signing object and call submit_execution; preparation moves no funds. Recover an unknown result with list_executions/get_execution before another preparation.

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
required
Exact managed pod accountId from all pages of list_managed_pods; main is not supported. Keep the same payer for holdings and quote reads.
string
required
Fresh identity token from tuyo-signer identity (get_manager_signer explains setup), using the original approved signing key. Never include credentials in reason.
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
"management"
required
enum
required
One of: not_established, execution_succeeded.
"not_established"
required
object
required
string[]
required