io.github.ptrinh/final-notice

Official3 tools

by ptrinh · JavaScript

Free demand-letter PDF generator for unpaid invoices, 80+ jurisdictions, 29 languages.

Generates demand letter PDFs for unpaid invoices across 80+ jurisdictions.

Captured live from the server via tools/list.

list_jurisdictions

List every supported country/jurisdiction (code, name, currency, default language) plus the available languages and tones. Call this first to pick a valid jurisdiction + language.

No parameters.

preview_demand_letter

Render the demand letter's text content (title, subject, body paragraphs, amount line, legal reference, closing) as structured JSON, without producing a PDF. Use to review or refine wording before generating.

Parameters (20)

jurisdictionstring
ISO 3166-1 alpha-2 country code of the debtor (e.g. US, GB, DE, BR, AE). Use list_jurisdictions for the full set; XX = generic/international.
languagestring
Letter language code (e.g. en, es, fr, de, pt, ar, zh, ja). Must be offered for the jurisdiction; defaults to en.
tonestring
Escalation level. Default: final.
senderNamestringrequired
Creditor name (person or business). Required.
senderTypestring
Creditor type. Business/firm requires attested=true.
senderAddressstringrequired
Creditor postal address, multi-line (\n separated). Required.
senderContactstring
Creditor email/phone (optional).
senderRefstring
Creditor's own reference number (optional).
senderTitlestring
Signer's job title (optional).
signerNamestring
Name of the person signing (optional; defaults to senderName).
debtorNamestringrequired
Debtor name. Required.
debtorAddressstringrequired
Debtor postal address, multi-line. Required.
amountnumberrequired
Amount owed, as a number (no separators). Required, > 0.
currencystring
ISO 4217 currency (optional; defaults to the jurisdiction's).
invoiceNumberstring
Invoice/account number (optional).
originalDatestring
ISO date the debt was incurred/invoiced (optional).
descriptionstring
What the debt is for (optional).
deadlineDaysnumber
Days from issue to pay (optional; default 14).
bankobject
Payment/bank details keyed by field (e.g. {bankName, iban, accountNumber}). Optional.
attestedboolean
Confirms authorization to send under the sender name. Required when senderType is business/firm.

generate_demand_letter

Generate the finished demand-letter PDF (formal letter + matching envelope), localized and legally formatted for the jurisdiction. Returns the PDF as a base64 resource. Free, no registration.

Parameters (20)

jurisdictionstring
ISO 3166-1 alpha-2 country code of the debtor (e.g. US, GB, DE, BR, AE). Use list_jurisdictions for the full set; XX = generic/international.
languagestring
Letter language code (e.g. en, es, fr, de, pt, ar, zh, ja). Must be offered for the jurisdiction; defaults to en.
tonestring
Escalation level. Default: final.
senderNamestringrequired
Creditor name (person or business). Required.
senderTypestring
Creditor type. Business/firm requires attested=true.
senderAddressstringrequired
Creditor postal address, multi-line (\n separated). Required.
senderContactstring
Creditor email/phone (optional).
senderRefstring
Creditor's own reference number (optional).
senderTitlestring
Signer's job title (optional).
signerNamestring
Name of the person signing (optional; defaults to senderName).
debtorNamestringrequired
Debtor name. Required.
debtorAddressstringrequired
Debtor postal address, multi-line. Required.
amountnumberrequired
Amount owed, as a number (no separators). Required, > 0.
currencystring
ISO 4217 currency (optional; defaults to the jurisdiction's).
invoiceNumberstring
Invoice/account number (optional).
originalDatestring
ISO date the debt was incurred/invoiced (optional).
descriptionstring
What the debt is for (optional).
deadlineDaysnumber
Days from issue to pay (optional; default 14).
bankobject
Payment/bank details keyed by field (e.g. {bankName, iban, accountNumber}). Optional.
attestedboolean
Confirms authorization to send under the sender name. Required when senderType is business/firm.

README.md2 KBView on GitHub

Final Notice — MCP server

Free, no-registration Model Context Protocol server that generates professional debt-collection demand letters: a print-ready PDF (formal letter + matching envelope), localized and legally formatted for 80+ jurisdictions and 29 languages (including Arabic/RTL, CJK, Indic, Thai, Cyrillic, and Greek).

Website: https://finalnotice.io
MCP endpoint: https://finalnotice.io/mcp
Transport: Streamable HTTP (JSON-RPC 2.0) — no auth, no API key, free.

This repository is the registry manifest for a remote, hosted MCP server; there is nothing to install or run locally.

Connect

Most MCP clients accept a remote HTTP server. For example, with Claude Code:

bash

claude mcp add --transport http final-notice https://finalnotice.io/mcp

Or add to a client config that supports remote servers:

json

{
  "mcpServers": {
    "final-notice": {
      "type": "http",
      "url": "https://finalnotice.io/mcp"
    }
  }
}

Tools

Tool	Description
`list_jurisdictions`	Supported countries, currencies, languages, and tones. Call first to pick a valid jurisdiction + language.
`preview_demand_letter`	Render the letter's text (title, subject, body, amount, legal reference, closing) as structured JSON — no PDF — to review wording.
`generate_demand_letter`	Generate the finished PDF (letter + envelope) and return it as a base64 resource.

Minimal example (`generate_demand_letter` arguments)

json

{
  "jurisdiction": "GB",
  "language": "en",
  "tone": "final",
  "senderName": "Acme Ltd",
  "senderType": "business",
  "attested": true,
  "senderAddress": "1 High St\nLondon",
  "debtorName": "J. Smith",
  "debtorAddress": "2 Park Rd\nLeeds",
  "amount": 2450,
  "currency": "GBP",
  "invoiceNumber": "INV-1042",
  "deadlineDays": 14
}

Required fields: senderName, senderAddress, debtorName, debtorAddress, amount (> 0). Business/firm senders must set attested: true.

Notes

A REST API mirrors the MCP tools: GET /api/meta, POST /api/preview, POST /api/generate.
This is not legal advice; letters are factual, non-threatening templates.
The service is free; an optional donation link is at https://finalnotice.io/donate.

License: MIT (this manifest repository).

Install

claude_desktop_config.json

{
  "mcpServers": {
    "final-notice": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://finalnotice.io/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.