quote_convert Production Read only
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.
Estimate a buy, sell, swap or conversion without creating an approval request or moving funds. Use the identical payer, from/to assets and networks, and exact amountIn for propose_convert. Returns all available fee and value-loss facts, including small fees; feeProminent preserves the presentation threshold. Output is estimated, never a promised exact receive amount. A loss above 5% warns: disclose it and obtain agreement before proposing, or offer another route or amount.

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.
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.
"convert"
required
object
required
object
required
object
required
string
required
Estimated value loss in percentage points, as a decimal string; null means unavailable. Values above 5 warn. Can be null.
string
required
object
required
boolean
required
string[]
required
string[]
required