create_shared_account

Creates a new shared account: family (accountType HOUSEHOLD) or enterprise (accountType GROUP).

Use with an AI agent

Export this page as Markdown or bundle it with a task for your agent.

Try a task
Preview the prompt that will be copied

Access

  • Effect: Creates data
  • Required scope: write (the mcp scope also grants it)

Example request

The JSON-RPC message an MCP client sends to call this tool. Your client builds it for you; this is for reference and debugging in a tool such as MCP Inspector.

json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "create_shared_account",
    "arguments": {
      "name": "Emergency fund"
    }
  }
}

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

Description

Creates a new shared account: family (accountType HOUSEHOLD) or enterprise (accountType GROUP).

MCP infers accountType and display name from natural-language intent when accountType is omitted (e.g. roommate/family → HOUSEHOLD, startup/team → GROUP). If the type cannot be inferred, it asks which one to create.
When accountType is omitted, an existing HOUSEHOLD or GROUP account with the same name is reported instead of creating a duplicate.
invitedEmails defaults to [] when omitted. Each invite needs email and role (COORGANIZER, EDITOR, or VIEWER). Matching existing Savi users are added as invited members; unknown emails are silently skipped, and no invitation email is sent.
The response includes organizationId, but its invitations field is always empty, so it does not confirm which invited members were added. This is a sensitive write because it changes shared-account membership.

Input parameters

NameTypeRequiredDescription
accountTypestringNo
invitedEmailsarrayNo
namestringYes
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "accountType": {
      "type": "string"
    },
    "invitedEmails": {
      "items": {
        "additionalProperties": false,
        "properties": {
          "email": {
            "type": "string"
          },
          "role": {
            "type": "string"
          }
        },
        "required": [
          "email",
          "role"
        ],
        "type": "object"
      },
      "type": [
        "null",
        "array"
      ]
    },
    "name": {
      "type": "string"
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}