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

DATEV-Export starten, Kassenbuch führen, Anlagen und Abschreibungen, Kostenstellen, Summen- und Saldenliste, Mahnlauf, Fremdwährung, Kontakte zusammenführen sowie Ergänzungen bei Zuordnungen, Rechnungen und Angeboten.

Diese MCP-Version ergänzt die [Werkzeuge der MCP-Version 2026-11-05](/mcp/tools/2026-11-05), mit denselben Lese- und Schreibrechten, um neue Werkzeuge und Änderungen an bestehenden. Es gilt die Anlage „MCP-Verbindungen“ aus dem [Rechtspaket 2026-11-17-v1](https://bimetrics.de/rechtliches/2026-11-17-v1/avv#anlage-mcp-verbindungen). Für die neuen Werkzeuge ist nach Anlage 2.3 eine neue Freigabe nötig. Bestehende Verbindungen behalten ihren Umfang, bis du neu verbindest.

Die neuen Werkzeuge nutzen dieselben Dienste und Befehle wie App und REST-API, mit denselben Sperren und Rollen. Wo MCP strenger ist, steht es dabei. Weiter gilt: Überwiesen wird nichts. Ausgestellte Rechnungen, Buchungen und Kontakte mit Belegen lassen sich nicht löschen. Was sich nicht zurücknehmen lässt, etwa der DATEV-Export mit Festschreibung oder der Abschluss eines Kassenmonats, führt die Anwendung erst nach einer Vorschau und deinem ausdrücklichen Ja aus.

## Auf der Freigabeseite

Der Schalter **Ändern wie in der App** nennt jetzt auch den DATEV-Export mit Festschreibung. Unter **Details** stehen zusätzlich das Kassenbuch, Anlagen und Abschreibungen, Kostenstellen, der Mahnlauf und das Zusammenführen von Kontakten. Kontakte liest die Anwendung jetzt samt Notiz.

## DATEV-Export

| Werkzeug | Was es tut |
| --- | --- |
| `preview_datev_export` | Nur mit Schreibzugriff, denn es bucht wie der Export in der App zuerst, was noch nicht gebucht ist. Nennt die Zahl der offenen Buchungen des Zeitraums, die der Export festschreibt (`openBookings`), dazu Nachträge außerhalb des Zeitraums und Stornos auf Konten, die DATEV nicht mehr annimmt. Schreibt nichts fest. Liefert einen `previewToken`, 15 Minuten gültig, der nur für diese Angaben und diese Zahl gilt. |
| `start_datev_export` | Fragt vorher nach. Startet den Export genau so, wie die Vorschau ihn zeigte, mit `openBookings`, `previewToken`, `idempotencyKey` und `confirmed`. Ein Export mit Buchungen schreibt die offenen Buchungen des Zeitraums fest; das lässt sich nicht rückgängig machen, eine Korrektur geht danach nur per Storno und Neubuchung. Weicht die Zahl inzwischen ab, schreibt bimetrics nichts fest und nennt die neue Zahl. |
| `get_datev_export` | Lesend. Stand, Schritt, Fehler mit Bedeutung und ob festgeschrieben ist. Die Datei gibt es nicht im Chat, nur den Link auf Einstellungen › Exporte in der App, wo du sie herunterlädst. |
| `cancel_datev_export` | Bricht einen Export ab, solange er wartet. Dann wird nichts festgeschrieben. |

- Wie in App und REST-API nur Zeiträume innerhalb eines Kalenderjahres.
- bimetrics schickt nichts an die Kanzlei. Du lädst die Datei in der App herunter und gibst sie weiter.
- `get_export_check` nennt zusätzlich Belege mit offenem Belegtyp (`kindReview`), Belege in Fremdwährung ohne Euro-Betrag (`foreignCurrency`), bei Ist-Versteuerung Zahlungseingänge ohne Zuordnung und ohne Rechnungsnummer (`cashBasis`), Nachträge in schon exportierten Monaten (`addenda`, je Monat und je Jahr mit dem Hinweistext aus `Meldungen.csv`) und Stornos auf Konten, die DATEV nicht mehr annimmt (`reservedReversals`).
- `search_bookings` und `get_booking` nennen einen Nachtrag mit `addendum`: DATEV hat die Buchung noch nicht, obwohl ein Export ihr Datum schon umfasste.
- `set_datev_asset_mode` hält fest, ob deine Kanzlei die Abschreibungen selbst in DATEV rechnet. Davon hängt ab, ob der Export Abschreibungen und Restbuchwerte mitliefert.

## Kassenbuch

| Werkzeug | Was es tut |
| --- | --- |
| `list_cash_books` | Lesend. Ob Kassenbücher eingeschaltet sind, und je Kassenbuch Konto, Beginn, Anfangsbestand, Bestand, letzter abgeschlossener Monat und ob es stillgelegt ist. |
| `get_cash_book` | Lesend. Ein Monat mit Bestand vorher und nachher und jedem Tag mit seinen Buchungen. |
| `preview_cash_book_entries`, `create_cash_book_entries` | Buchungen prüfen und nach deinem Ja erfassen: Ausgaben mit Eigenbeleg, Einlagen und Entnahmen, Geldtransit zwischen Bank und Kasse und die Barzahlung eines Belegs. Einzelne Barverkäufe erfasst du hier nicht: bimetrics ist keine Registrierkasse. |
| `reverse_cash_book_entry` | Fragt vorher nach. Storniert eine Buchung mit Grund und eigener Nummer. Buchungen werden nie geändert oder gelöscht. |
| `link_cash_book_bank_transaction` | Ordnet einer Geldtransit-Buchung den Bankumsatz mit dem Gegenbetrag zu. |
| `preview_cash_count`, `record_cash_count` | Vergleicht gezähltes Geld mit dem Bestand und hält die Zählung nach deinem Ja fest. Eine Differenz bucht bimetrics nur, wenn du das so entscheidest. |
| `preview_cash_month_close`, `close_cash_month` | Prüft den Monatsabschluss und schließt den Monat nach deinem Ja endgültig ab. Danach geht nichts mehr in den Monat, seine Buchungen sind festgeschrieben. Nur Inhaber und Kanzlei. |
| `download_cash_book` | Lesend. Ein Monat als PDF zum Drucken oder Weitergeben. |
| `download_cash_book_audit_export` | Lesend. Der Prüfungsexport eines Jahres als ZIP mit Buchungen, Änderungsprotokoll und Prüfsummen. |
| `set_cash_book_enabled`, `save_cash_book` | Nur für den Inhaber und nur auf deinen Wunsch: Kassenbücher einschalten, ein Kassenbuch anlegen, umbenennen oder endgültig stilllegen. |

Wie in der App: höchstens drei Kassenbücher zugleich, vorerst nur als Handkasse. Der Bestand darf nach keiner Buchung unter 0 fallen.

## Anlagen und Abschreibungen

| Werkzeug | Was es tut |
| --- | --- |
| `list_assets`, `get_asset` | Lesend. Das Anlagenverzeichnis eines Jahres mit den Werten des Jahres, eine Anlage mit Plan je Jahr und ihren Buchungen. |
| `get_asset_report` | Lesend. Anlage AVEÜR oder Anlagenspiegel eines Jahres aus gebuchten Werten. |
| `search_useful_life` | Lesend. Sucht die Nutzungsdauer in der amtlichen AfA-Tabelle mit Wörtern aus dem Alltag. |
| `preview_asset`, `create_asset` | Prüft eine neue Anlage und legt sie nach deinem Ja an: aus Belegpositionen, als Altbestand oder als Einlage aus dem Privatvermögen. Die AfA bis heute wird nachgebucht. |
| `list_opening_candidates`, `preview_asset_import`, `import_assets` | Altbestand übernehmen: Positionen älterer Belege finden, eine Liste von bis zu 100 Anlagen prüfen und nach deinem Ja übernehmen. |
| `preview_asset_plan`, `change_asset_plan` | Eine neue Restnutzungsdauer prüfen und nach deinem Ja ab dem ersten noch nicht gebuchten Monat setzen. |
| `preview_asset_disposal`, `dispose_asset` | Verkauf oder Verschrottung prüfen und nach deinem Ja buchen: AfA bis zum Abgang, Restbuchwert, Gewinn oder Verlust. |
| `reverse_asset_disposal` | Fragt vorher nach. Nimmt einen Abgang zurück. |
| `reverse_asset` | Fragt vorher nach. Nimmt eine Anlage zurück (innerhalb von 30 Tagen, solange nichts festgeschrieben ist) oder storniert sie mit Grund. Eine Anlage wird nie gelöscht. |

## Kostenstellen und Auswertungen

| Werkzeug | Was es tut |
| --- | --- |
| `list_cost_centers` | Lesend. Kostenstellen und Verteilungen mit Nummer (KOST1 im DATEV-Export), Anteilen und ob sie benutzt sind. |
| `save_cost_center` | Nur auf deinen Wunsch: anlegen, umbenennen, archivieren oder zurückholen. Benutzte Kostenstellen behalten Nummer und Anteile. Gelöscht wird nichts. |
| `get_cost_center_report` | Lesend. Erträge, Aufwand, gezahlte Personalkosten und Ergebnis je Kostenstelle für Monat, Quartal oder Jahr, im Vergleich zum Zeitraum davor. |
| `get_open_items` | Lesend. Die Offene-Posten-Liste zum Stichtag je Kunde oder Lieferant, mit Summen nach Alter und den Posten, wie „Offene Posten“ in der App und wie die Kanzlei sie liest. |
| `download_open_items` | Lesend. Dieselbe Liste als PDF zum Ausdrucken oder als CSV, etwa für die Kanzlei. |
| `get_trial_balance` | Lesend. Die Summen- und Saldenliste eines Zeitraums innerhalb eines Kalenderjahres mit EB-Wert, Soll, Haben und Saldo je Konto, wie der Reiter „Salden“ in der App. Höchstens 150 Konten je Aufruf, die nächsten mit `offset`. |

Eine Kostenstelle kommt mit `update_document` oder `apply_bulk_document_change` an einen Beleg.

## Zuordnungen

| Werkzeug | Was es tut |
| --- | --- |
| `preview_match_cash_discount`, `settle_match_cash_discount` | Den offenen Betrag einer Zuordnung als Skonto ausgleichen, ohne sie vorher aufzuheben. |
| `preview_match_reminder_charges`, `settle_match_reminder_charges` | Was über den Rechnungsbetrag hinaus gezahlt wurde, als Mahnkosten und Zinsen der letzten Mahnung buchen. |
| `preview_match_exchange_difference`, `settle_match_exchange_difference` | Den Rest einer Zuordnung mit Belegen in Fremdwährung als Kursdifferenz buchen. Bei ungewöhnlich großer Abweichung (`aboveLimit`) erst nach Rückfrage. |
| `preview_match_euro_amount`, `apply_match_euro_amount` | Für den Beleg einer Zuordnung den Euro-Betrag der Zahlungen übernehmen. |
| `write_off_document` | Fragt vorher nach. Bucht den Rest eines Belegs als Rundungsdifferenz (höchstens 1 €) oder bei einer Ausgangsrechnung als Forderungsverlust mit Begründung aus. Zurück mit `reverse_document_payment`. |
| `set_rule_learning` | Schaltet „Aus Zuordnungen lernen“ für die Firma ein oder aus, nur auf deinen Wunsch. |
| `set_document_template_auto_assign` | Schaltet ein, dass bimetrics Bankumsätze einer Belegvorlage selbst zuordnet, nach dem Muster einer Zuordnung, die du vorher von Hand gemacht hast. |

- Skonto, Mahnkosten, Kursdifferenz und Euro-Betrag bucht bimetrics über MCP nicht, wenn die Buchungen schon an DATEV exportiert sind; das geht nur in der App.
- `get_open_amount` nennt `cashDiscountReference` und `reminderCharges`, `get_match` erklärt ein von bimetrics selbst ausgeglichenes Skonto, `delete_match` nennt, was das Aufheben zurücknimmt.
- `extend_match` und `search_bookings` sagen: Ändert sich bei einer festgeschriebenen Buchung nur die Zuordnung, bleibt die Buchung stehen. Storno und Neubuchung gibt es nur, wo sich für DATEV etwas ändert.

## Belege

- **Belegtyp prüfen:** `get_document` und `search_documents` nennen `kindReview`, solange der Belegtyp offen ist. Bis zur Wahl wird der Beleg nicht gebucht, nicht exportiert und nicht zugeordnet. `update_document` mit `kind` beendet die Prüfung, `preview_bulk_document_change` und `apply_bulk_document_change` setzen den Belegtyp mit der Aktion `kind` für bis zu 50 Belege.
- **Fremdwährung:** `get_document` und `search_documents` nennen Belegwährung, Betrag vom Beleg und „Euro-Betrag fehlt“ (`currencyReview`). `update_document` und `preview_document_change` tragen den Euro-Betrag ein, rechnen zum Monatskurs des BMF um (`euroAtMonthlyRate`) oder übernehmen die Steuer in Euro laut Rechnung (`euroTaxAmounts`). Die Sammelaktion `monthly_rate` rechnet bis zu 50 Belege zum Monatskurs um. `record_document_payment` nimmt eine Zahlung in Belegwährung; `get_document_payment` nennt dann, was in der Belegwährung noch offen ist (`amountOpenOriginalMinor`), und je Zahlung Kurs und Kursdifferenz. `search_transactions` und `get_transaction` nennen bei Umsätzen aus einem Fremdwährungskonto den Betrag laut Bank mit Währung und Kurs; mit `originalCurrency` sucht `search_transactions` nach diesem Betrag.
- **Leistungszeitraum je Position:** `get_document` nennt `positionPeriods`, `update_document` und `preview_document_change` setzen sie.
- **Summe weicht ab:** `get_document` nennt `totalMismatch`, wenn die Positionen nicht den Gesamtbetrag laut Beleg ergeben. `statedTotalMinor` 0 in `update_document` beendet den Hinweis wie „Summe passt so“.
- **Lange Dateien und Erneut lesen:** `get_document` nennt `partlyRead`, wenn bimetrics nur die ersten 60 Seiten gelesen hat. `retry_document_reading` startet das Lesen eines fehlgeschlagenen Belegs neu; das zählt wie in der App als weiterer Beleg ins Kontingent.
- **Bezahlte Belege:** `update_document` ändert Rechnungsnummer und Fälligkeit auch an bezahlten Belegen.
- **Nach dem DATEV-Export:** `update_document` berichtigt auch Belege, deren Buchungen schon an DATEV gingen. bimetrics storniert die Buchung in ihrem Monat und bucht neu; `addendaMonths` nennt die Monate, die du dafür noch einmal mit „Nur noch nicht exportierte“ exportierst. `create_match` und `delete_match` tun das mit `confirmExported` erst, nachdem du die betroffenen Monate gesehen und bestätigt hast.

## Rechnungen, Angebote und Mahnungen

- **Optionale Positionen und Titel:** `create_sales_draft` und `update_sales_draft` nehmen je Position `option`, `title` und `subtitle`, `get_sales_document` und `preview_sales_document` nennen sie. `derive_sales_document` nimmt mit `selectedLines` die beauftragten Positionen.
- **Abschlags- und Schlussrechnung:** `derive_sales_document` erstellt aus einem Auftrag eine Abschlagsrechnung (`invoiceRole` `down_payment`, Betrag in Prozent oder Cent) oder die Schlussrechnung (`final`). `update_sales_draft` ändert den Betrag eines Abschlags. Prüfung und Vorschau der Schlussrechnung nennen die Abzüge der bezahlten Abschläge. Sie zeigen auch, welche Abschläge das Ausstellen storniert (unbezahlt) oder auf den gezahlten Betrag korrigiert (teilweise bezahlt). Ist dabei ein offener Betrag betroffen, braucht `finalize_sales_draft` dein ausdrückliches Ja (`acceptCancelOpenDownPayments`).
- **Steuersätze und Steuerfall:** `check_sales_draft` nennt die Sätze, die der Steuerfall je Position erlaubt, und je Problem den Parameter, der es behebt. Für Rechnungen kommen dazu: der Pflichthinweis (`taxHintText`), die Bestätigung deutscher Umsatzsteuer ohne USt-IdNr. (`acceptStandardVatWithoutVatId`, nur nach deinem ausdrücklichen Ja) sowie Lieferdatum und Lieferadresse (`delivery`). Für Positionen gibt es die Art `property_service` für Leistungen an einem Grundstück.
- **Sicherheitseinbehalt:** Rechnungen können einen Sicherheitseinbehalt tragen (`retention`). `preview_retention_release` und `release_retention` stellen den Einbehalt ab heute fällig; das lässt sich nicht zurücknehmen. `get_open_tasks` nennt die Zeile „Einbehalt fällig“.
- **Zahlstand:** `search_sales_documents` filtert Rechnungen nach Zahlstand, Mahnstufe und Fälligkeit und liefert mit `includeCounts` die Zahlen für die Reiter der Rechnungsliste. `get_sales_document` nennt `payment`.
- **Ergebnis von Angeboten:** `set_proposal_outcome` hält fest, ob der Kunde ein ausgestelltes Angebot angenommen oder abgelehnt hat, oder nimmt das zurück, nur auf deinen Wunsch. `search_sales_documents` filtert und zählt Angebote nach Ergebnis.
- **Mahnsperre:** `set_reminder_hold` setzt die Mahnsperre einer Rechnung oder hebt sie auf, nur auf deinen Wunsch. `update_contact` nimmt „Nicht mahnen“ (`noReminders`).
- **Mahnlauf:** `preview_reminder_run` zeigt für bis zu 25 Rechnungen die Mahnung der nächsten Stufe mit Frist, Gebühr, Zinsen und Text. `apply_reminder_run` stellt genau das nach deinem Ja aus. Gesendet wird nichts; Mails gehen weiter einzeln über `send_document_mail`.
- **Weitere Mail-Anhänge:** `preview_document_mail` und `send_document_mail` nehmen bis zu 10 weitere Dateien, zusammen höchstens 10 MiB. Für eigene Dateien gibt `prepare_mail_attachment_upload` einen Upload-Link; ein Beleg wird daraus nicht.
- **Versandstand:** `get_sales_document` und `get_payment_reminder` nennen die neueste Mail mit dem Dokument und ob sie ankam.
- **Gesperrte Gutschrift und gesperrtes Storno:** `get_receivable` und `search_receivables` nennen den Grund und mit `correctableMinor`, um wie viel eine weitere Gutschrift die Rechnung noch mindern kann.
- **Texte neuer Entwürfe:** `create_sales_draft` nennt als Vorgabe die Textvorlage der Firma.

## Kontakte

| Werkzeug | Was es tut |
| --- | --- |
| `list_similar_contacts` | Lesend. Andere Kontakte, die dieselbe Firma sein könnten, und welcher beim Zusammenführen bleiben würde. |
| `preview_contact_merge`, `merge_contacts` | Zeigt, welche Belege zu einem anderen Kontakt wandern, und verschiebt sie nach deinem Ja. Festgeschriebene Buchungen werden storniert und neu gebucht. Exportierte Belege und ausgestellte Rechnungen bleiben beim bisherigen Kontakt. |
| `dismiss_similar_contact` | Fragt vorher nach. Hält fest, dass zwei ähnliche Kontakte verschiedene Firmen sind. Das lässt sich nicht zurücknehmen. |
| `lookup_address` | Lesend. Orte zu einer PLZ, PLZ zu einem Ort und Straßen in Deutschland, aus Listen von OpenStreetMap und, für Österreich, der RTR-GmbH. |

- `get_contact` und `search_contacts` lesen die Notiz am Kontakt, `create_contacts` und `update_contact` schreiben sie, höchstens 2.000 Zeichen und ohne E-Mail-Adressen, Links oder IBANs. Eine Notiz mit solchen Angaben änderst du nur in der App.
- `get_contact` nennt das Debitoren- bzw. Kreditorenkonto (`datevAccounts`) und eigene Zahlungsbedingungen des Kunden (`paymentTerms`), `update_contact` und `create_contacts` nehmen sie.

## Firma

`get_company_context` nennt bei Ist-Versteuerung `vatCashBasis` und mit `learnRules`, ob bimetrics aus Zuordnungen lernt. Die Versteuerung änderst du nur in der App.
