create_account

Creates a new account for the authenticated user.

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_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 account for the authenticated user.

Creates a bookkeeping record in Savi; it does not open or link a real bank, credit, or investment account.
Required field: name (or a natural-language sentence like "create a savings account for an emergency fund").
Casual speech is fine: checking / savings / credit card / emergency fund are inferred.
"Open a credit card" creates a credit account — not a spendable budget or goal.
Vague prompts like "add an account" should be clarified (ask checking vs savings vs credit).
If a similar account already exists, this tool refuses the duplicate and returns the existing name.

After creation, confirm in plain language (e.g. "Created Emergency Fund"). For follow-ups, pass accountName with that display name (e.g. log expenses on Emergency Fund).

Input parameters

NameTypeRequiredDescription
accountSubtypestringNo
accountTypestringNo
assetTypestringNo
countryIdintegerNo
debtInterestRatenumberNo
defaultCurrencystringNo
descriptionstringNo
fuelEfficiencynumberNo
giftCardVendorIdstringNo
giftCardVendorNamestringNo
governmentAccountTypestringNo
gracePeriodstringNo
industryAccountRateIdstringNo
interestRecurrenceRatestringNo
investmentTypestringNo
isVariableInterestRatebooleanNo
namestringYes
positionOrderintegerNo
savingInterestRatenumberNo
stockPricenumberNo
stockQuantitynumberNo
stockSymbolstringNo
Full input schema (JSON Schema)
json
{
  "additionalProperties": false,
  "properties": {
    "accountSubtype": {
      "type": [
        "null",
        "string"
      ]
    },
    "accountType": {
      "type": [
        "null",
        "string"
      ]
    },
    "assetType": {
      "type": [
        "null",
        "string"
      ]
    },
    "countryId": {
      "type": [
        "null",
        "integer"
      ]
    },
    "debtInterestRate": {
      "type": [
        "null",
        "number"
      ]
    },
    "defaultCurrency": {
      "type": [
        "null",
        "string"
      ]
    },
    "description": {
      "type": [
        "null",
        "string"
      ]
    },
    "fuelEfficiency": {
      "type": [
        "null",
        "number"
      ]
    },
    "giftCardVendorId": {
      "type": [
        "null",
        "string"
      ]
    },
    "giftCardVendorName": {
      "type": [
        "null",
        "string"
      ]
    },
    "governmentAccountType": {
      "type": [
        "null",
        "string"
      ]
    },
    "gracePeriod": {
      "type": [
        "null",
        "string"
      ]
    },
    "industryAccountRateId": {
      "type": [
        "null",
        "string"
      ]
    },
    "interestRecurrenceRate": {
      "type": [
        "null",
        "string"
      ]
    },
    "investmentType": {
      "type": [
        "null",
        "string"
      ]
    },
    "isVariableInterestRate": {
      "type": [
        "null",
        "boolean"
      ]
    },
    "name": {
      "type": "string"
    },
    "positionOrder": {
      "type": [
        "null",
        "integer"
      ]
    },
    "savingInterestRate": {
      "type": [
        "null",
        "number"
      ]
    },
    "stockPrice": {
      "type": [
        "null",
        "number"
      ]
    },
    "stockQuantity": {
      "type": [
        "null",
        "number"
      ]
    },
    "stockSymbol": {
      "type": [
        "null",
        "string"
      ]
    }
  },
  "required": [
    "name"
  ],
  "type": "object"
}