https://mcp.tuyo.com/mcp. Early access tools are only on https://mcp.tuyo.com/mcp-early-access. See Early access.
Write tools change something. A send, conversion or purchase still needs the user’s approval in the Tuyo app, unless the AI is the manager of a pod.
Account and pods
| Tool | What it does | |
|---|---|---|
get_account_status | Read readiness, verification, required actions and product availability. | Production Read only |
list_pods | List owned pods and their accountIds, in Tuyo order (new pods last). | Early access Read only |
create_pod | Create a Pod: a space in Tuyo with its own balance for online purchases and investing. | Early access Write |
update_pod | Rename one of the user’s pods or change its color or icon, by accountId from list_pods. | Early access Write |
delete_pod | Delete one of the user’s pods, by accountId from list_pods, only when the user asks. | Early access Write Cannot be undone |
propose_pod_card | Ask the user to create a card that spends from a selected pod. | Early access Write |
get_pod_card_proposal | Read the user’s answer to a request from propose_pod_card, by the id it returned. | Early access Read only |
Holdings, assets and vaults
| Tool | What it does | |
|---|---|---|
get_holdings | Read an account holdings snapshot and whole-account/matching known-value subtotals. | Production Read only |
get_holding | Explain a returned holding, including previously held positions, with the same accountId and at scope. | Production Read only |
search_assets | Search supported assets by text, exact coinGeckoId, category or supported network. | Production Read only |
get_asset | Read an exact supported assetId from search_assets, holding.asset.id or token.assetId. | Production Read only |
search_vaults | Browse available investments by asset, risk and deposit availability. | Production Read only |
get_vault | Explain an exact vaultId, including retired owned vaults. | Production Read only |
Transactions
| Tool | What it does | |
|---|---|---|
search_transactions | Find individual activity records, not period totals or reconciled statements. | Production Read only |
summarize_transactions | Compute period-wide spending/activity totals independently of the current group page. | Production Read only |
get_transaction | Explain an exact transactionId from search_transactions or a statement, in the same account scope. | Production Read only |
get_account_statement | Read a reconciled main-account statement: opening/closing boundaries, activity, yield, price change and unexplained balance. | Production Read only |
list_transaction_categories | List budgeting category/group codes and taxonomy version for transaction search and summaries. | Production Read only |
Deposits and bank accounts
| Tool | What it does | |
|---|---|---|
get_crypto_deposit_instructions | Read direct crypto deposit instructions for main or a selected account, including its exact address and supported-network allowlist. | Production Read only |
list_bank_deposit_accounts | Read inbound virtual bank details for main or a selected account, with currencies available to open and any unavailability reason. | Production Read only |
create_bank_deposit_account | Open an inbound virtual bank account immediately, without a proposal or approval step, only for a currency listed available by list_bank_deposit_accounts in the same scope. | Early access Write |
close_bank_deposit_account | Close a pod bank deposit account immediately, without a proposal, only when the user asks. | Early access Write Cannot be undone |
list_external_bank_accounts | Read saved outbound bank recipients belonging to the user, another person or a business, with masked account numbers and authoritative managerExecutionEligibility. | Production Read only |
add_external_bank_account | Save a bank recipient immediately after bank validation, without a proposal or approval step; this moves no money. | Production Write |
Proposals
| Tool | What it does | |
|---|---|---|
propose_send | Create a send approval request for the user to review in Tuyo; this does not execute payment. | Production Write |
quote_convert | Estimate a buy, sell, swap or conversion without creating an approval request or moving funds. | Production Read only |
propose_convert | Create a buy, sell, swap or conversion approval request; this does not execute a trade. | Production Write |
propose_vault_deposit | 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. | Early access Write |
propose_vault_withdrawal | Create a request for the user to approve in Tuyo: withdraw an exact amount of an investment vault’s asset from the main account’s or a pod’s position back to that account’s balance. | Early access Write |
get_proposal | Read the current send, conversion or vault move approval request without approving or executing it. | Early access Read only |
list_proposals | List the approval requests this connection created, newest first, without approving or executing anything. | Early access Read only |
Purchases
| Tool | What it does | |
|---|---|---|
propose_purchase | Create a purchase approval request in Tuyo; issuance requires user approval and merchant payment is separate. | Early access Write |
prepare_purchase | Start card issuance using existing pod management access, without another per-purchase owner approval; merchant checkout is still separate. | Early access Write |
get_purchase | Read authoritative purchase status immediately by default. | Early access Read only |
get_purchase_payment_details | Reveal encrypted credentials for an active purchase. | Early access Write |
cancel_purchase | End the Tuyo purchase authorization and return its current authoritative state, including a charge that won a cancellation race. | Early access Write Cannot be undone |
list_purchases | List this OAuth connection’s purchases newest first across all lifecycle states by default. | Early access Read only |
Pod management
| Tool | What it does | |
|---|---|---|
get_manager_signer | Get on-demand secure tuyo-signer installation, key creation, identity refresh and signing guidance when the user asks to become or act as a pod manager. | Early access Read only |
propose_pod_management | Create a request for the user to approve management of their selected pod in Tuyo. | Early access Write |
get_pod_management_proposal | Read the exact management proposal immediately by default, with fresh managerIdentity from the original signer. | Early access Read only |
list_pod_management_proposals | Find management requests for this original signer and OAuth connection after a lost response or interruption, including approved, declined and expired history. | Early access Read only |
list_managed_pods | List current active management for the original signer and this OAuth connection, with exact accountId, proposalId and managementExpiresAt. | Early access Read only |
revoke_pod_management | Give up the exact management approval the user asked to remove, using proposalId from list_managed_pods or a known management proposal. | Early access Write Cannot be undone |
Managed executions
| Tool | What it does | |
|---|---|---|
prepare_send | Prepare a send under existing pod management, without another owner approval. | Early access Write |
prepare_convert | Prepare a buy, sell, swap or conversion under existing pod management without another owner approval. | Early access Write |
prepare_vault_deposit | Prepare a deposit of an exact amount of an investment vault’s asset from a managed pod’s balance into that vault, under existing pod management, without another owner approval. | Early access Write |
prepare_vault_withdrawal | 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. | Early access Write |
submit_execution | Submit a signature for the exact execution from prepare_send, prepare_convert, prepare_vault_deposit or prepare_vault_withdrawal. | Early access Write Cannot be undone |
get_execution | Read an exact send, conversion or vault move execution using its executionId from a prepare tool or list_executions and fresh managerIdentity from the original signer. | Early access Read only |
list_executions | Find this signer and OAuth connection’s send, conversion and vault move executions after a lost response or interruption; includes historical operations after revocation. | Early access Read only |
Webhooks
| Tool | What it does | |
|---|---|---|
list_webhook_events | Find the events and accepted filters for sending Tuyo activity to a public HTTPS receiver with create_webhook. | Early access Read only |
list_webhooks | List webhooks for this connection, newest first. | Early access Read only |
create_webhook | Create a plain webhook to send selected Tuyo events to the user’s public HTTPS receiver. | Early access Write |
delete_webhook | Remove one webhook by its exact id from list_webhooks or create_webhook. | Early access Write Cannot be undone |
Tuyo app and feedback
| Tool | What it does | |
|---|---|---|
open_tuyo | Open the user’s main-account Tuyo wallet, activity, holding or transaction in a host that supports MCP Apps. | Early access Read only |
open_tuyo_panel | Open the main-account Tuyo wallet in a panel beside the conversation when the user asks to keep it open there. | Early access Read only |
load_tuyo_page | Provide one page of the main-account Tuyo wallet to the embedded app. | Early access Read only Called by the Tuyo app |
search_tuyo_mentions | Return main-account holding and transaction links for the host’s composer @ menu. | Early access Read only Called by the Tuyo app |
feature_request | When a real user task reveals an unmet tool, data or product need, proactively send one sanitized request to the Tuyo team. | Early access Write |