MCP Server
Convert bank statements from your AI agent
The ConvertStatement MCP server is an agent-native endpoint that converts bank statement PDFs to CSV, OFX, or QBO with built-in balance-reconciliation verification. It speaks the Model Context Protocol over streamable HTTP at https://convertstatement.com/api/mcp, exposing two tools — convert_bank_statement and list_supported_banks — so AI agents can convert statements directly, without a browser.
Connect the server
The endpoint is https://convertstatement.com/api/mcp over streamable HTTP. Add it to any MCP-capable client.
Claude Code
Run one command in your terminal:
claude mcp add --transport http convertstatement https://convertstatement.com/api/mcpClaude Desktop, Cursor & generic clients
Add the server to your client's mcp.json (for Cursor, ~/.cursor/mcp.json):
{
"mcpServers": {
"convertstatement": {
"type": "http",
"url": "https://convertstatement.com/api/mcp"
}
}
}Tools
convert_bank_statement
Convert a bank statement PDF to CSV, OFX, or QBO with an inline reconciliation verdict.
| Parameter | Type | Notes |
|---|---|---|
| pdf_base64 | string, required | Base64-encoded PDF bank statement, max 8MB decoded. The bank is auto-detected. |
| format | csv | ofx | qbo, optional | Output format, default csv. excel is web-only (binary is not suitable for JSON-RPC). |
| token | string, optional | ConvertStatement API token for account limits — the same personal token the Chrome extension uses, generated from your dashboard. Anonymous use is allowed without it. |
| Result field | Meaning |
|---|---|
| bank | Detected bank name. |
| transaction_count | Number of transactions extracted. |
| reconciliation | Verdict { verified, method, difference } from the two balance oracles. |
| file | { format, content } — the converted statement as a string. |
| pages_used / pages_remaining | Page accounting for this call. |
list_supported_banks
Returns the 16 supported banks with per-bank statement format notes and docs links. Takes no parameters.
Limits & authentication
Anonymous callers get 10 pages one time per IP. A free account raises the limit to 50 pages per month; paid plans convert more.
To use your account limits, generate a personal API token from your dashboard — the same token the Chrome extension uses — and pass it as the token parameter. Over-limit calls return a structured error linking to pricing.
How it works & privacy
ConvertStatement's MCP server lets AI agents convert bank statement PDFs to CSV, OFX, or QBO without a browser or manual upload. An agent sends a base64-encoded PDF to the convert_bank_statement tool over streamable HTTP; a rule-based parser detects the bank and extracts every transaction — date, description, amount, and running balance — with no AI or machine learning involved. Each conversion is verified by two independent oracles: summary reconciliation checks that the opening balance plus the sum of transactions equals the closing balance, and running-balance continuity checks that each printed balance follows from the previous one. The tool returns the result with a prominent verified true, false, or null verdict, so an agent is never handed a silently wrong conversion. Anonymous callers get ten pages one time; a free account raises the limit to fifty pages per month. Statements are processed entirely in memory and never stored.
Frequently asked questions
What is the Model Context Protocol (MCP)?
MCP is an open standard that lets AI agents and assistants call external tools over a defined protocol. The ConvertStatement MCP server exposes bank-statement conversion as two callable tools, so an agent can convert a PDF without a browser or manual upload.
Is the MCP server free to use?
Yes. Anonymous callers get 10 pages one time per IP. Signing up for a free account raises the limit to 50 pages per month, and paid plans convert more. Over-limit calls return a structured error linking to the pricing page.
Which banks does it support?
The MCP server supports the same 16 banks as the website — call the list_supported_banks tool for the current list with per-bank format notes, or browse them at convertstatement.com/banks.
Is my statement data stored?
No. Statements are decoded and parsed entirely in memory and are never written to disk, never logged, and never used for training. Parsing is rule-based, with no AI or machine learning on the conversion path.
How do I authenticate for higher limits?
Generate a personal API token from your ConvertStatement dashboard (the same token the Chrome extension uses) and pass it as the optional token parameter to convert_bank_statement. An invalid or expired token returns an explicit error — it never silently falls back to the anonymous tier.