BuchhaltungsButler MCP-Server

Overview Schema Source Related Servers Discussions Admin

Summen- und Saldenliste anfordern

bb_reports_create_sums

Destructive

Starts generating a sum and balance list for all accounts in a BuchhaltungsButler tenant, returning an ID for later retrieval; optionally creates PDF, CSV, or ZIP exports.

Instructions

Stößt in BuchhaltungsButler die Erzeugung einer Summen- und Saldenliste über alle Konten des Mandanten an und liefert deren id_by_customer zurück; wahlweise entstehen dabei PDF, CSV und ein ZIP-Archiv mit den Kontenblättern. Die Berechnung läuft im Hintergrund; abgeholt wird das Ergebnis danach mit bb_reports_get_sums und report_id_by_customer, das bis zum Abschluss mit error_code 8 antwortet. Ein zweiter Aufruf vor dem Abschluss scheitert mit error_code 12. Eine Filterung auf einzelne Konten kennt die API nicht. Ersetzt die zuvor in BuchhaltungsButler erzeugte Auswertung desselben Typs. Buchungsdaten ändern sich dabei nicht, und die Auswertung lässt sich jederzeit neu erzeugen.

Input Schema

TableJSON Schema

Name	Required	Description
`base`	No	Datum der Periodenzuordnung: 'date' Buchungsdatum, 'date_delivery_else_date' Leistungsdatum und ersatzweise Buchungsdatum. Ohne Angabe 'date'. Die BWA der Weboberfläche wertet nach dem Leistungsdatum aus; beim Vergleich bewusst setzen.
`date_to`	Yes	Letzter Tag des Auswertungszeitraums als YYYY-MM-DD, zum Beispiel 2026-03-31. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. Der Zeitraum schließt diesen Tag ein; für ein vollständiges erstes Quartal also 2026-03-31 und nicht 2026-04-01.
`file_csv`	No	true erzeugt zusätzlich eine CSV-Datei. Abgeholt wird sie über bb_reports_get_sums mit get_files; ohne diese Angabe bleibt der Schlüssel csv dort null.
`file_pdf`	No	true erzeugt zusätzlich ein PDF. Abgeholt wird es über bb_reports_get_sums mit get_files; ohne diese Angabe bleibt der Schlüssel pdf dort null.
`date_from`	Yes	Erster Tag des Auswertungszeitraums als YYYY-MM-DD, zum Beispiel 2026-01-01. Ein leerer String wird abgelehnt; das Feld stattdessen weglassen. Der Zeitraum schließt diesen Tag ein.
`archive_export`	No	true erzeugt zusätzlich ein ZIP-Archiv aus CSV-Datei und den Kontenblättern aller bebuchten Konten. Im Objekt files von bb_reports_get_sums heißt es csv_archive, nicht archive_export. Das ersetzt viele Aufrufe von bb_reports_get_ledger.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`data`	No
`created`	No
`message`	No
`success`	Yes
`endpoint`	No
`reversal`	No
`_contract_warnings`	No
`fields_not_returned`	No

Schema Changelog

Changes observed during successful MCP inspections.

First observedv0.1.0Sep 13, 2026

TDQS

A4.6/5.0

Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare destructive/non-idempotent, but the description adds substantial independent context: asynchronous background computation, error_code 8 while pending, error_code 12 on premature re-call, replacement of the prior report of the same type, and reassurance that posting data itself is untouched.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the core action and result handle, then the async/error details. Dense and mostly waste-free, though the final sentence ('Buchungsdaten ändern sich nicht... jederzeit neu erzeugen') is somewhat redundant given the earlier statement of replacement semantics.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an async creation tool with a rich output schema, the description covers the lifecycle (create → poll → fetch), failure modes, non-filterability and side effects on prior reports. Nothing an agent needs to call it correctly is missing.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so the schema already documents all six parameters with formats, examples and downstream get_files keys. The description only gestures at the optional outputs (PDF, CSV, ZIP) generically, adding little beyond the schema; baseline 3 applies.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb (erzeugt/anstößt) and resource (Summen- und Saldenliste über alle Konten des Mandanten), plus the returned handle id_by_customer. It is clearly differentiable from sibling readers like bb_reports_get_sums and bb_reports_get_bwa.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly describes the two-step workflow: create here, then retrieve via bb_reports_get_sums with report_id_by_customer. Also states what is not possible (no filtering to individual accounts) and that a second call before completion fails with error_code 12.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server