# io.github.theluckystrike/bank-statement (mcpb · bank-statement.mcpb)

Import a bank CSV, categorise it, summarise it per currency and reconcile it against your expenses.

- Trust score: 50/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- mcpb · `bank-statement.mcpb`: 50/100 (this document), [markdown](https://verifymcp.io/servers/theluckystrike-bank-statement/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-bank-state.md), [page](https://verifymcp.io/servers/theluckystrike-bank-statement/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-bank-state)

## Channel facts

- Registry: `mcpb`
- Package: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/bank-statement.mcpb`
- Version: `0.22.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Supply Chain Security**: 23/100
  - Malware scan not yet available for this package.
  - Known CVEs were checked across the 105 of 105 dependencies we could resolve, so this covers what we could see, not the whole tree.
  - No install/post-install scripts declared.
  - 40 of 105 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 45/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 3 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 87/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Tool/resource definitions use about 1381 tokens (~106/item across 13 items; 12 tools + 1 resources), lean.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 12 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 13 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

- Download bundle: `https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/bank-statement.mcpb`

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-18 (score 50)

First indexed and scored.

## MCP tools (12)

### `statement_import` (~213 tokens)

Import a bank CSV

Call this tool to read a bank CSV into the local ledger. Columns detected from headers (date, description, amount, currency, balance); amounts use the file's locale; stored lines skipped. Returns detected/stored/skipped.

Input parameters:

- `account` (string): Name for this account, e.g. "business EUR". Default: the file name without its extension. Later imports of the same account are deduplicated against it
- `bank` (string): Bank profile. Default "auto": the headers decide. "generic" skips profile detection and uses the header heuristics alone
- `currency` (string): Currency for rows where the file names none. Defaults to the shared business profile's default_currency, else EUR; the response says which it used
- `overwrite` (boolean): Delete every transaction already stored for this account before importing, instead of merging. Use it when the bank reissued a corrected export
- `path` (string, required): Path to the .csv file exported from the bank. ~ is expanded

### `transactions_list` (~151 tokens)

List transactions

List stored transactions in a date range, optionally for one account or category, or only the ones no rule has categorised yet. Totals are reported per currency and never added across currencies.

Input parameters:

- `account` (string): Limit to one account, as named at import
- `category` (string): Only transactions in this category
- `from` (string): ISO date YYYY-MM-DD, inclusive. Default: the start of the current month
- `limit` (integer): Rows returned, default 200. Totals always cover the whole range
- `to` (string): ISO date YYYY-MM-DD, inclusive. Default: today
- `uncategorized` (boolean): Only transactions with no category yet

### `transactions_search` (~102 tokens)

Search transactions

Find transactions whose description, counterparty, category or account contains the query. Case-insensitive substring search, never a regex, so a query with brackets in it cannot hang the server.

Input parameters:

- `from` (string): ISO date, inclusive
- `limit` (integer): Rows returned, default 100
- `query` (string, required): Text to look for, e.g. "spotify" or "acme"
- `to` (string): ISO date, inclusive

### `category_rules` (~110 tokens)

Set or list category rules

Read the category rules, or pass rules to REPLACE the whole list. A plain match is a substring; a regex compiles only if it cannot backtrack exponentially. An empty match is refused. Free: 5 rules.

Input parameters:

- `reapply_all` (boolean): Also overwrite categories set by an earlier rule or by hand. Default false: only uncategorised transactions are touched
- `rules` (array): The complete rule list; it replaces the stored one. Omit to list the current rules

### `transaction_categorize` (~89 tokens)

Categorise transactions by id

Set or clear the category on transactions by id, for a one-off no rule is worth writing for. Every id is checked first, so one unknown id refuses the whole call. category_rules matches by text instead.

Input parameters:

- `category` (string, required): Category to set. Pass an empty string to clear it
- `ids` (array, required): Transaction ids, as returned by transactions_list or transactions_search

### `statement_summary` (~133 tokens)

What I spent, from the bank account

What was spent/received in a date range per the BANK ACCOUNT, grouped by category, month, account or counterparty. For "what did I spend in August" once imported. Totals are per currency, never summed or converted.

Input parameters:

- `account` (string): Limit the summary to one account
- `from` (string): ISO date, inclusive. Default: the start of the current month
- `group_by` (string): Default category
- `to` (string): ISO date, inclusive. Default: today
- `top` (integer): Groups returned per currency, largest net first. Default 25

### `reconcile_expenses` (~129 tokens)

Reconcile against the expense ledger

Match bank debits against mcp-expense-tracker entries: same currency and amount, date within a few days. Reports matches, unmatched bank lines, expenses never hitting the bank. Read-only. Free: 31 days; Pro: any range.

Input parameters:

- `account` (string): Limit to one bank account
- `from` (string, required): ISO date, inclusive
- `to` (string, required): ISO date, inclusive
- `window_days` (integer): Allowed gap between the expense date and the bank date, default 3. A card payment usually settles a day or two after the receipt

### `recurring_detect` (~115 tokens)

Subscriptions and recurring charges in the bank data

Find charges that come back: debits grouped by counterparty and currency with a steady amount and interval, with cadence, typical amount, next due date and annual cost. Free: 3 months, 5 charges.

Input parameters:

- `account` (string): Limit to one account
- `min_occurrences` (integer): Occurrences required before a charge counts as recurring, default 2
- `months` (integer): How far back to look, default 3. Two occurrences are enough to see a cadence, three make it certain

### `statement_export` (~138 tokens)

Export bank transactions to a file

Call this tool to write BANK transactions of a date range to a .csv or .json file and return the path. For "export September to <path>" once imported. Written atomically: a failed export never leaves a half file.

Input parameters:

- `account` (string): Limit to one account
- `category` (string): Limit to one category
- `format` (string, required): csv for a spreadsheet, json for a program
- `from` (string, required): ISO date, inclusive
- `path` (string, required): Where to write the file. ~ is expanded; the parent directory must exist
- `to` (string, required): ISO date, inclusive

### `accounts_list` (~48 tokens)

List accounts

List the imported accounts: bank, currencies, transaction count, first and last date, and the closing balance when the file carried one. Start here for the account names transactions_list and statement_export take.

### `license_status` (~54 tokens)

License status

Report this server's licence state: product, tier free or pro, licence id, expiry, the key source and the upgrade URL. No arguments, no network. Explains a free-tier refusal; license_activate installs a key.

### `license_activate` (~71 tokens)

Activate license

Activate a Pro key (MCPL1.xxx.yyy) from checkout: verified offline against a built-in public key, saved to your config file. A wrong, malformed or expired key is refused, unsaved. license_status reads it back.

Input parameters:

- `key` (string, required): License key from the checkout confirmation page

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/theluckystrike-bank-statement/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-bank-state#diagnostics

## Score history

- 2026-09-21: 50
- 2026-09-20: 50
- 2026-09-19: 50
- 2026-09-18: 50

## Common questions

### What is the io.github.theluckystrike/bank-statement MCP server?

io.github.theluckystrike/bank-statement is an MCP server listed in the public MCP registry as io.github.theluckystrike/bank-statement. Import a bank CSV, categorise it, summarise it per currency and reconcile it against your expenses. This page covers its MCPB bundle (https://github.com/theluckystrike/mcp-servers/releases/download/v0.22.0/bank-statement.mcpb).

### Is the io.github.theluckystrike/bank-statement MCP server safe to use?

io.github.theluckystrike/bank-statement scores 50 out of 100 on VerifyMCP. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.github.theluckystrike/bank-statement MCP server expose?

io.github.theluckystrike/bank-statement exposes 12 tools: statement_import, transactions_list, transactions_search, category_rules, transaction_categorize, and 7 more. Their descriptions and schemas cost roughly 1,353 tokens of context every time the server is loaded.

### What licence is the io.github.theluckystrike/bank-statement MCP server under?

io.github.theluckystrike/bank-statement declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/theluckystrike/mcp-servers
- Website: https://mcp.zovo.one/s/bank-statement
- Changelog RSS feed: https://verifymcp.io/servers/theluckystrike-bank-statement/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-bank-state.xml
- Changelog JSON feed: https://verifymcp.io/servers/theluckystrike-bank-statement/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-bank-state.json
- HTML version of this page: https://verifymcp.io/servers/theluckystrike-bank-statement/https-github-com-theluckystrike-mcp-servers-releases-download-v0-22-0-bank-state