# ptrinh/finalnotice-mcp [Health: Active]

**Category:** ⚖️ Legal  
**Repository:** https://github.com/ptrinh/finalnotice-mcp  
**GitHub Stars:** 0  
**Views:** 3  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/ptrinh-finalnotice-mcp

## Description
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.

## Tools
Capabilities this server exposes over MCP:

- **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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "finalnotice-mcp": {
    "command": "npx",
    "args": ["-y","finalnotice-mcp"],
    "env": {
      "FINALNOTICE_API_BASE": ""
    }
  }
}
```

**Requires environment variables:** `FINALNOTICE_API_BASE` — the values above are empty placeholders; fill in real credentials before running (see the repository for what each one is for).

## Documentation

## 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.

_Full upstream README: https://allmcps.com/mcp/ptrinh-finalnotice-mcp/readme_