Bank File Tool Statement Review MCP
# Bank File Tool Statement Review MCP
Local checks for a bank statement export. This is a companion to [Bank File Tool — Bank Statement Converter](https://bankfiletool.com/), which converts PDF, PNG, and JPG statements to CSV, Excel, or JSON and provides its own balance checks.
This open-source MCP server adds three small tools:
- `reconcile_statement_totals`: compare **opening balance + credits − debits** with the printed closing balance using exact cent arithmetic.
- `review_export_headers`: check that export column names include a date, description, and amount or separate debit/credit fields.
- `get_official_links`: find the official converter, pricing, contact, and privacy pages.
The checks run on your machine. Supply **totals and column names only**. Do not paste account numbers, transaction rows, statements, or other private financial data into a model prompt. This server does not access Bank File Tool accounts, upload files, call an unpublished conversion API, or prove that extracted data matches an original statement. Review flagged differences against the source PDF or image.
## Run
Requires Node.js 20.18.1 or newer.
```sh
npm ci
npm run build
npm test
node dist/index.js
```
The final command starts a stdio MCP server. Configure your MCP client to run `node /absolute/path/to/bankfiletool-statement-review-mcp/dist/index.js` after installation. For an example balance check, pass `openingBalance: "12480.20"`, `creditTotal: "8350.00"`, `debitTotal: "6912.47"`, and `closingBalance: "13917.73"` to `reconcile_statement_totals`.
## Scope
This project is independently maintained as a public helper for the [Bank File Tool](https://bankfiletool.com/) workflow. The converter itself runs on the official site. No network request is made by this MCP server.
Licensed under MIT; see `LICENSE`.
TDQS
Scored across 3 tools
Each tool targets a clearly distinct operation: reconciling totals, reviewing export headers, and retrieving official links. There is no overlap in purpose or expected inputs.
All three tools follow a consistent snake_case verb_noun pattern (reconcile_statement_totals, review_export_headers, get_official_links). The naming is predictable and readable.
Three tools are well-scoped for a narrowly focused local statement-review assistant. Each tool has a clear, necessary role and the set does not feel bloated or arbitrarily thin.
The surface covers the advertised local review functions: totals reconciliation, header inspection, and official link retrieval. Minor gaps exist, such as guidance for handling mismatched totals or unsupported header formats, but the core workflow is complete.