MainBook Bank Statement Converter
PYPI · MAINBOOK-MCP · 2 COMPONENTS · SCANNED SEP 14
Convert PDF bank statements to checked Excel, CSV or JSON with balance validation.
Available components
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. How we score → Why this is hard to score →
Supply Chain Security50
- Malware scan not yet available for this package.Unverified
- No known CVEs affecting this package version or its production dependencies.Pass
- Runs hatchling.build at install time, a recognised native-build step with no shell scripting around it. View diagnostics → Pass
- 1 of 30 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency35
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
- License check failed: no license is declared. See how to fix → Fail
- Actively maintained (last published 26 days ago).Pass
- Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability78
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 634 tokens (~126/item across 5 items; 5 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
- Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- We read all 5 captured tool definition(s), and no name or description among them implies an irreversible operation.Pass
- An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a current MCP spec version (2026-07-28).Pass
How do I install the MainBook Bank Statement Converter MCP server?
MainBook Bank Statement Converter runs locally as a PyPI package, launched with uvx mainbook-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
pypi · mainbook-mcp
claude mcp add ai-mainbook-bank-statement-converter -- uvx mainbook-mcp
{
"mcpServers": {
"ai-mainbook-bank-statement-converter": {
"command": "uvx",
"args": [
"mainbook-mcp"
]
}
}
} {
"servers": {
"ai-mainbook-bank-statement-converter": {
"command": "uvx",
"args": [
"mainbook-mcp"
]
}
}
} codex mcp add ai-mainbook-bank-statement-converter -- uvx mainbook-mcp
{
"$schema": "https://opencode.ai/config.json",
"mcp": {
"ai-mainbook-bank-statement-converter": {
"type": "local",
"command": [
"uvx",
"mainbook-mcp"
],
"enabled": true
}
}
} openclaw mcp add ai-mainbook-bank-statement-converter --command uvx --arg mainbook-mcp
mcp_servers:
ai-mainbook-bank-statement-converter:
command: "uvx"
args: ["mainbook-mcp"] {
"McpServers": {
"ai-mainbook-bank-statement-converter": {
"Transport": "stdio",
"Command": "uvx",
"Arguments": [
"mainbook-mcp"
]
}
}
} assistant mcp add ai-mainbook-bank-statement-converter -t stdio -c uvx -a mainbook-mcp
{
"mcpServers": {
"ai-mainbook-bank-statement-converter": {
"command": "uvx",
"args": [
"mainbook-mcp"
]
}
}
} Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 14 Sept 26 −15
- Malware scan: pass → unverified ▼ security
- Stability: 0.97 → pass security
- 13 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 93 to 97. That category is still filling its 30-day observation window: 28 days of observed history at the previous scan, 29 at this one. The score rises as the window fills, whether or not the server changes.
- 11 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 87 to 90. That category is still filling its 30-day observation window: 26 days of observed history at the previous scan, 27 at this one. The score rises as the window fills, whether or not the server changes.
- 9 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 80 to 83. That category is still filling its 30-day observation window: 24 days of observed history at the previous scan, 25 at this one. The score rises as the window fills, whether or not the server changes.
- 7 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 73 to 77. That category is still filling its 30-day observation window: 22 days of observed history at the previous scan, 23 at this one. The score rises as the window fills, whether or not the server changes.
- 5 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 67 to 70. That category is still filling its 30-day observation window: 20 days of observed history at the previous scan, 21 at this one. The score rises as the window fills, whether or not the server changes.
- 3 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.
- 1 Sept 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 14 Sept 2026 · Analysed pypi/mainbook-mcp@0.5.1
Provenance No attestation
The registry publishes no build provenance for this version, so there is nothing to verify.
| Result | No attestation |
|---|---|
| Ecosystem | pypi |
Background: How many MCP packages publish verified provenance →
Install scripts 1 script
| Hook | Tier | Command |
|---|---|---|
| build_backend | allowlisted | hatchling.build |
Background: Why install scripts are a supply-chain risk →
Dependencies 30 packages
| Packages resolved | 30 |
|---|---|
| No linked repository | 1 |
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
convert_bank_statement Convert bank statement ~322
Convert one PDF bank statement through the complete MainBook workflow: create a job, upload, start, poll, and return structured data. This creates a job and spends page credits; it is not read-only.
| Name | Type | Req | Description |
|---|---|---|---|
| file_path | – | – | Path to a PDF on the MCP server machine. This field is only available over stdio and is rejected in HTTP mode; remote clients must use file_url. The path must be inside the allowed folders, which def… |
| file_url | – | – | Public HTTPS URL of a PDF for remote mode. Redirects and non-public network addresses are rejected. Exactly one source is required. |
| idempotency_key | – | – | Optional value forwarded verbatim in the Idempotency-Key REST header. |
| output_path | – | – | Optional absolute result file or existing folder on the MCP server machine. Only available over stdio and only inside the allowed folders. The file extension is corrected to match result_type. |
| result_type | string | – | JSON is returned inline. Over stdio, XLSX or CSV is written to an allowed local folder and the full path is returned. HTTP mode returns safe download instructions. Binary bytes never enter model cont… |
| timeout_seconds | integer | – | Internal polling budget from 30 to 900 seconds. Timeout leaves the job running and returns its job_id for get_conversion. The default stays under the 60-second request timeout most MCP clients enforc… |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | – |
| download | – | – | – |
| job_id | string | yes | – |
| message | string | yes | – |
| pages | – | yes | – |
| result_type | string | yes | – |
| saved_file | – | – | – |
| state | – | yes | – |
| timed_out | boolean | – | – |
| validation | – | yes | – |
No examples provided.
get_balance Get page-credit balance ~27
Return total, reserved, and available MainBook credits. Every value is measured in PDF pages.
Input schema present but exposes no named parameters.
| Name | Type | Req | Description |
|---|---|---|---|
| available | integer | yes | – |
| balance | integer | yes | – |
| explanation | string | yes | – |
| reserved | integer | yes | – |
| units | string | – | – |
No examples provided.
get_conversion Get conversion ~112
Get the current state of one MainBook conversion. When successful, return JSON inline or save XLSX/CSV locally over stdio. HTTP mode returns safe download instructions. Use this after convert_bank_statement times out.
| Name | Type | Req | Description |
|---|---|---|---|
| job_id | string | yes | Conversion job UUID returned by MainBook. |
| output_path | – | – | Optional absolute result file or existing folder on the MCP server machine. Only available over stdio and only inside the allowed folders. |
| result_type | string | – | Result representation to retrieve after the job succeeds. |
| Name | Type | Req | Description |
|---|---|---|---|
| data | – | – | – |
| download | – | – | – |
| job_id | string | yes | – |
| message | string | yes | – |
| pages | – | yes | – |
| result_type | string | yes | – |
| saved_file | – | – | – |
| state | – | yes | – |
| timed_out | boolean | – | – |
| validation | – | yes | – |
No examples provided.
list_conversions List conversions ~62
List one cursor page of conversion jobs visible to the MainBook account. Pass the returned next_cursor to continue.
| Name | Type | Req | Description |
|---|---|---|---|
| cursor | – | – | Opaque next_cursor from the previous page. |
| limit | integer | – | Jobs on this page, from 1 to 100. |
| Name | Type | Req | Description |
|---|---|---|---|
| conversions | array | yes | – |
| count | integer | yes | – |
| next_cursor | – | yes | – |
| units | string | – | – |
No examples provided.
output_folder Manage output folder ~75
Read or change the default local result folder. Call with no path to inspect the current setting and allowed folders. Pass an allowed absolute folder, or 'next_to_source' to restore the default behavior.
| Name | Type | Req | Description |
|---|---|---|---|
| path | – | – | Allowed absolute folder to remember, or 'next_to_source' to reset. Omit to read without changing anything. |
| Name | Type | Req | Description |
|---|---|---|---|
| allowed_folders | array | yes | – |
| message | string | yes | – |
| output_folder | string | yes | – |
No examples provided.
What is the MainBook Bank Statement Converter MCP server?
MainBook Bank Statement Converter is an MCP server listed in the public MCP registry as ai.mainbook/bank-statement-converter. Convert PDF bank statements to checked Excel, CSV or JSON with balance validation. This page covers its PyPI package (mainbook-mcp).
Is the MainBook Bank Statement Converter MCP server safe to use?
MainBook Bank Statement Converter scores 68 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 14 September 2026. 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 MainBook Bank Statement Converter MCP server expose?
MainBook Bank Statement Converter exposes 5 tools: convert_bank_statement, get_balance, list_conversions, get_conversion, output_folder. Their descriptions and schemas cost roughly 598 tokens of context every time the server is loaded.
Is the MainBook Bank Statement Converter MCP server still maintained?
MainBook Bank Statement Converter is still listed as active in the MCP registry. We last reached this channel on 14 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.