Skip to main content
Glama

Synci

List transactions

list_transactions
Read-onlyIdempotent

List the user's financial transactions in a date window, newest first, across all account types (bank, deposit, line of credit, investment). Each row is lean by default: id, date, amount (negative = money out), currency, booked, payee, description (omitted when it duplicates payee), an account {id, name, institution} ref, and — when available — mcc, category, and bank_details (raw provider metadata: transaction/purpose codes, currency-exchange info, and the MCC category text that banks put in additional_information — useful for categorising spend when enrichment is off). Pass "verbose": true for the full, raw transaction record.

Internal transfers: a row that moves money between two of the user's own accounts carries a counterparty {financial_account_id, transaction_id, pairing_status} object (PENDING, PAIRED or EXPIRED) naming the account on the other side and, once paired, the matching row there. Treat PAIRED rows as transfers, not spending or income, and do not count both sides. Rows without the object are ordinary. When the user did not share the other account with you, the object carries only pairing_status: still a transfer, and its other side is not in your data. A PAIRED row whose transaction_id is null has a matching row the user's rules hide from you; it is still a transfer.

Manual loan rows (accounts with category LOAN) carry entry_type: PAYMENT (debt reduced, positive, paired with the bank payment that caused it), INTEREST and FEE (debt increased, negative, generated by Synci with origin MODEL), ADJUSTMENT (a user-verified correction), OPENING (the balance when the loan was added; not a cash flow) and SCHEDULED_PAYMENT (posted on a schedule when no bank account pays the loan). Count a loan payment once: either the bank row or the PAYMENT row, not both.

Manual bank accounts (integrator MANUAL, category BANK) are filled from statement files the user imports; their rows carry origin IMPORT and an import_batch_id, and are otherwise ordinary bank rows.

Investment rows also carry: type (raw activity, e.g. BUY / SELL / DIVIDEND / CRYPTO_SEND), is_cash_flow, units, and price_per_unit (the effective per-unit price in this row's currency, = |amount| / units). IMPORTANT for "what did I spend": rows with is_cash_flow=false are asset transfers or income-in-kind (crypto send/receive, staking, stock splits) — NOT money spent; exclude them from spending totals. Use amount, units and price_per_unit for trade figures; ignore any price written into the description string (it is the provider's own and can be in a different currency).

Dates: "date" is Synci's per-account authoritative date by default (what the user sees; "spending in June" means this). Override with date_field "booking" or "value" to filter/sort/show a specific date instead. Both booked and pending transactions are returned by default; filter with status ("all" | "booked" | "pending", default "all"). Pending amounts can still change.

Coverage: meta.earliest_available_date is the date the queried accounts are synced from. If it is later than your "from", the window is only PARTIALLY covered — data before it was never synced (not absent), so any total would silently under-report. Caveat the coverage, or narrow "from" to it.

Pagination: results are bounded by the date window and "limit" (default 50, max 100). Check meta.has_more: if true, request the next page by passing meta.next_cursor as "cursor" (keyset paging, no gaps or overlap). A page may hold fewer rows than "limit" (the user can exclude transactions from outbound channels), so never read a short page as the end of the data; only has_more=false is. Sensitive identifiers (IBAN, account numbers, etc.) are always omitted, and an IBAN the bank wrote into payee, description or other transaction text is replaced with "[hidden: account number]".

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "list_transactions"
  }
}

Input Schema

NameRequiredDescriptionDefault
toNoOptional end date (YYYY-MM-DD), inclusive. Defaults to today.
fromNoOptional start date (YYYY-MM-DD), inclusive. Defaults to 30 days before "to".
limitNoOptional max rows to return (1-100). Defaults to 50. Check meta.has_more and page with meta.next_cursor.
cursorNoOptional. Pass meta.next_cursor from a previous call to fetch the next page (keyset paging).
statusNoFilter by settlement status. Defaults to "all" (booked + pending).
verboseNoWhen true, return the full raw transaction record instead of the lean shape.
account_idNoOptional. Restrict to a single financial account (id from list_accounts). Omit to span all accounts.
date_fieldNoWhich date to filter/sort/show on. "mapped" (default) is Synci's authoritative per-account date; "booking" or "value" force a specific field.

Output Schema

