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
Exact managed pod accountId from all pages of list_managed_pods; main is not supported. Read holdings in the same pod.
Exact investment vault id: search_vaults items[].id, or holding.vault.id of an owned investment. Never a cash balance.
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.
Fresh identity token from tuyo-signer identity (get_manager_signer explains setup), using the original approved signing key. Never include credentials in reason.
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.