MintPDF

by trendtweekers

Not rated
GitHub

About

Turn Markdown or HTML into a styled PDF, or render any public web page, and get a download link back.

Details

Author
trendtweekers
Categories
Productivity

Setup

Install MintPDF in your MCP client (Claude Desktop, Cursor, Windsurf, and others).

Repository: https://github.com/trendtweekers/mintpdf

Follow the installation instructions in the repository README, then restart your MCP client.

HTML & Markdown → PDF, as a REST API and an MCP server.

No template editor. No template IDs. No dashboard. No signup to try.

Try it·MCP setup·API·Self-host·Security·Limitations

Send HTML or Markdown, get a PDF back. It is Chromium under the hood, with the print CSS already worked out so tables don't split across pages, table headers repeat, and Markdown comes out looking like a document rather than a text file.

- Pagination is the point.break-inside, repeatingthead, orphans and widows, and headers and footers that actually inherit your styling. SeeHow it works.
- MCP nativegenerate_pdfandpdf_from_urlover streamable HTTP, so an agent can produce a document mid-conversation.
- Documents aren't kept— rendered files are deleted after an hour, and their contents are never logged. Keys, emails and usage counters obviously are stored. See
Security.
- Run it yourself— MIT, with a published image. The hosted service exists so you don't have to operate Chromium, not because the renderer is secret.

curl -X POST https://mintpdf.dev/v1/pdf \ -H "Content-Type: application/json" \ -d '{"markdown":"# Invoice #42\n\n| Item | Price |\n|---|---|\n| Widget | $9.00 |","pageNumbers":true}' \ --output invoice.pdf

Want more than 10 renders a day? A free key (email only, no card) raises it to 100 a month:

curl -X POST https://mintpdf.dev/v1/keys \ -H "Content-Type: application/json" \ -d '{"email":"you@example.com"}' # → {"key":"pm_…","daily_limit":100} # 100 renders per month

Then sendAuthorization: Bearer pm_…with your requests.

{ "mcpServers": { "mintpdf": { "command": "npx", "args": ["-y", "mintpdf-mcp"] } } }

Prefer the hosted endpoint directly? Usemcp-remoteinstead:

{ "mcpServers": { "mintpdf": { "command": "npx", "args": ["-y", "mcp-remote", "https://mintpdf.dev/mcp"] } } }

"Summarise this thread as a one-page brief with page numbers and give me a PDF."

Body takesexactly onesource, plus options:

{"email":"you@example.com"}→ a free key. No card, no verification loop.

MCP streamable-HTTP endpoint, stateless. Same capabilities as the REST API.

A ready-made collection covering every endpoint and option lives inpostman/. Import it by link:

https://raw.githubusercontent.com/TrendTweekers/mintpdf/main/postman/mintpdf.postman_collection.json

The first request runs with no key at all, and fetching a free key stores it into the collection variable automatically, so the rest of the collection works straight after.

MintPDF is MIT-licensed; run your own if you'd rather.

npm install npm run build npm start # http://localhost:3000 node dist/smoke.js # end-to-end render check

Or pull the published image, which has Chromium and the fonts baked in:

docker run -p 3000:3000 \ -e BASE_URL=http://localhost:3000 \ -e DATA_DIR=/data -v mintpdf-data:/data \ ghcr.io/trendtweekers/mintpdf:latest

Then it is the same API on your own machine, with no limits and nothing leaving it:

curl -X POST http://localhost:3000/v1/pdf \ -H "Content-Type: application/json" \ -d '{"markdown":"# Local","pageNumbers":true}' --output local.pdf

Images are built and published by CI on every change, and each is smoke-tested by starting the container and rendering a real PDF from it before being tagged. Tags arelatestand the short commit SHA. Building it yourself works too:

docker build -t mintpdf . docker run -p 3000:3000 -e BASE_URL=http://localhost:3000 mintpdf

Environment:BASE_URL(used in download links),DATA_DIR(defaults to/tmp/mintpdf; mount a volume to persist keys),ANON_DAILY_LIMIT,FREE_MONTHLY_LIMIT,SOLO_MONTHLY_LIMIT,TEAM_MONTHLY_LIMIT,SCALE_MONTHLY_LIMIT,OVERAGE_FACTOR,RENDER_CONCURRENCY,RENDER_QUEUE,RENDER_QUEUE_WAIT_MS.

Every render is a Chromium tab, somemory bounds concurrency long before CPU or cost does. Unbounded, a traffic spike opens a tab per request until the OOM reaper kills the container and every request fails, including ones nearly finished. Measured here: 30 concurrent renders with no gate left 30 orphaned Chrome processes and an unusable machine.

RENDER_CONCURRENCYrenders run at once,RENDER_QUEUEmore may wait, and anything beyond that is refused immediately with503 and aRetry-Afterrather than being allowed to pile up. Turning some callers away in under a second is strictly better than serving everyone a timeout.

Code defaults are conservative (3 and 20). Measured on one small Railway instance at 10 and 70:

Roughly 18 renders a second sustained, with the refused share answered in under 2.7s. Raise the numbers only against a measurement on your own instance size, never on hope.

If you want a fuller self-hosted PDF toolchain (Office formats, merging, splitting),Gotenbergis excellent and does more than this does.

