# get\_spending\_analytics

Answers questions about how much the user spent or earned — totals plus category, tag, and vendor breakdowns.

Last updated October 1, 2026

## Access

*   Effect: **Read-only**
*   Required scope: `read` (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": "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)

```json
{
  "additionalProperties": false,
  "properties": {
    "accountIds": {
      "items": {
        "type": "string"
      },
      "type": [
        "null",
        "array"
      ]
    },
    "from": {
      "type": [
        "null",
        "string"
      ]
    },
    "includeTransfers": {
      "type": [
        "null",
        "boolean"
      ]
    },
    "to": {
      "type": [
        "null",
        "string"
      ]
    }
  },
  "type": "object"
}
```

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