# create\_account

Creates a new account for the authenticated user.

Last updated October 1, 2026

## 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

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `accountSubtype` | string | No |  |
| `accountType` | string | No |  |
| `assetType` | string | No |  |
| `countryId` | integer | No |  |
| `debtInterestRate` | number | No |  |
| `defaultCurrency` | string | No |  |
| `description` | string | No |  |
| `fuelEfficiency` | number | No |  |
| `giftCardVendorId` | string | No |  |
| `giftCardVendorName` | string | No |  |
| `governmentAccountType` | string | No |  |
| `gracePeriod` | string | No |  |
| `industryAccountRateId` | string | No |  |
| `interestRecurrenceRate` | string | No |  |
| `investmentType` | string | No |  |
| `isVariableInterestRate` | boolean | No |  |
| `name` | string | Yes |  |
| `positionOrder` | integer | No |  |
| `savingInterestRate` | number | No |  |
| `stockPrice` | number | No |  |
| `stockQuantity` | number | No |  |
| `stockSymbol` | string | No |  |

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"
}
```

Source: https://financesavi.com/developers/mcp/tools/create_account
