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(themcpscope 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.
{
"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)
{
"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"
}