ptrinh/finalnotice-mcp

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 **100+ jurisdictions** and **33 languages**
(including Arabic/RTL, CJK, Indic, Thai, Cyrillic, and Greek).
- **Website:** https://finalnotice.io
- **Hosted MCP endpoint:** https://finalnotice.io/mcp (Streamable HTTP, JSON-RPC 2.0)
- **No auth, no API key, free.**
The rendering engine (fonts, layout, jurisdiction rules) runs on the hosted service.
This package is a thin **stdio** MCP server that forwards the three tools to the free
public API, so you can run it locally or point any MCP client at the hosted endpoint.
Use it
A) Hosted endpoint (nothing to install)
B) Run the stdio server locally (npx)
C) Docker
The stdio server calls https://finalnotice.io by default; override with the
FINALNOTICE_API_BASE environment variable.
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)
Required fields: senderName, senderAddress, debtorName, debtorAddress, amount (> 0).
Business/firm senders must set attested: true. Set debtorType: "individual" to apply
consumer-protection rules where they exist (e.g. the UK Pre-Action Protocol for Debt
Claims 30-day period, or the Dutch WIK fourteen-day wording).
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.