create_pod 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 Pod: a space in Tuyo with its own balance for online purchases and investing. The user can also give an AI agent permission to manage the Pod for them. Creation takes effect immediately, without approval, so create one only when the user asks or agrees. Use a short name (1 to 24 characters) and a fitting color and icon from the allowed values. Each call creates a separate pod, even with identical settings; after an unknown outcome, check list_pods instead of creating again. Limits: 10 pods at once, 15 created in any 30 days and 2,000 in a lifetime, deleted pods included. A limit error says what to tell the user; deleting an empty pod frees an active slot.

Input

string
Name shown in Tuyo, 1 to 24 characters.
enum
The pod’s colour in Tuyo. One of: lilac, lime, sky, peach, butter, mint, rose, aqua.
enum
The pod’s icon in Tuyo; pick the one closest to its purpose. One of: trip, home, wallet, fire, bank, taxes, bills, goals, wishlist, emergency, abroad, business, eyes, treats.
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.
string
required
string
required
string
required
Can be null.
string
Can be null.
string
Can be null.
string
required
string
Can be null.
boolean
required
true when this call created the pod. false is not expected, because each call sends its own request key; it means Tuyo returned an existing pod for that key instead of creating one, in its current state.