NameRequiredDescriptionDefault
dataYesNewest first. Lean rows omit null/empty keys; with verbose:true each item is the full raw transaction record instead. An IBAN written into transaction text (payee, description, remittance and additional information, names) is replaced with "[hidden: account number]".
metaYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedOutput schema / properties / data / items / properties / import_batch_id
      Added value: +{
      +  "description": "IMPORT rows only: the statement file (import batch) the row came in with. Absent elsewhere.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • changedOutput schema / properties / data / items / properties / origin / description
      Previous value: -"Who wrote the row when it is not an ordinary provider row: MANUAL (the user), RULE (a rule side effect), MODEL (the loan model: interest, fees, scheduled payments) or ADJUSTMENT (a balance checkpoint). Absent on provider rows."New value: +"Who wrote the row when it is not an ordinary provider row: MANUAL (the user), RULE (a rule side effect), MODEL (the loan model: interest, fees, scheduled payments), ADJUSTMENT (a balance checkpoint) or IMPORT (a statement file the user imported into a manual bank account). Absent on provider rows."
  2. Changed2 schema fields changed
    • changedOutput schema / properties / data / description
      Previous value: -"Newest first. Lean rows omit null/empty keys; with verbose:true each item is the full raw transaction record instead."New value: +"Newest first. Lean rows omit null/empty keys; with verbose:true each item is the full raw transaction record instead. An IBAN written into transaction text (payee, description, remittance and additional information, names) is replaced with \"[hidden: account number]\"."
    • changedOutput schema / properties / data / items / properties / counterparty / description
      Previous value: -"Internal transfer between the user's own accounts: the account on the other side and the pairing state. Absent on ordinary lean rows; all-null in verbose records without a counterparty."New value: +"Internal transfer between the user's own accounts: the account on the other side and the pairing state. Absent on ordinary lean rows; all-null in verbose records without a counterparty. The ids are left out (null in verbose records) when that account is not shared with this app."
  3. Changed2 schema fields changed
    • addedOutput schema / properties / data / items / properties / entry_type
      Added value: +{
      +  "description": "Manual loan rows only: OPENING, PAYMENT, INTEREST, FEE, ADJUSTMENT or SCHEDULED_PAYMENT. A PAYMENT reduces the debt (positive amount); INTEREST and FEE increase it (negative).",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / data / items / properties / origin
      Added value: +{
      +  "description": "Who wrote the row when it is not an ordinary provider row: MANUAL (the user), RULE (a rule side effect), MODEL (the loan model: interest, fees, scheduled payments) or ADJUSTMENT (a balance checkpoint). Absent on provider rows.",
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  4. Changed1 schema field changed
    • addedOutput schema / properties / data / items / properties / counterparty
      Added value: +{
      +  "description": "Internal transfer between the user's own accounts: the account on the other side and the pairing state. Absent on ordinary lean rows; all-null in verbose records without a counterparty.",
      +  "properties": {
      +    "financial_account_id": {
      +      "type": [
      +        "string",
      +        "integer",
      +        "null"
      +      ]
      +    },
      +    "pairing_status": {
      +      "description": "PENDING, PAIRED or EXPIRED.",
      +      "type": [
      +        "string",
      +        "null"
      +      ]
      +    },
      +    "transaction_id": {
      +      "type": [
      +        "string",
      +        "integer",
      +        "null"
      +      ]
      +    }
      +  },
      +  "type": "object"
      +}
  5. First observed

TDQS

A4.6/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already establish read-only, non-destructive, idempotent semantics, and the description adds substantial context beyond them: pending amounts can change, short pages are not end-of-data, keyset paging has no gaps or overlap, and sensitive identifiers are scrubbed. The coverage warning (data before earliest_available_date was never synced, so totals silently under-report) is exactly the kind of behavioural trait annotations cannot express.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Very long, but structured into labelled blocks (Internal transfers, Manual loan rows, Investment rows, Dates, Coverage, Pagination) with the core behaviour front-loaded in the first two sentences. The density of domain terminology (PAYMENT/INTEREST/OPENING, pairing_status) is heavy, though most of it directly changes how rows must be interpreted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 8-parameter, filter-heavy read tool with an output schema, the description covers pagination termination, coverage caveats, date-field ambiguity, and privacy redaction — the failure modes an agent would otherwise hit. Nothing needed to call it correctly appears to be missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so baseline is 3, but the description adds real meaning: it explains that "mapped" is the authoritative per-account date users mean by "spending in June", that verbose returns the raw record, and that limit/cursor are keyset-based. These are interpretive choices, not restatements of the schema.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

Opens with a specific verb+resource+scope: "List the user's financial transactions in a date window, newest first, across all account types (bank, deposit, line of credit, investment)." The default row shape is enumerated immediately, so an agent knows exactly what data comes back and can distinguish this from list_holdings/list_accounts.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives concrete decision rules for interpretation and downstream use: exclude is_cash_flow=false rows from spending totals, treat PAIRED rows as transfers and don't double-count, count a loan payment once, narrow "from" to meta.earliest_available_date when coverage is partial. It stops short of naming sibling tools or saying when to prefer get_account_balance/list_holdings instead, so it lacks explicit alternatives.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources