# ContaBridge (pypi · contabridge-mcp)

Convert journals between A3, ContaPlus/Sage 50, QuickBooks, Xero and CSV; bank files to entries.

- Trust score: 81/100 (high trust)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `mcp.keyflint.dev`: 32/100, [markdown](https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp.md), [page](https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp)
- pypi · `contabridge-mcp`: 81/100 (this document), [markdown](https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2.md), [page](https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2)

## Channel facts

- Registry: `pypi`
- Package: `contabridge-mcp`
- Version: `0.4.1`
- 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-11-21.

- **Supply Chain Security**: 100/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs setuptools.build_meta at install time, a recognised build step with no custom scripting around it.
  - 1 of 30 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 84/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to ArceeDev/contabridge-mcp).
  - License check failed: the license (BUSL-1.1) isn't a recognized OSI-approved license.
  - Actively maintained (last published 5 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 64/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 4065 tokens (~338/item across 12 items; 11 tools + 1 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 50/100
  - Stability observed for 15 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 71/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 11 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 current MCP spec version (2026-07-28).
  - Supports UI / widget rendering.

## Install

### How do I install the ContaBridge MCP server?

ContaBridge runs locally as a PyPI package, launched with uvx contabridge-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add arceedev-contabridge-mcp -- uvx contabridge-mcp
```

### Cursor

```json
{
  "mcpServers": {
    "arceedev-contabridge-mcp": {
      "command": "uvx",
      "args": [
        "contabridge-mcp"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "arceedev-contabridge-mcp": {
      "command": "uvx",
      "args": [
        "contabridge-mcp"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add arceedev-contabridge-mcp -- uvx contabridge-mcp
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "arceedev-contabridge-mcp": {
      "type": "local",
      "command": [
        "uvx",
        "contabridge-mcp"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add arceedev-contabridge-mcp --command uvx --arg contabridge-mcp
```

### Hermes

```yaml
mcp_servers:
  arceedev-contabridge-mcp:
    command: "uvx"
    args: ["contabridge-mcp"]
```

### Netclaw

```json
{
  "McpServers": {
    "arceedev-contabridge-mcp": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "contabridge-mcp"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add arceedev-contabridge-mcp -t stdio -c uvx -a contabridge-mcp
```

### Other

```json
{
  "mcpServers": {
    "arceedev-contabridge-mcp": {
      "command": "uvx",
      "args": [
        "contabridge-mcp"
      ]
    }
  }
}
```

## 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-11-20 (score 81, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-11-18 (score 65, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-17 (score 64, −15)

- [security regression] Malware scan: pass → unverified

### 2026-11-16 (score 79, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-11-15 (score 63, −15)

- [security regression] Malware scan: pass → unverified
- [functional] Package version: 0.4.0 → 0.4.1

### 2026-11-14 (score 78, +1)

No change was recorded against any check on this day. Stability & Change Management went from 23 to 27. That category is still filling its 30-day observation window: 7 days of observed history at the previous scan, 8 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-11-12 (score 77, +16)

- [security improvement] Malware scan: unverified → pass

### 2026-11-10 (score 61, +1)

- [security improvement] Malware scan: unverified → pass
- [functional regression] Schema quality: 3458 → 4065
- [functional] Schema quality: fair → good
- [functional] Package version: 0.3.0 → 0.4.0

## MCP tools (11)

### `convert_journal` (~807 tokens)

Convert journal between accounting programs

Convert a libro diario (journal) between Spanish accounting programs.

Formats: `a3` (a3ASESOR/a3ECO/a3CON SUENLACE.DAT, apuntes tipo 0), `contaplus_csv` (Sage ContaPlus / Sage 50
Diario CSV, 142 fields), `contaplus_ascii` (XDiario.txt fixed width), `contasol` (ContaSol APU.ods, destination only:
save content_base64 as APU.ods and import it in Utilidades > Importaciones), `csv` (spreadsheet with header:
Holded, Excel, any ERP; columns auto-detected, override with column_map), `quickbooks_iif` (QuickBooks
Desktop general journal), `quickbooks_csv` (QuickBooks Online journal import), `xero_csv` (Xero manual
journal import). The source is auto-detected. QuickBooks/Xero accounts are names or codes, not PGC
subaccounts: use account_map to translate them when converting to or from A3/ContaPlus.

Args:
    target_format: a3 | contaplus_csv | contaplus_ascii | contasol | csv | quickbooks_iif | quickbooks_csv | xero_csv.
    content: The file as text. content_base64: raw bytes as base64 (Latin-1/CP1252 files with Ñ).
    source_format: auto (default) or one of the formats.
    account_digits: Resize every subaccount to this length (ContaPlus uses a fixed length, e.g. 8);
        also expands '430.1' shorthand. 0 keeps them.
    account_split: Where zeros are inserted/removed when resizing (default 4: 4300001 -> 43000001).
    account_map: Exact account renames applied first, e.g. {"5720001": "57200005"}.
    start_entry_number: Renumber entries from this number (ContaPlus requires numbers; A3 does not use them).
    company_code: A3 company code (1-99999). a3_format: 5 (512-byte records, current) or 4 (256, old).
    column_map: For csv sources, e.g. {"debit": "Importe D", "account": "Cta"}. Keys: number, date, account,
        account_name, debit, credit, amount, dh, concept, document.
    csv_delimiter: For csv source/target; auto-detected on read, ';' on write.
    decimal_comma: csv output with decimal comma (Spanish Excel). fiscal_year: flag dates outside it.
    stric…

Input parameters:

- `a3_format` (integer)
- `account_digits` (integer)
- `account_map`
- `account_split` (integer)
- `column_map`
- `company_code` (string)
- `content` (string)
- `content_base64` (string)
- `csv_delimiter` (string)
- `date_style` (string)
- `decimal_comma` (boolean)
- `fiscal_year` (integer)
- `source_format` (string)
- `start_entry_number` (integer)
- `strict` (boolean)
- `target_format` (string, required)
- `xero_tax_rate` (string)

### `validate_journal` (~182 tokens)

Validate journal before import

Check a journal file the way A3/ContaPlus check it on import, before you send it.

Reports unbalanced entries (with the difference), lines with both or neither debit and credit, non-numeric
accounts or accounts outside PGC groups 1-9, mixed subaccount lengths and dates outside `fiscal_year`.
\`valid` is false when any error is found. include_entries returns the first 50 entries parsed.
QuickBooks/Xero files are checked against their own chart (any non-empty account), not the PGC.

Input parameters:

- `column_map`
- `content` (string)
- `content_base64` (string)
- `csv_delimiter` (string)
- `date_style` (string)
- `fiscal_year` (integer)
- `include_entries` (boolean)
- `source_format` (string)

### `bank_to_journal` (~785 tokens)

Book Norma 43 bank statement as journal

Turn a bank statement (Norma 43, the bank's Excel/CSV export, or a movements list) into journal entries.

One entry per movement: abono -> Debe bank / Haber counterpart; cargo -> Debe counterpart / Haber bank.
The counterpart comes from the first matching rule; with no match it goes to `suspense_account`
(default 555 'partidas pendientes de aplicación', padded to the bank account length) and the movement is
listed in `unmatched`, so nothing is guessed.

Args:
    bank_account: The 572 subaccount of the bank, e.g. "57200001" (for QuickBooks/Xero: that program's
        bank account name or code, and suspense_account is then required).
    target_format: csv (default) | a3 | contaplus_csv | contaplus_ascii | contasol | quickbooks_iif |
        quickbooks_csv | xero_csv.
    content / content_base64: The .n43 file (base64 for CP850/Latin-1 bytes), or the bank's CSV export
        (Excel saved as CSV: a header row with fecha + importe, or cargo + abono, and concepto).
    movements: Instead of a file, [{"date": "2026-03-05", "amount": "-121.00", "text": "IBERDROLA"}] for
        statements read from Excel or PDF (+ money in, - money out).
    open_items: Pending invoices to settle FIRST, before rules: [{"account": "43000012", "amount": "1210.00",
        "reference": "F-2026-031", "name": "Talleres Ruiz", "date": "2026-02-28"}]. Signed as the bank sees it
        (+ cobro de cliente, - pago a proveedor). A movement is booked against the customer/supplier subaccount
        only on the same amount AND a unique reference or name in the bank text (or a unique amount within
        window_days). Ties are listed in open_items.ambiguous and never guessed. invoices_to_journal returns
        these items ready to pass here.
    rules: Ordered list, first match wins. Each: {"account": "62800000", "contains": ["IBERDROLA"] or "regex":
        "...", "common_concept": "03" (AEB concept, e.g. 03 recibos, 04 transferencias, 12 comisiones),
        "direction": "cargo"|"abono", "con…

Input parameters:

- `a3_format` (integer)
- `account_digits` (integer)
- `account_split` (integer)
- `bank_account` (string, required)
- `bank_accounts`
- `company_code` (string)
- `content` (string)
- `content_base64` (string)
- `date_style` (string)
- `decimal_comma` (boolean)
- `movements`
- `open_items`
- `rules`
- `start_entry_number` (integer)
- `suspense_account` (string)
- `target_format` (string)
- `use_value_date` (boolean)
- `window_days` (integer)
- `xero_tax_rate` (string)

### `pdf_bank_to_journal` (~530 tokens)

Book bank statement PDF as journal

Read a digital bank statement PDF (Revolut, Wise, N26, CaixaBank, BBVA, Santander... downloaded from online
banking, with selectable text) and turn it into journal entries or a Norma 43 file.

Deterministic: the movements table is located by its header (Fecha, Concepto, Cargo/Abono or Importe, Saldo)
and each value is read from its column. No OCR and no AI: scanned PDFs are refused, not guessed. Every row is
checked: previous balance + amount = printed balance, and opening + money in - money out = closing balance.
Rows that do not add up are booked but listed in `flagged_rows` with status "mismatch"; rows whose sign
(cargo/abono) cannot be proven go to status "review" and are NOT booked. Check `balance_check.balanced`.

Args:
    content_base64: The PDF file bytes in base64.
    target_format: contasol (APU.ods, default) | a3 | contaplus_csv | contaplus_ascii | csv | quickbooks_iif |
        quickbooks_csv | xero_csv | norma43 (a .n43 file to import in any program that reads Cuaderno 43).
    bank_account: The 572 subaccount of the bank (default 57200001).
    rules / suspense_account / open_items / window_days: As in bank_to_journal.
    strict_balance: true refuses to produce any file (and charges nothing) unless every row and the closing
        balance add up.
    account_ccc: For norma43 when the PDF has no Spanish IBAN: 20-digit CCC for record 11.
    holder: Account holder name for the Norma 43 header (optional).

Input parameters:

- `a3_format` (integer)
- `account_ccc` (string)
- `account_digits` (integer)
- `account_split` (integer)
- `bank_account` (string)
- `company_code` (string)
- `content_base64` (string, required)
- `date_style` (string)
- `decimal_comma` (boolean)
- `holder` (string)
- `open_items`
- `rules`
- `start_entry_number` (integer)
- `strict_balance` (boolean)
- `suspense_account` (string)
- `target_format` (string)
- `use_value_date` (boolean)
- `window_days` (integer)
- `xero_tax_rate` (string)

### `build_journal` (~245 tokens)

Build journal import file

Write journal entries you composed (e.g. from invoices or a payroll summary) as an import file.

entries: [{"date": "2026-03-31", "number": 1 (optional), "lines": [{"account": "64000000", "debit": "1500.00",
"concept": "Nómina marzo"}, {"account": "47510000", "credit": "225.00"}, ...]}]. Entries must balance:
an unbalanced entry is refused before any charge, with the difference. target_format accepts every format of
convert_journal, including quickbooks_iif, quickbooks_csv and xero_csv (date_style / xero_tax_rate as there).

Input parameters:

- `a3_format` (integer)
- `account_digits` (integer)
- `account_split` (integer)
- `company_code` (string)
- `date_style` (string)
- `decimal_comma` (boolean)
- `entries` (array, required)
- `fiscal_year` (integer)
- `start_entry_number` (integer)
- `target_format` (string, required)
- `xero_tax_rate` (string)

### `invoices_to_journal` (~704 tokens)

Book invoices with VAT as journal

Book issued and received invoices (facturas emitidas y recibidas) as journal entries with VAT split out.

Read each invoice (PDF, photo, Facturae, email) yourself and pass its figures; this tool does the bookkeeping
deterministically. Per invoice: {"kind": "issued"|"received", "number": "F-2026-031", "date": "2026-02-28",
"nif": "B12345678", "name": "Talleres Ruiz SL", "taxes": [{"base": "1000.00", "rate": "21", "vat": "210.00"
(optional, checked), "recargo_rate": "5.2" (optional)}], "irpf_rate": "15" or "irpf_amount": "150.00"
(optional), "total": "1060.00" (optional but recommended: checked), "account": "43000012" (optional),
"counterpart_account": "62300000" (optional, default 700 / 600), "concept": optional}.
Shortcut for one VAT rate: "base" + "vat_rate". Negative amounts = factura rectificativa (sides swap).

Issued: Debe 430 total (+ 473 IRPF retenido por el cliente) / Haber 700 base + 477 IVA. Received: Debe 600
base + 472 IVA / Haber 4751 IRPF + 400 total. Tax is recomputed (base x rate, half up); a 1-cent difference
with the invoice total is absorbed in the largest tax line, more than that sends the invoice to `review`
with the reason, unbooked. Duplicates (same kind + NIF + number) also go to `review`.

Args:
    accounts: Override default roots {customers 430, suppliers 400, sales 700, purchases 600, vat_output 477,
        vat_input 472, irpf_withheld 4751, irpf_suffered 473}.
    party_accounts: {NIF: subaccount}, e.g. {"B12345678": "43000012"}. Invoices with no account are booked to
        the generic 430/400 and listed in generic_party_account so the accountant assigns them.
    vat_accounts: {rate: subaccount}, e.g. {"21": "47700021", "10": "47700010", "re5.2": "47700052"}.
    target_format / account_digits / company_code / ...: as in build_journal.

Returns the import file, `vat_summary` (base and cuota per rate for the libro registro / modelo 303),
\`vat_register` (one row per invoice and rate), `review` and `open_items` to pass to bank_to_journ…

Input parameters:

- `a3_format` (integer)
- `account_digits` (integer)
- `account_split` (integer)
- `accounts`
- `company_code` (string)
- `date_style` (string)
- `decimal_comma` (boolean)
- `fiscal_year` (integer)
- `invoices` (array, required)
- `party_accounts`
- `start_entry_number` (integer)
- `target_format` (string)
- `vat_accounts`
- `xero_tax_rate` (string)

### `bank_statement_csv` (~159 tokens)

Convert bank statement to bank-feed CSV

Turn a Norma 43 (Cuaderno 43) statement into a bank statement CSV that Xero or QuickBooks Online import.

target: xero (precoded statement: *Date, *Amount, Payee, Description, Reference) or quickbooks (3 columns:
Date, Description, Amount). Amounts are signed (abono +, cargo -). date_style: mdy | dmy | iso (default mdy for
QuickBooks, dmy for Xero). account: last digits of one bank account when the file holds several.

Input parameters:

- `account` (string)
- `content` (string)
- `content_base64` (string)
- `date_style` (string)
- `target` (string, required)

### `resize_account` (~66 tokens)

Resize PGC subaccount

Resize or expand a Spanish subaccount code. Free. '430.1' -> '43000001'; 4300001 (7) -> 43000001 (8).

Input parameters:

- `account` (string, required)
- `digits` (integer, required)
- `split` (integer)

### `detect_format` (~63 tokens)

Detect accounting file format

Tell which accounting import format a file is (a3, contaplus_csv, contaplus_ascii, csv, quickbooks_iif,
quickbooks_csv, xero_csv). Free.

Input parameters:

- `content` (string)
- `content_base64` (string)

### `pricing` (~20 tokens)

Show tool prices

Credit price of each tool and where to buy credits. Free.

### `credits_balance` (~19 tokens)

Check credit balance

Remaining credits on your KeyFlint license. Free.

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2#diagnostics

## Score history

- 2026-11-21: 81
- 2026-11-20: 81
- 2026-11-19: 65
- 2026-11-18: 65
- 2026-11-17: 64
- 2026-11-16: 79
- 2026-11-15: 63
- 2026-11-14: 78
- 2026-11-13: 77
- 2026-11-12: 77
- 2026-11-11: 61
- 2026-11-10: 61
- 2026-11-09: 60
- 2026-11-08: 74
- 2026-11-07: 74
- 2026-11-06: 59

## Common questions

### What is the ContaBridge MCP server?

ContaBridge is an MCP server listed in the public MCP registry as io.github.ArceeDev/contabridge-mcp. Convert journals between A3, ContaPlus/Sage 50, QuickBooks, Xero and CSV; bank files to entries. This page covers its PyPI package (contabridge-mcp).

### Is the ContaBridge MCP server safe to use?

ContaBridge scores 81 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. Its build provenance is signed and verified. 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 ContaBridge MCP server expose?

ContaBridge exposes 11 tools: convert_journal, validate_journal, bank_to_journal, pdf_bank_to_journal, build_journal, and 6 more. Their descriptions and schemas cost roughly 3,580 tokens of context every time the server is loaded.

### Is the ContaBridge MCP server still maintained?

ContaBridge is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the ContaBridge MCP server under?

ContaBridge declares the BUSL-1.1 licence, which is not on the OSI-approved list. Read the terms before using it at work, and note this covers the source only, not the cost of any service it calls.

### What did VerifyMCP test on the ContaBridge MCP server?

VerifyMCP ran 17 checks on ContaBridge, covering Malware scan, Known CVEs, Install scripts, Dependency health and 13 more. Endpoint Security and Transport & Reachability do not apply to a PyPI package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- PyPI project: https://pypi.org/project/contabridge-mcp/
- Socket report: https://socket.dev/pypi/package/contabridge-mcp
- Repository: https://github.com/ArceeDev/contabridge-mcp
- Website: https://mcp.keyflint.dev/
- Changelog RSS feed: https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2.xml
- Changelog JSON feed: https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2.json
- HTML version of this page: https://verifymcp.io/servers/arceedev-contabridge-mcp/contabridge-mcp-2
