propose_vault_deposit 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.
Create a request for the user to approve in Tuyo: deposit an exact amount of an investment vault’s asset from the main account or a pod into that vault. This moves no money until they approve. 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. This user-approval path needs no signer or management setup. To move money in a pod you already manage, read all pages of list_managed_pods with the same signer and use prepare_vault_deposit or prepare_vault_withdrawal instead; never prepare to probe authority. Each call creates a separate request; after an unknown outcome, check list_proposals with kind vault_deposit instead of repeating it. Read get_proposal for the decision and get_transaction for settlement.

Input

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
Pod accountId from list_pods whose money moves. Omit for the main account; read holdings in the same account.
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