This service renders HTML and URLs supplied by anyone, so the interesting questions are about what that content can reach.

Submitted HTML executes JavaScript.It has to: Mermaid diagrams and KaTeX maths are rendered in the page. Treat the renderer as running untrusted code, which is why the network restrictions below matter more than they would for a static converter.
- A submittedurlis parsed, restricted tohttp/https, and resolved. Ifanyresolved address is private, the request is refused with a 400 before a browser is involved.
- Independently, every request Chromium makes is intercepted and the destinationresolved again at request time, then blocked if private. This covers embedded images, stylesheets, fonts, redirects andfetch()from submitted JavaScript, not just the URL you asked for.

The second layer resolves rather than trusting the hostname, andcaches only refusals, never approvals: caching "this host is public" would reopen the exact hole the check exists to close. Unresolvable names fail closed.

Being precise about what that does and does not achieve: a DNS-rebinding attempt can no longer wait out a cached approval, so it has to win a race between this lookup and Chromium's own, on every request. That is a much narrower target than a fixed window, but it is a narrowed race rather than a closed door. Eliminating it entirely means pinning the resolved address at the socket layer, which is not implemented.

Blocked: loopback,0.0.0.0, RFC1918, CGNAT (100.64/10), link-local and cloud metadata (169.254.169.254); IPv6 loopback, unspecified, link-local, site-local, unique-local, multicast, NAT64 and Teredo;IPv4-mapped and IPv4-compatible forms in either spelling, so::ffff:10.0.0.1and::ffff:a00:1are the same address and both are refused;localhost/.local/.internalnames; any public hostname that resolves to a private address; and every scheme except http, https, data and blob.

Addresses are judged from their bytes rather than by matching text, because the same address has many spellings and a text match catches one and misses the rest.

There is a test suite for exactly this, and it is meant to be run rather than trusted:

BASE=https://mintpdf.dev node scratchpad/ssrf_suite.mjs

It checks the bypasses aboveandthat ordinary rendering still works, because a guard that also blocks web fonts is a different bug rather than a fix.

The IPv6 parser has its own table of adversarial literals, since an invalid string silently becoming a valid address is the failure that matters in this kind of code:

Download linksuse acrypto.randomUUID()identifier and arenot authenticated: anyone with the link can fetch the file for the hour it exists. That is deliberate, so a link can be emailed or handed to a browser, but it means the link is the secret.

Logging.Request metadata is logged (method, path, status, duration).Request bodies are never logged, so the HTML and Markdown you send are not written anywhere except the temporary file. The analytics table stores event kind, path, referrer, country and a daily-salted hash of the IP. No document content, and no way to reconstruct a document from it.

- Files are deleted after one hour.There is no document library and no way to fetch a render again later. Generate, use, done. If you need permanence, save the bytes on your side.
- No Office formats, merging or splitting.This converts HTML, Markdown and web pages, and nothing else.
Gotenbergis more mature and covers far more ground if you are self-hosting and need that.
- One instance.Keys and quotas live in SQLite on a mounted volume, so running several replicas against one volume will not work. Horizontal scaling needs a real database first.
- Renders are admission-controlled.Over capacity the API returns503withRetry-Afterrather than queueing without limit. See the table above for measured behaviour.
- Two days old at the time of writing, with no paying users yet.

TypeScript, Fastify, and Puppeteer driving one shared Chromium with a page per request.node:sqliteholds keys, quotas and events, so there are no native dependencies to build.

The parts that took the actual work are the unglamorous ones:

- Print CSS.break-inside: avoidon tables, rows, list items, code blocks, blockquotes and figures;thead { display: table-header-group }so headers repeat;orphans/widows;break-after: avoidon headings so none is stranded at the foot of a page.
- Header and footer templates, which are a separate document from your page: they ignore the page CSS and render at near-zero font size unless the styles are inlined, and they sit outside the content margins.
- Admission control, because one Chromium tab per concurrent request is how the container runs out of memory.
- Network isolationfor a renderer that executes untrusted JavaScript. See Security.

The 1Password MCP server creates a bridge that allows MCP clients such as Codex and Kiro to manage your 1Password Environments with secure authorization prompts.

This is the 1st, easiest, and cheapest PPT, slides, presentation AI generation MCP Server in the world.

Persistent memory for any AI assistant. Zero token cost until recall. Stores memories in local SQLite, ranks by 6-factor scoring, returns results 79% smaller than JSON. Works with Claude, ChatGPT, Grok, Cursor, Windsurf, and any MCP client.

A MCP server that enables AI assistants to interact with Anki, the spaced repetition flashcard application.

Enables LLM clients to interact with macOS applications through AppleScript. Built using the @beyondbetter/bb-mcp-server library, this server provides safe, controlled execution of predefined scripts with optional support for arbitrary script execution.

An MCP server for WordPress plugin audits

Turn your AI assistant into a digital marketing hub that creates, organizes, and analyzes links and QR Codes on demand.

Connect AI clients to Cal.com scheduling through the Model Context Protocol using the hosted server at mcp.cal.com or a local instance.

Sync Calendars, Scheduling Links, AI Executive Scheduling Assistant, Unified Calendar

No reviews yet — be the first

Sign in to leave a review

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.