# MainBook Bank Statement Converter (remote · mcp.mainbook.ai)

Convert PDF bank statements to checked Excel, CSV or JSON with balance validation.

- Trust score: 63/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-20

## Components

- remote · `mcp.mainbook.ai`: 63/100 (this document), [markdown](https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mcp.md), [page](https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mcp)
- pypi · `mainbook-mcp`: 55/100, [markdown](https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mainbook-mcp.md), [page](https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mainbook-mcp)

## Channel facts

- Endpoint: `https://mcp.mainbook.ai/mcp`
- Transports: `streamable-http`
- Auth: `required`
- Version: `0.5.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, 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-08-20.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to call this server, and 2 tool(s) never declared a destructiveHint. The MCP spec treats an absent hint as destructive by default, so we cannot call this surface safe.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 77/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 559 tokens (~139/item across 4 items; 4 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability check failed: schema churn in the 4 days we've observed: 1 tool removals, 0 breaking changes, 0 auth/transport breaks, 0 additions.
- **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.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http ai-mainbook-bank-statement-converter https://mcp.mainbook.ai/mcp
```

### Codex

```toml
[mcp_servers.ai-mainbook-bank-statement-converter]
url = "https://mcp.mainbook.ai/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "ai-mainbook-bank-statement-converter": {
      "type": "remote",
      "url": "https://mcp.mainbook.ai/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add ai-mainbook-bank-statement-converter --url https://mcp.mainbook.ai/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  ai-mainbook-bank-statement-converter:
    url: "https://mcp.mainbook.ai/mcp"
```

### Other

```json
{
  "mcpServers": {
    "ai-mainbook-bank-statement-converter": {
      "type": "http",
      "url": "https://mcp.mainbook.ai/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## 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-08-18 (score 63, −1)

- [security regression] Stability: 0.03 → fail
- [security regression] Tool “output_folder” was removed
- [functional regression] Schema quality: 126 → 139
- [functional] Server version: 0.4.2 → 0.5.1
- [cosmetic] Tool “convert_bank_statement” changed its title: Convert bank statement
- [cosmetic] Tool “get_balance” changed its title: Get page-credit balance
- [cosmetic] Tool “get_conversion” changed its title: Get conversion
- [cosmetic] Tool “list_conversions” changed its title: List conversions

### 2026-08-17 (score 64, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-08-16 (score 63)

First indexed and scored.

## MCP tools (4)

### `convert_bank_statement` (~322 tokens)

Convert bank statement

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.

Input parameters:

- `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…

Output parameters:

- `data`
- `download`
- `job_id` (string)
- `message` (string)
- `pages`
- `result_type` (string)
- `saved_file`
- `state`
- `timed_out` (boolean)
- `validation`

### `get_balance` (~27 tokens)

Get page-credit balance

Return total, reserved, and available MainBook credits. Every value is measured in PDF pages.

Output parameters:

- `available` (integer)
- `balance` (integer)
- `explanation` (string)
- `reserved` (integer)
- `units` (string)

### `list_conversions` (~62 tokens)

List conversions

List one cursor page of conversion jobs visible to the MainBook account. Pass the returned next_cursor to continue.

Input parameters:

- `cursor`: Opaque next_cursor from the previous page.
- `limit` (integer): Jobs on this page, from 1 to 100.

Output parameters:

- `conversions` (array)
- `count` (integer)
- `next_cursor`
- `units` (string)

### `get_conversion` (~112 tokens)

Get conversion

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.

Input parameters:

- `job_id` (string, required): 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.

Output parameters:

- `data`
- `download`
- `job_id` (string)
- `message` (string)
- `pages`
- `result_type` (string)
- `saved_file`
- `state`
- `timed_out` (boolean)
- `validation`

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mcp#diagnostics

## Score history

- 2026-08-20: 63
- 2026-08-19: 63
- 2026-08-18: 63
- 2026-08-17: 64
- 2026-08-16: 63

## Links

- Remote endpoint: https://mcp.mainbook.ai/mcp
- Authorisation metadata: https://mcp.mainbook.ai/.well-known/oauth-protected-resource/mcp
- Repository: https://github.com/human-beyond/mainbook-mcp
- Website: https://mainbook.ai/mcp
- Changelog RSS feed: https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mcp.json
- HTML version of this page: https://verifymcp.io/servers/ai-mainbook-bank-statement-converter/mcp