ptrinh/finalnotice-mcp
📇 ☁️ - Generate localized debt-collection demand-letter PDFs (formal letter + matching envelope) across 100+ jurisdictions and 33 languages. No auth, no key — tools: listjurisdictions, previewdemandletter, generatedemandletter. Hosted Streamable HTTP at finalnotice.io/mcp.
Quick Install
{
"mcpServers": {
"ptrinh-finalnotice-mcp": {
"command": "npx",
"args": [
"-y",
"ptrinh-finalnotice-mcp"
]
}
}
}Using an AI coding agent (Claude Code, Cursor, etc.)? Copy a ready-made prompt that tells it to fetch the setup instructions and install this server for you.
Documentation Overview
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 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)
claude mcp add --transport http final-notice https://finalnotice.io/mcp
{
"mcpServers": {
"final-notice": { "type": "http", "url": "https://finalnotice.io/mcp" }
}
}
B) Run the stdio server locally (npx)
{
"mcpServers": {
"final-notice": { "command": "npx", "args": ["-y", "finalnotice-mcp"] }
}
}
C) Docker
docker build -t finalnotice-mcp .
docker run -i --rm finalnotice-mcp
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)
{
"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",
"debtorType": "individual",
"amount": 2450,
"currency": "GBP",
"invoiceNumber": "INV-1042",
"deadlineDays": 14
}
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.
- The service is free; an optional donation link is at https://finalnotice.io/donate.
License
MIT — see LICENSE.