prepare_vault_withdrawal 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 withdrawal of an exact amount of an investment vault’s asset from a managed pod’s position back to its balance, 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. Vault moves are for investment vaults: vaultId from search_vaults items[].id or an owned holding.vault.id. Cash interest is not a vault; only the user changes it in the Tuyo app. A deposit spends exactly amount of the vault’s asset from the account’s balance into the vault; a withdrawal moves exactly amount of it from the account’s position back to that account’s balance. amount is in whole units of the vault’s asset, at most its decimals; the fee is paid out of it. When the vault’s asset is the asset of the account’s cash holding (holdings kind cash), a deposit spends that cash and a withdrawal returns to it: tell the user the amount with $ or €, never the ticker. Deposits need depositStatus available and a balance that covers amount; withdrawals need a position that covers it. Read both in the same account first. 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

string
required
Exact managed pod accountId from all pages of list_managed_pods; main is not supported. Read holdings in the same pod.
string
required
Exact investment vault id: search_vaults items[].id, or holding.vault.id of an owned investment. Never a cash balance.
string
required
Exact amount of the vault’s asset (asset in search_vaults), in whole units, at most that asset’s decimals, such as 25. The fee is paid out of it. Reject excess precision; never round.
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