Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.
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: Read-only
- Required scope:
read(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": "get_spending_analytics",
"arguments": {}
}
}Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.
Description
Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.
Returns a `report` field with emoji labels (e.g. "🍽️ Food & Drink: $459.00 USD") — present `report` verbatim to the user; do not strip emojis or reformat amounts.
Also returns `charts` (labels + values) for category spend — when present, ALWAYS render a chat-visible bar chart/image; do not reply with numbers only or write source files.
Use this for: "How much did I spend on food this month?", "What's my total income this year?", "Which vendors cost me the most?", "chart my spending".
Income vs expense follows transaction type (same as list_transactions), not amount sign.
from/to are RFC 3339 date strings. Either bound is optional. accountIds is optional — omit to include all accounts; call list_accounts to get IDs for filtering. Transfers are excluded by default; set includeTransfers=true to include them.Input parameters
| Name | Type | Required | Description |
|---|---|---|---|
accountIds | array | No | |
from | string | No | |
includeTransfers | boolean | No | |
to | string | No |
Full input schema (JSON Schema)
{
"additionalProperties": false,
"properties": {
"accountIds": {
"items": {
"type": "string"
},
"type": [
"null",
"array"
]
},
"from": {
"type": [
"null",
"string"
]
},
"includeTransfers": {
"type": [
"null",
"boolean"
]
},
"to": {
"type": [
"null",
"string"
]
}
},
"type": "object"
}