brandbill
Server Details
Branded invoices and EU e-invoices (ZUGFeRD / XRechnung) for freelancers and small studios. Create, finalize and send invoices, record payments, turn quotes into invoices, handle credit notes and dunning - about 19 tools. Auth: Authorization: Bearer bb_... (API key under Settings > API keys, free plan included). Data hosted in Germany.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- –
TDQS
Scored across 38 tools
Most tools target a clear resource+action pair and descriptions explicitly cross-reference siblings (e.g. create_document vs create_credit_note vs create_delivery_note). The remaining overlaps are manageable but real: finalize_document and issue_contract perform the same action for different resources, mark_sent vs finalize_document's 'sent' status distinction is subtle, and the three delete tools (delete_draft, delete_contract_draft, delete_delivery_note) plus four download_*_pdf/xml tools require careful reading to pick correctly.
Every name is a snake_case verb_noun phrase, so the surface is predictable and scannable. The deviation is semantic rather than syntactic: the same operation is called 'finalize' for documents but 'issue' for contracts, and generic resources ('document', 'draft') coexist with specific ones ('credit_note', 'delivery_note', 'contract'), which slightly breaks the pattern.
38 tools is heavy, but the domain genuinely spans five resource families (customers, documents, delivery notes, contracts, tenants) each needing list/get/create/update/pdf/email. Still, several clusters could be consolidated — three delete variants, four download-PDF/XML variants, and the finalize/issue pair — so the count sits above what the scope strictly requires.
The lifecycle is well covered: draft-create, update, finalize, send, mark sent, PDF/XML export, payment recording, dunning, credit notes/cancellation, and a full contract flow (revise, sign, end). Minor gaps: no delete for customers, no way to list payment or dunning history directly (only visible via get_document), and no explicit tool to view sent-email/communication logs.
Available Tools
38 toolscancel_invoiceRechnung stornierenADestructiveInspect
Ausgestellte Rechnung vollständig stornieren: stellt sofort eine Stornorechnung mit eigener Nummer aus. Nicht rückgängig zu machen. Eingegangene Zahlungen stehen danach dem Kunden zu.
Inputs: id (required), reason.
convert_quote_to_invoiceRechnung aus AngebotAInspect
Aus einem ausgestellten Angebot einen Rechnungsentwurf machen (markiert es als angenommen). Optional quantities {Angebotspositions-ID: Menge} für abweichende Mengen. Danach finalize_document.
Inputs: id (required), quantities.
create_contractMietvertrag anlegenBInspect
Mietvertrag als Entwurf anlegen (ohne Nummer). Mieter: customer_id oder customer_name mit Anschrift. Klauseln kommen aus den Textbausteinen des Kontos, wenn clauses fehlt.
Inputs: note, items, place, clauses, +29 more.
create_credit_noteRechnungskorrektur anlegenAInspect
Rechnungskorrektur (Teilgutschrift) als Entwurf zu einer ausgestellten Rechnung. quantities = {Positions-ID aus get_document: zurückgenommene Menge}. Preise lassen sich danach mit update_document ändern, ausstellen mit finalize_document.
Inputs: id (required), reason (required), quantities (required).
create_customerKunde anlegenAInspect
Neuen Kunden in der Kartei anlegen. Vorher mit list_customers prüfen, ob es ihn schon gibt.
Inputs: name (required), city, email, phone, +11 more.
create_delivery_noteLieferschein anlegenAInspect
Lieferschein anlegen; bekommt sofort seine Nummer. Am einfachsten mit billing_document_id (Positionen und Anschrift aus Rechnung/Auftrag), sonst customer_id oder customer_name mit Anschrift und lines.
Inputs: lines, reference, intro_text, issue_date, +12 more.
create_documentEntwurf anlegenInspect
Angebot oder Rechnung als Entwurf anlegen (noch ohne Nummer). Beträge in Euro netto. Empfänger: customer_id (aus list_customers) oder customer_name mit Anschrift.
Inputs: type (required), lines (required), subject, intro_text, +24 more.
decide_quoteAngebot angenommen/abgelehntCIdempotentInspect
Kundenentscheidung zu einem ausgestellten Angebot festhalten.
Inputs: id (required), accepted (required).
delete_contract_draftVertragsentwurf löschenADestructiveIdempotentInspect
Einen Vertragsentwurf löschen. Ausgestellte Verträge bleiben (Aufbewahrung) — beenden mit end_contract.
Inputs: id (required).
delete_delivery_noteLieferschein löschenBDestructiveIdempotentInspect
Einen Lieferschein löschen. Seine Nummer wird nicht neu vergeben.
Inputs: id (required).
delete_draftEntwurf löschenADestructiveIdempotentInspect
Einen Entwurf löschen. Ausgestellte Belege lassen sich nicht löschen — dafür cancel_invoice oder create_credit_note.
Inputs: id (required).
download_contract_pdfVertrags-PDF herunterladenARead-onlyInspect
PDF eines Mietvertrags (ausgestellt: das eingefrorene PDF; Entwurf: Vorschau mit ENTWURF). Liefert die Datei base64-kodiert.
Inputs: id (required).
download_delivery_note_pdfLieferschein-PDF herunterladenARead-onlyInspect
PDF eines Lieferscheins in der Vorlage des Kontos (ohne Preise). Liefert die Datei base64-kodiert.
Inputs: id (required).
download_document_pdfPDF herunterladenRead-onlyInspect
PDF eines Belegs herunterladen (bei E-Rechnung mit eingebettetem XML; Schweiz: QR-Zahlteil als letzte Seite, siehe payment_slip). Liefert die Datei base64-kodiert.
Inputs: id (required), payment_slip.
download_e_invoice_xmlE-Rechnung (XML) lesenBRead-onlyInspect
Das E-Rechnungs-XML einer ausgestellten Rechnung (ZUGFeRD/Factur-X oder XRechnung) als Text.
Inputs: id (required), profile.
end_contractMietvertrag beendenBDestructiveInspect
Laufenden Vertrag beenden: Enddatum (nicht vor Mietbeginn) und Grund.
Inputs: id (required), reason (required), ended_on (required).
finalize_documentBeleg ausstellenBDestructiveInspect
Entwurf ausstellen: vergibt die fortlaufende Nummer, danach unveränderlich. Nicht rückgängig zu machen. Ein Angebot steht danach auf status sent (offen zur Entscheidung), status_label «Ausgestellt», bis es mit send_document oder mark_sent wirklich raus ist.
Inputs: id (required), issue_date.
get_contractMietvertrag lesenARead-onlyInspect
Einen Mietvertrag lesen: Felder, Status, was zum Ausstellen fehlt (gaps), Klauseln wie gedruckt, Fassungen, Mietrechnungen, Verlauf.
Inputs: id (required).
get_customerKunde lesenARead-onlyInspect
Einen Kunden mit Anschrift, Ansprechpartner und USt-IdNr. lesen.
Inputs: id (required).
get_delivery_noteLieferschein lesenARead-onlyInspect
Einen Lieferschein lesen: Lieferanschrift, Vorgang, Daten, Positionen (ohne Preise).
Inputs: id (required).
get_documentBeleg lesenBRead-onlyInspect
Einen Beleg mit Positionen, Status, offenem Betrag und E-Rechnungs-Status lesen.
Inputs: id (required).
issue_contractMietvertrag ausstellenADestructiveInspect
Entwurf ausstellen: Vertragsnummer vergeben, PDF drucken und einfrieren. Danach unveränderlich. Nicht rückgängig zu machen.
Inputs: id (required).
issue_dunningMahnung ausstellenADestructiveInspect
Für eine überfällige Rechnung die nächste Mahnstufe ausstellen (Zahlungserinnerung, dann Mahnungen). Nummer MA-…, PDF im Archiv.
Inputs: id (required), level.
list_contractsMietverträge auflistenARead-onlyInspect
Mietverträge auflisten (neueste zuerst). Filter: customer_id, status (draft, issued, signed, ended), external_reference. Mit updated_since nur Geänderte, mit fields nur IDs.
Inputs: fields, status, customer_id, updated_since, +1 more.
list_customersKunden suchenARead-onlyInspect
Kundenkartei durchsuchen (Name, Kundennummer, E-Mail, Ansprechpartner), 50 je Seite. Die id geht als customer_id in create_document. Mit updated_since nur Geänderte, mit fields nur IDs.
Inputs: q, page, fields, updated_since.
list_delivery_notesLieferscheine auflistenBRead-onlyInspect
Lieferscheine auflisten (neueste zuerst). Filter: customer_id, billing_document_id, q (Nummer, Kunde, Vorgang).
Inputs: q, customer_id, billing_document_id.
list_documentsBelege auflistenARead-onlyInspect
Belege auflisten (neueste zuerst, 50 je Seite). Filter nach Art und Suchbegriff (Kunde oder Nummer); mit updated_since nur seitdem Geänderte, mit fields nur id/updated_at.
Inputs: q, page, type, fields, +1 more.
list_tenantsMandanten anzeigenARead-onlyInspect
Welche Mandanten (Konten) dieser Schlüssel erreicht und in welchem er gerade arbeitet (current). Ein persönlicher Schlüssel wählt den Mandanten mit dem HTTP-Header X-Brandbill-Tenant: in der MCP-Client-Konfiguration; ohne Header gilt der aktive Mandant der Person. Ein Mandanten-Schlüssel arbeitet immer in seinem Mandanten.
Inputs: no named parameters.
mark_sentAls versendet markierenAInspect
Einen ausgestellten Beleg als versendet markieren, wenn er auf anderem Weg (eigene Mail, Post) zum Kunden ging.
Inputs: id (required).
record_paymentZahlung erfassenAInspect
Zahlungseingang zu einer Rechnung erfassen (Betrag in Euro, negativ = Rückbuchung). Ohne paid_on gilt heute.
Inputs: id (required), amount (required), note, paid_on.
revise_contractNachtrag oder neue FassungAInspect
Zu einem laufenden Vertrag einen neuen Entwurf anlegen: amendment = Nachtrag (Vertrag bleibt in Kraft, Nummer -N1), version = neue Fassung (ersetzt den Vertrag ab ihrem Mietbeginn).
Inputs: id (required), kind (required).
send_contractMietvertrag per E-Mail sendenADestructiveInspect
Ausgestellten Vertrag als PDF per E-Mail senden (wie send_document). with_signed hängt die unterschriebene Fassung an, falls hinterlegt.
Inputs: id (required), to (required), body (required), subject (required), +3 more.
send_documentBeleg per E-Mail sendenDestructiveInspect
Ausgestellten Beleg als PDF per E-Mail senden; bei Schweizer Konten liegt der QR-Zahlteil als zweiter Anhang bei (payment_slip). Ohne eigenes SMTP über brandbill (Reply-To: Rechnungs-E-Mail); sonst Absenderkonto bzw. Standardkonto.
Inputs: id (required), to (required), body (required), subject (required), +3 more.
sign_contractUnterschriebene Fassung hinterlegenADestructiveInspect
Den unterschriebenen Vertrag (PDF, JPG oder PNG, base64) zu einem ausgestellten Vertrag hinterlegen. Status danach signed; wird nie ersetzt.
Inputs: id (required), extension (required), file_base64 (required), signed_on.
update_contractMietvertrag ändernAIdempotentInspect
Einen Vertragsentwurf ändern. Nur übergebene Felder werden geändert; items und clauses ersetzen die Liste. Ausgestellte Verträge ändern nur revise_contract.
Inputs: id (required), note, items, place, +30 more.
update_customerKunde ändernAIdempotentInspect
Einen Kunden in der Kartei ändern. Nur übergebene Felder werden geändert; null leert ein Feld. Belege behalten die Anschrift, mit der sie angelegt wurden.
Inputs: id (required), city, name, email, +12 more.
update_delivery_noteLieferschein ändernAIdempotentInspect
Einen Lieferschein ändern; die Nummer bleibt. Nur übergebene Felder werden geändert; lines ersetzt die Liste.
Inputs: id (required), lines, reference, intro_text, +13 more.
update_documentEntwurf ändernIdempotentInspect
Einen Entwurf ändern. Nur übergebene Felder werden geändert; lines ersetzt alle Positionen.
Inputs: id (required), lines, subject, intro_text, +24 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceRemote MCP server that lets AI assistants read tracked competitive intelligence — competitor news, reviews, website changes, social posts and ads — and act on it by managing projects, competitors, battle cards, reports and canvases. Every answer carries a source and a date, and write actions only publish when explicitly shared.MIT
- AlicenseCqualityCmaintenanceCompetitor Monitor AI - MCP server providing AI-powered tools and automation by MEOK AI Labs112 npm37 PyPIMIT
- AlicenseAqualityDmaintenanceEnables brand visibility monitoring across major AI platforms like ChatGPT, Claude, Gemini, and Perplexity. It allows users to track visibility scores, analyze competitor data, and receive actionable insights to improve AI-generated brand recommendations.1611 npm1MIT

industrylens-mcpofficial
AlicenseNot gradedqualityCmaintenanceBrowse IndustryLens's published competitive-intelligence reports and head-to-head competitor comparisons from any AI agent — real, source-backed data.MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.