Serveur MCP

dunning-letters

io.github.theluckystrike/dunning-letters

Ce que fait ce MCP

Registers unpaid invoices, tracks aging and payments, schedules escalation letters, and renders or records collection notices.

aging_summary
Aging summary of what is owed
The aging summary across every unpaid invoice: current, 1-30, 31-60, 61-90 and 91+ day buckets, with counts and totals in integer cents, per currency. This is the answer to "how much am I owed, and how stale is it".
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'on': {'type': 'string', 'maxLength': 10, 'description': 'The date to age against, YYYY-MM-DD. Default today'}}, 'additionalProperties': False}
chase_today
What to chase today
The day's chase list: which invoices cross an escalation threshold today, which letter to send each and how long it has been waiting, what falls due in the next few days, and which invoices have had all three letters and need a decision outside this server.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'on': {'type': 'string', 'maxLength': 10, 'description': 'The date to run the list for, YYYY-MM-DD, e.g. to see what Monday will need. Default today'}, 'within_days': {'type': 'integer', 'maximum': 90, 'minimum': 0, 'description': 'How far ahead to list letters coming due, default 7 days'}}, 'additionalProperties': False}
invoice_delete
Delete an invoice from the register
Delete an invoice entered wrongly, by id or reference: the record, its payments and its letter history. The id is not reissued, so a gap in the DUN series is the record that a deletion happened.
Destructif
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice'], 'properties': {'invoice': {'type': 'string', 'maxLength': 200, 'description': 'The chased invoice: its id (DUN-2026-0001) or its invoice reference'}}, 'additionalProperties': False}
invoice_register
Register an unpaid invoice to chase
Start chasing an unpaid invoice: register the client, the invoice reference, the amount in integer cents, the currency and the due date, and get the three-letter escalation schedule (reminder 1, reminder 2, final notice) with the date each falls due. Free tier: 3 unpaid invoices chased at once.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['client', 'reference', 'amount_minor', 'currency', 'due'], 'properties': {'due': {'type': 'string', 'maxLength': 10, 'description': 'The date payment fell due, YYYY-MM-DD. The ladder is anchored to this date'}, 'gaps': {'type': 'array', 'items': {'type': 'integer', 'maximum': 365, 'minimum': 1}, 'maxItems': 3, 'minItems': 3, 'description': 'Days after the due date at which reminder 1, reminder 2 and the final notice fall due, strictly increasing. Default [7, 14, 21]'}, 'note': {'type': 'string', 'maxLength': 2000}, 'client': {'type': 'string', 'maxLength': 200, 'description': 'Who owes the money, e.g. Acme Ltd'}, 'issued': {'type': 'string', 'maxLength': 10, 'description': "The date the invoice was issued, YYYY-MM-DD, for the letter's reference line"}, 'currency': {'type': 'string', 'pattern': '^[A-Za-z]{3}$', 'description': 'ISO code the invoice was issued in'}, 'reference': {'type': 'string', 'maxLength': 200, 'description': 'The invoice number being chased, e.g. INV-1042'}, 'amount_minor': {'type': 'integer', 'maximum': 100000000000000, 'minimum': 1, 'description': 'The invoice amount in whole minor units (integer cents). 125000 is USD 1,250.00'}, 'duplicate_ok': {'type': 'boolean', 'description': 'Register even though an identical invoice is already on the register. Default false'}, 'late_fee_percent_per_month': {'type': 'number', 'maximum': 100, 'description': 'Late payment interest your terms allow, percent per month, simple and pro-rata. When set, reminder 2 and the final notice state the accrued figure', 'exclusiveMinimum': 0}}, 'additionalProperties': False}
invoice_status
The full state of one chased invoice
One chased invoice in full: what was billed, what has been paid and what is still owed, every letter sent with its date, the escalation schedule with each stage's state, and what happens next and when.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice'], 'properties': {'on': {'type': 'string', 'maxLength': 10, 'description': 'The date to judge lateness against, YYYY-MM-DD. Default today'}, 'invoice': {'type': 'string', 'maxLength': 200, 'description': 'The chased invoice: its id (DUN-2026-0001) or its invoice reference'}}, 'additionalProperties': False}
letter_render
Generate the chase letter for the current stage
Chase an unpaid invoice: generate the letter for the current stage of the ladder -- reminder 1 (polite), reminder 2 (firm, with the late fees note) or the final notice (before-action wording) -- as Markdown or as self-contained printable HTML. Nothing is emailed or sent anywhere: this server produces the letter text, and sending it is your act. Record the sending with letter_sent so the ladder advances.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice'], 'properties': {'on': {'type': 'string', 'maxLength': 10, 'description': "The letter's date, YYYY-MM-DD; late fees accrue to it and the final-notice deadline is 7 days after it. Default today"}, 'stage': {'enum': [1, 2, 3], 'type': 'number', 'description': 'Render a specific stage instead of the one currently due, to preview or to re-issue a letter already sent'}, 'format': {'enum': ['markdown', 'html'], 'type': 'string', 'description': 'markdown (default) or html: a self-contained printable page with no external anything'}, 'invoice': {'type': 'string', 'maxLength': 200, 'description': 'The chased invoice: its id (DUN-2026-0001) or its invoice reference'}}, 'additionalProperties': False}
letter_sent
Record that a letter was sent
Record that a chase letter was actually sent, with its date, so the ladder advances to the next stage. Letters go out in order: reminder 2 cannot be recorded before reminder 1. Returns what is due next and when.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice'], 'properties': {'sent': {'type': 'string', 'maxLength': 10, 'description': 'The date it was sent, YYYY-MM-DD. Default today'}, 'stage': {'enum': [1, 2, 3], 'type': 'number', 'description': 'Which letter went out. Default the lowest unsent stage'}, 'invoice': {'type': 'string', 'maxLength': 200, 'description': 'The chased invoice: its id (DUN-2026-0001) or its invoice reference'}}, 'additionalProperties': False}
license_activate
Activate license
Turn Pro on for this connection with key, an MCPL1.<payload>.<signature> issued at checkout for this server or the bundle. Data under your token stays; a wrong or expired key changes nothing. license_status confirms it.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['key'], 'properties': {'key': {'type': 'string', 'description': 'License key from checkout, MCPL1.<payload>.<signature>'}}, 'additionalProperties': False}
license_status
License status
Report this endpoint's licence state for your token as JSON: the product, the tier free or pro, why it is not Pro, and the checkout URL. Call it to explain a free-tier refusal. No arguments, nothing changes.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {}}
overdue_list
List overdue invoices
Every unpaid invoice past its due date: how many days late, what is still owed, which letters have gone out, and what is due next and when. Sorted by days late, worst first.
Lecture seule Idempotent
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'properties': {'on': {'type': 'string', 'maxLength': 10, 'description': 'The date to judge lateness against, YYYY-MM-DD. Default today'}, 'limit': {'type': 'integer', 'maximum': 2000, 'minimum': 1, 'description': 'Maximum rows, default and ceiling 2000'}}, 'additionalProperties': False}
payment_record
Record a payment received
Record money received against a chased invoice, in whole MINOR units: a part payment lowers what is still chased, a payment that covers the balance closes the ladder and frees the free-tier slot. Returns the outstanding amount.
Schéma d’entrée
{'type': 'object', '$schema': 'http://json-schema.org/draft-07/schema#', 'required': ['invoice', 'amount_minor'], 'properties': {'date': {'type': 'string', 'maxLength': 10, 'description': 'The date the money arrived, YYYY-MM-DD. Default today'}, 'note': {'type': 'string', 'maxLength': 2000, 'description': 'How it was paid, e.g. Bank transfer, or what it was against'}, 'invoice': {'type': 'string', 'maxLength': 200, 'description': 'The chased invoice: its id (DUN-2026-0001) or its invoice reference'}, 'amount_minor': {'type': 'integer', 'maximum': 100000000000000, 'minimum': 1, 'description': 'What was received, in whole minor units'}}, 'additionalProperties': False}
Modifié
license_activate
21 September 2026 02:56
Modifié
license_status
21 September 2026 02:56
Modifié
invoice_delete
21 September 2026 02:56
Modifié
invoice_status
21 September 2026 02:56
Modifié
chase_today
21 September 2026 02:56
Modifié
aging_summary
21 September 2026 02:56
Modifié
overdue_list
21 September 2026 02:56
Modifié
letter_sent
21 September 2026 02:56
Modifié
letter_render
21 September 2026 02:56
Modifié
payment_record
21 September 2026 02:56
Modifié
invoice_register
21 September 2026 02:56
Ajouté
license_activate
17 September 2026 12:52
Ajouté
license_status
17 September 2026 12:52
Ajouté
invoice_delete
17 September 2026 12:52
Ajouté
invoice_status
17 September 2026 12:52
Ajouté
chase_today
17 September 2026 12:52
Ajouté
aging_summary
17 September 2026 12:52
Ajouté
overdue_list
17 September 2026 12:52
Ajouté
letter_sent
17 September 2026 12:52
Ajouté
letter_render
17 September 2026 12:52
Ajouté
payment_record
17 September 2026 12:52
Ajouté
invoice_register
17 September 2026 12:52