MintPDF MCP server

MintPDF

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

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

mintpdf.dev

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.

and footers that actually inherit your styling. See How it works.

• Pagination is the point. break-inside, repeating thead, orphans and widows, and headers

document mid-conversation.

• MCP native — generatepdf and pdffrom_url over streamable HTTP, so an agent can produce a

never logged. Keys, emails and usage counters obviously are stored. See Security.

• Documents aren't kept — rendered files are deleted after an hour, and their contents are

operate Chromium, not because the renderer is secret.

• Run it yourself — MIT, with a published image. The hosted service exists so you don't have to

Quickstart

No signup, no key:

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 send Authorization: Bearer pm_… with your requests.

Use it from Claude (or any MCP client)

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

Prefer the hosted endpoint directly? Use mcp-remote instead:

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

Restart your client, then just ask:

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

API

POST /v1/pdf

Body takes exactly one source, plus options:

POST /v1/keys

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

POST /mcp

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

Postman

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

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

Shortened. The full README is on GitHub.