io.github.ptrinh/final-notice
Free demand-letter PDF generator for unpaid invoices, 80+ jurisdictions, 29 languages.
Open source Repository Open in the app JSON README (API)
About
Free demand-letter PDF generator for unpaid invoices, 80+ jurisdictions, 29 languages.
Details
- Kind
- MCP servers
- Topic
- Finance & crypto
- Publisher
- ptrinh
- Origin
- official
- Category
- ferramentas
- Transport
- http
- Version
- 1.0.0
- Last push
- 2026-07-06T08:29:00Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 04:01:15
- Updated
- 2026-08-29 04:01:15
- Origin id
io.github.ptrinh/final-notice
README
# Final Notice — MCP server
[](https://glama.ai/mcp/servers/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)
```bash
claude mcp add --transport http final-notice https://finalnotice.io/mcp
```
```json
{
"mcpServers": {
"final-notice": { "type": "http", "url": "https://finalnotice.io/mcp" }
}
}
```
### B) Run the stdio server locally (npx)
```json
{
"mcpServers": {
"final-notice": { "command": "npx", "args": ["-y", "finalnotice-mcp"] }
}
}
```
### C) Docker
```bash
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)
```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",
"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](./LICENSE).