MCP 서버

dunning-letters

io.github.theluckystrike/dunning-letters
비즈니스 및 운영 금융 및 투자 공개 · 연결 가능 MCP 2026-07-28

이 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".
읽기 전용 멱등성
입력 스키마
{'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.
입력 스키마
{'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.
파괴적 작업
입력 스키마
{'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.
입력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
입력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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.
읽기 전용 멱등성
입력 스키마
{'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.
입력 스키마
{'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}
변경됨
license_activate
2026년 9월 21일 2:56 AM
변경됨
license_status
2026년 9월 21일 2:56 AM
변경됨
invoice_delete
2026년 9월 21일 2:56 AM
변경됨
invoice_status
2026년 9월 21일 2:56 AM
변경됨
chase_today
2026년 9월 21일 2:56 AM
변경됨
aging_summary
2026년 9월 21일 2:56 AM
변경됨
overdue_list
2026년 9월 21일 2:56 AM
변경됨
letter_sent
2026년 9월 21일 2:56 AM
변경됨
letter_render
2026년 9월 21일 2:56 AM
변경됨
payment_record
2026년 9월 21일 2:56 AM
변경됨
invoice_register
2026년 9월 21일 2:56 AM
추가됨
license_activate
2026년 9월 17일 12:52 PM
추가됨
license_status
2026년 9월 17일 12:52 PM
추가됨
invoice_delete
2026년 9월 17일 12:52 PM
추가됨
invoice_status
2026년 9월 17일 12:52 PM
추가됨
chase_today
2026년 9월 17일 12:52 PM
추가됨
aging_summary
2026년 9월 17일 12:52 PM
추가됨
overdue_list
2026년 9월 17일 12:52 PM
추가됨
letter_sent
2026년 9월 17일 12:52 PM
추가됨
letter_render
2026년 9월 17일 12:52 PM
추가됨
payment_record
2026년 9월 17일 12:52 PM
추가됨
invoice_register
2026년 9월 17일 12:52 PM