# Tool-Übersicht, MCP-Version 2026-11-01 (https://developer.bimetrics.de/mcp/tools/2026-11-01)

Die Werkzeuge der MCP-Version 2026-10-23, nutzbar auch in der kostenlosen Testphase, und das Erfassen von Zahlungen.

Diese MCP-Version gilt, sobald das [Rechtspaket 2026-11-01-v1](https://bimetrics.de/rechtliches/2026-11-01-v1/avv#anlage-mcp-verbindungen) veröffentlicht ist, mit dessen Anlage „MCP-Verbindungen“. Sie hat dieselben Werkzeuge wie die [MCP-Version 2026-10-23](/mcp/tools/2026-10-23), mit denselben Lese- und Schreibrechten. Neu ist, dass sich KI-Assistenten dann auch in der kostenlosen Testphase verbinden können. Mit eingeschalteter Zahlungserfassung kommen [drei Werkzeuge für Zahlungen](#zahlungen-erfassen) dazu.

## Was sich ändert

- **`get_company_context`:** Liefert in der Testphase zusätzlich `trial` mit dem Ende (`endsAt`) und den Belegen (`documentsUsed` von `documentsLimit`). Mit einem Tarif fehlt das Feld.
- **`prepare_document_upload`:** Nennt die 100 Belege der Testphase, die für alle Wege zusammen gelten, und sagt, was bei `402 LimitReached` und `429 WriteBudgetExceeded` zu tun ist. Der Befehl im Feld `curl` nutzt `--fail-with-body` und zeigt so auch die Antwort eines abgelehnten `PUT`.

## In der Testphase

- **Tagesgrenzen:** Die Grenzen für Abfragen, Änderungen und Festschreibversuche gelten je Unternehmen für KI-Assistenten und API zusammen. Die Werte stehen unter [Limits](/limits).
- **Serien:** Bleiben wie in jeder Version Entwürfe. Ausstellende Serien richtest du in der App ein.
- **Nach dem Ende:** Werkzeuge antworten mit einem Hinweis, Verbindungsaufbau und Werkzeugliste mit `403`. In der App bleiben Verbindungen sichtbar und lassen sich trennen. Mit einem Tarif funktionieren sie wieder, die Anwendung kann dafür ein neues Verbinden verlangen.

## Zahlungen erfassen

Sobald bimetrics die Zahlungserfassung einschaltet, kommen drei Werkzeuge dazu. Bis dahin fehlen sie in der Werkzeugliste. Ältere Versionen erhalten sie nicht.

| Werkzeug | Inhalt |
| --- | --- |
| `get_document_payment` | Zahlungsstand eines Belegs wie unter „Als bezahlt markieren“ in der App: offener Betrag (`amountOpenMinor`), Version, ob Buchungen schon an DATEV exportiert sind, wie die Firma eine private Zahlung bucht (`private.treatment`, bei GmbH und UG mit dem Betrag, den sie den Gesellschaftern schuldet), die Geschäftsführung aus den Einstellungen und die erfassten Zahlungen mit ID. Lesefreigabe genügt. |
| `record_document_payment` | Nur mit `mcp:write`: eine schon erfolgte Zahlung erfassen, `method` `cash` (bar aus der Kasse), `private` (privat bezahlt, nur Eingangsbelege, optional mit `paidBy`) oder `clearing` (anderer Weg über das Verrechnungskonto). Das Konto wählt bimetrics wie bei der [API](/write-operations#zahlungen-zuordnen-und-erfassen). |
| `reverse_document_payment` | Nur mit `mcp:write`: eine erfasste Zahlung mit einer Gegenbuchung zurücknehmen, auch nach einem DATEV-Export. Erstattungen und Verrechnungen aus Rechnungskorrekturen nimmt weiter `record_correction_settlement` zurück. |

- **Bucht sofort:** Beide Schreibwerkzeuge buchen gleich, wie in der App. Eine erfasste Zahlung lässt sich nicht ändern, nur zurücknehmen und neu erfassen. Überwiesen wird nichts. Eine Zahlung, die schon als Bankumsatz da ist, ordnet `create_match` zu.
- **Bestätigung:** Beide sind als destruktiv gekennzeichnet (`destructiveHint`), damit die Anwendung vorher bei dir nachfragt. Erst wenn du die Zahlung gesehen und ausdrücklich beauftragt hast, setzt der Assistent `confirmed: true`.
- **Version:** `expectedVersion` und `expectedAmountOpenMinor` kommen unverändert aus `get_document_payment`. Hat sich der Beleg seitdem geändert, antwortet das Werkzeug mit `VersionConflict` und bucht nichts. `idempotencyKey` wiederholt nur genau denselben Auftrag.
- **Erstattung:** Erstattet die GmbH den Betrag, ordnet `create_match` die Überweisung der Vorlage „Gesellschafter-Verrechnung“ zu (`documentSeriesIds` aus `list_document_templates`).
- **Grenzen:** wie in der App. Nicht für Belege aus Vorlagen oder Verträgen, Belege mit Buchungsfehlern und Belege, die zusammen mit anderen zugeordnet sind. Belege mit an DATEV exportierten Buchungen nehmen seit dem 06.11.2026 eine Zahlung an; sie geht mit dem nächsten DATEV-Export ihres Monats an die Kanzlei. In der Testphase zählen die Aufrufe zu den Tagesgrenzen.