Skip to main content
Glama
dennismenken

BuchhaltungsButler MCP-Server

by dennismenken

Zahlungen eines Belegs

bb_receipts_list_transactions
Read-onlyIdempotent

List payments assigned to a receipt in BuchhaltungsButler to check whether an incoming invoice has already been paid. Use confirmed_only to filter confirmed matches.

Instructions

Listet die Zahlungen, die in BuchhaltungsButler einem bestimmten Beleg zugeordnet sind, etwa um zu prüfen, ob eine Eingangsrechnung schon bezahlt wurde. Die umgekehrte Richtung liefert bb_transactions_list_receipts, den Beleg selbst bb_receipts_get. Liefert keine Belegfelder und keinen Zuordnungsstand: Ob eine Zuordnung bestätigt ist, zeigt erst der Vergleich zweier Aufrufe mit confirmed_only true und false.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
confirmed_onlyNoWenn true, liefert die API nur bestätigte Zuordnungen zwischen Beleg und Zahlung, also solche, hinter denen eine bestätigte Buchung steht. Ohne Angabe kommen alle Zuordnungen.
response_formatNo'concise' liefert nur die Felder, die einen Datensatz erkennbar machen und den nächsten Schritt erlauben. 'detailed' liefert den Datensatz so, wie die BuchhaltungsButler-API ihn ausgibt. Mit 'concise' beginnen und nur für die wenigen Datensätze auf 'detailed' wechseln, die wirklich geprüft werden müssen. Dieses Feld ist serverseitig und geht nicht an die API.concise
receipt_id_by_customerYesDie mandantenbezogene Nummer des Belegs, zu finden über bb_receipts_search. Keine globale Kennung. In Suchergebnissen erscheint sie als String; hier ohne Anführungszeichen übergeben. Die Antwort trägt dagegen die Nummern der Zahlungen.

Output Schema

TableJSON Schema
NameRequiredDescriptionDefault
itemsYes
messageNo
successYes
endpointNo
limit_usedNo
offset_usedNo
more_possibleNo
rows_returnedNo
_contract_warningsNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv0.1.0

TDQS

A4.4/5.0
Behavior4/5

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

Die Annotations deklarieren bereits readOnlyHint=true, idempotentHint=true und destructiveHint=false, sodass die Sicherheitsprofile bekannt sind. Die Beschreibung ergänzt wertvollen Kontext: sie liefert keine Belegfelder und keinen Zuordnungsstand, und erklärt, wie man den Bestätigungsstatus durch Vergleich zweier Aufrufe mit confirmed_only true/false ermittelt. Das ist über die Annotations hinaus nützlich; lediglich Pagination- oder Rate-Limit-Informationen fehlen.

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

Conciseness5/5

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

Drei Sätze, jeder mit klarem Zweck: Zweck, Abgrenzung zu Alternativen und wichtige Verhaltenslücke. Front-loading ist optimal, keine Wiederholungen.

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

Completeness4/5

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

Da ein Output-Schema existiert, muss die Beschreibung keine Rückgabewerte erklären. Sie deckt Zweck, Abgrenzung und einen wichtigen Verhaltensaspekt (fehlender Zuordnungsstand) ab. Die fehlende Erwähnung von Pagination oder Antwortformat ist angesichts des Output-Schemas und der 100% Schemaabdeckung akzeptabel, aber ein kleiner Gap bleibt.

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?

Die Schema-Beschreibungsabdeckung ist 100%, sodass das Schema alle drei Parameter inklusive confirmed_only und receipt_id_by_customer bereits ausführlich dokumentiert. Die Beschreibung fügt keine zusätzlichen Parameterdetails hinzu, die über das Schema hinausgehen. Baseline 3 ist korrekt, wenn das Schema die Hauptlast trägt.

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?

Die Beschreibung nennt ein klares Verb und Ressource ('Listet die Zahlungen ... einem bestimmten Beleg zugeordnet') und grenzt sich explizit von den Geschwistertools bb_transactions_list_receipts (umgekehrte Richtung) und bb_receipts_get (der Beleg selbst) ab. Ein Agent kann das Tool ohne Schema-Öffnung von Alternativen unterscheiden.

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?

Die Beschreibung liefert einen konkreten Anwendungsfall ('etwa um zu prüfen, ob eine Eingangsrechnung schon bezahlt wurde') und benennt die Alternativen mit ihren Richtungen. Es bleibt nichts zu inferieren.

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