Finalnotice MCP

What ptrinh/finalnotice-mcp MCP server does

The ptrinh/finalnotice-mcp MCP server creates debt-collection demand letters for more than 100 jurisdictions and 33 languages. Generated output contains a formal letter and a corresponding envelope in a print-ready PDF. Supported language coverage includes Arabic with right-to-left layout, as well as CJK, Indic, Thai, Cyrillic, and Greek scripts.

The output is intended for factual, non-threatening collection notices. It is not legal advice. Jurisdiction-specific formatting and rules are handled by the hosted rendering service rather than by the local wrapper.

How it works

The server provides three MCP tools. list_jurisdictions returns available countries, currencies, languages, and tones. Call it first when selecting valid input values. preview_demand_letter produces the proposed title, subject, body, amount, legal reference, and closing as structured JSON without creating a PDF. After reviewing that text, generate_demand_letter renders the completed letter and envelope and returns the PDF as a base64 resource.

The hosted service is available at https://finalnotice.io/mcp using Streamable HTTP and JSON-RPC 2.0. The local package is a thin stdio MCP server that sends tool requests to https://finalnotice.io by default. A REST interface also mirrors the tools through /api/meta, /api/preview, and /api/generate.

Setup and configuration

No account, authentication, or API key is required. You can connect an MCP client directly to the hosted endpoint, or run the package locally with npx -y finalnotice-mcp. Docker is also supported by building the repository image and running it with standard input attached.

The upstream API base can be changed with the FINALNOTICE_API_BASE environment variable. For a local stdio configuration, the command is npx and the arguments are -y finalnotice-mcp. The README also provides a Claude MCP configuration using the hosted URL.

Tools and capabilities

• Enumerate supported jurisdictions, currencies, languages, and tones.
• Preview localized letter wording before PDF creation.
• Generate a PDF containing the demand letter and matching envelope.
• Apply jurisdiction-specific formatting and language/script layout.
• Include sender, debtor, amount, currency, invoice, and deadline details.

Required generation inputs include senderName, senderAddress, debtorName, debtorAddress, and a positive amount. Business or firm senders must mark the submission as attested. Setting debtorType to individual enables consumer-protection handling where supported, such as the UK or Dutch examples described in the README.

Limitations and notes

The ptrinh/finalnotice-mcp MCP server depends on the hosted Final Notice service for rendering, jurisdiction rules, fonts, and layout. The local package therefore forwards requests rather than performing PDF generation entirely offline. Generated documents should be reviewed before use, particularly where local procedural requirements apply.

The project is released under the MIT license. The service is free, with an optional donation link. Its material does not claim to replace legal advice, and the generated letters are described as factual, non-threatening templates.