# list\_subscriptions

Finds the recurring subscriptions and bills the user pays, detected from transaction history. Read-only. Amounts are in currency major units, not cents.

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": "list_subscriptions",
    "arguments": {}
  }
}
```

Example IDs refer to fictional demo data. Replace them with IDs from your account before calling the real server.

## Description

```
Finds the recurring subscriptions and bills the user pays, detected from transaction history. Read-only. Amounts are in currency major units, not cents.

Use this for: "What subscriptions am I paying for?", "How much do I spend on subscriptions a month?", "Did any subscription go up in price?", "Which subscriptions have I stopped paying?".

A vendor is reported when it has repeated expense charges (default at least 3, or 2 for annual renewals) at a steady price (within 15%) on a weekly, biweekly, monthly, quarterly or annual cadence. Each entry has the typical and last amount, monthlyCost and annualCost, cadence, nextExpected date, and previousAmount when the latest charge changed price. status is `active` or `possibly_cancelled` (the next charge is overdue); possibly_cancelled entries are hidden unless includeInactive=true. Monthly bills in utility, insurance, phone and internet categories may vary: amountType is variable and cost estimates use the median charge. Other entries have amountType fixed. Separate recurring prices from the same merchant are reported independently per account. Variable groceries, fuel and restaurant spending is excluded. Transfers are ignored. Totals are kept per currency.

A journal contributes one occurrence using its net expense category postings; category splits are not separate charges. Refund-only and net-zero journals are ignored.

lookbackDays defaults to 800 (up to 1100). accountIds is optional; call list_accounts for IDs. At most 5,000 transactions are read; narrow lookbackDays or accountIds if the note says the history was cut off.
```

## Input parameters

| Name | Type | Required | Description |
| --- | --- | --- | --- |
| `accountIds` | array | No |  |
| `includeInactive` | boolean | No |  |
| `lookbackDays` | integer | No |  |
| `minOccurrences` | integer | No |  |

Full input schema (JSON Schema)

```json
{
  "additionalProperties": false,
  "properties": {
    "accountIds": {
      "items": {
        "type": "string"
      },
      "type": [
        "null",
        "array"
      ]
    },
    "includeInactive": {
      "type": [
        "null",
        "boolean"
      ]
    },
    "lookbackDays": {
      "type": [
        "null",
        "integer"
      ]
    },
    "minOccurrences": {
      "type": [
        "null",
        "integer"
      ]
    }
  },
  "type": "object"
}
```

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