papertype-mcp
OfficialClick on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@papertype-mcp turn this markdown into a PDF saved as ~/Documents/q3-report.pdf"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
papertype-mcp
An MCP server for PaperType, a hosted PDF API. It lets Claude Desktop, Claude Code, Cursor and any other MCP client turn Markdown, HTML or a filled-in template (invoice, certificate, report) into a PDF file on your disk.
The server runs locally over stdio, calls https://papertype.dev/v1/pdf with your API key, and
writes the PDF to a file. It returns the file path, page count and your remaining quota; it never
returns PDF bytes to the model.
Clients are open source (MIT); the rendering service is hosted and paid above the free tier.
API reference: https://papertype.dev/docs
Get an API key: https://papertype.dev/signup?ref=npm
Python SDK and CLI:
pip install papertype
Requirements
Node.js 20 or newer (uses the built-in
fetch).A PaperType API key (
dp_...) from https://papertype.dev/signup?ref=npm.
Related MCP server: docrenders-mcp
Configuration
Environment variable | Required | Default | Meaning |
| yes | — | Your API key. The server refuses to start without it and prints where to get one. |
| no |
| API origin; change only for self-hosted or test deployments. |
| no |
| Where PDFs are written when a call gives no |
Files in the temp directory may be cleaned up by the OS; set PAPERTYPE_OUTPUT_DIR to a
persistent folder (for example ~/Documents/papertype) if you want to keep them.
Install
Claude Desktop
Edit claude_desktop_config.json (macOS: ~/Library/Application Support/Claude/, Windows:
%APPDATA%\Claude\) and restart Claude Desktop:
{
"mcpServers": {
"papertype": {
"command": "npx",
"args": ["-y", "papertype-mcp"],
"env": {
"PAPERTYPE_API_KEY": "dp_...",
"PAPERTYPE_OUTPUT_DIR": "/Users/you/Documents/papertype"
}
}
}
}Claude Code
claude mcp add papertype -e PAPERTYPE_API_KEY=dp_... -- npx -y papertype-mcpAdd -e PAPERTYPE_OUTPUT_DIR=/path/to/folder to choose where PDFs land. Check with claude mcp list.
Cursor
Settings → MCP → Add new global MCP server, or create .cursor/mcp.json in your project:
{
"mcpServers": {
"papertype": {
"command": "npx",
"args": ["-y", "papertype-mcp"],
"env": { "PAPERTYPE_API_KEY": "dp_..." }
}
}
}Any stdio MCP client
Run the command npx -y papertype-mcp (or install globally with npm i -g papertype-mcp and run
papertype-mcp) with PAPERTYPE_API_KEY in its environment. The server speaks MCP over
stdin/stdout; diagnostics go to stderr. papertype-mcp --help prints the options.
Tools
render_pdf
Render a document and save it as a PDF. Give exactly one source:
markdown— GitHub-flavoured Markdown (tables, fenced code, footnotes, admonitions), orhtml— an HTML document or fragment, ortemplate+data— one ofinvoice,certificate,reportwith a JSON object of fields.
Optional: theme (clean default, report, minimal, letter, none), page_size (A4
default, Letter, Legal, A5), title, author, date, cover, toc (Markdown only),
page_numbers (default true), header, footer, css, filename, and output_path.
output_path rules: omit it to get a unique file named after the title (or filename, or the
first Markdown heading) under PAPERTYPE_OUTPUT_DIR, never overwriting anything; pass an
existing directory (or a path ending in /) to save a uniquely named file in it; pass any other
path to write exactly that file (.pdf is appended if missing and an existing file is replaced).
Relative paths resolve against PAPERTYPE_OUTPUT_DIR.
Returns text like:
Saved PDF: /tmp/papertype/q3-report.pdf
Pages: 4
Quota this month: 12 of 50 documents used (free plan)
Note: free plan output carries a small papertype.dev mark.Each successful call uses one document of the account's monthly quota.
list_templates
Lists the three hosted templates with a description, every field (name, type, required) and a
complete sample data object. Local only; no quota used. Live pages:
https://papertype.dev/templates/invoice, /templates/certificate, /templates/report.
account
Returns GET /v1/me: email, plan, quota, used_this_month, watermark. No quota used.
Errors
API failures come back as tool errors (isError: true) that include the server's own message:
HTTP | Meaning |
401 | Missing or invalid API key — check |
400 | No |
413 | Source larger than 2 MB. |
422 | Render or template error; the detail says which field or construct failed. |
429 | Monthly document quota reached; upgrade at https://papertype.dev/account. |
Network failures and timeouts are reported the same way, with the URL that was tried.
Free plan
Free-plan PDFs carry a small papertype.dev mark in the footer; paid plans do not. The server
checks /v1/me once per process and appends a note to render_pdf results when the mark
applies, so the model (and you) are not surprised by it.
Limits (server side)
2 MB of source and 300 pages per document. Renders are processed a couple at a time server-wide, so a call can take several seconds under load; the client waits up to 3 minutes. Rendering is CSS paged media (WeasyPrint); no JavaScript runs. See https://papertype.dev/docs.
Development
npm install
npm run build # tsc -> dist/
npm test # vitest, fetch is mocked; no network or API key needed
PAPERTYPE_API_KEY=dp_... node dist/cli.jsSource layout: src/cli.ts (entry point, stdio transport), src/server.ts (tool definitions),
src/client.ts (fetch wrapper for /v1/pdf and /v1/me), src/errors.ts (status → message),
src/output.ts (file naming), src/templates.ts (template catalogue copied from the service's
doc_templates/*/meta.json and sample.json; keep it in sync when templates change).
Publishing
npm: bump
versioninpackage.jsonandsrc/version.ts(a test checks they match), thennpm publish.prepublishOnlyruns the build and tests.MCP Registry (https://registry.modelcontextprotocol.io):
server.jsonin this folder follows the2025-12-11server.json schema and validates against it. Publishing additionally requires: (1) proving ownership of thedev.papertype/*namespace with themcp-publisherCLI (mcp-publisher login dnsorlogin httpfor papertype.dev; a GitHub-based namespace such asio.github.<owner>/papertype-mcpwould uselogin githubinstead, andnameplusmcpNamebelow must then be changed to match), (2) the npm package containing an"mcpName": "dev.papertype/papertype-mcp"field inpackage.jsonso the registry can confirm the package belongs to that namespace, and (3)mcp-publisher publishrun from this folder after the npm version is live. The registry's rules can change; runmcp-publisher validate(or the schema check innpm run check:manifest) before each publish rather than trusting this note.
License
MIT. See LICENSE. "PaperType" refers to the hosted service at papertype.dev; this package is the
client, not the renderer.
Available Tools
3 toolsaccountPaperType account statusARead-onlyIdempotent
Show the PaperType account behind the configured API key: email, plan, monthly document quota, documents used this month, and whether output carries the free-plan mark. Uses no quota.
Inputs: no named parameters.
list_templatesList PaperType templatesARead-onlyIdempotent
List the hosted PDF templates available to render_pdf (invoice, certificate, report) with a description, the fields each accepts (name, type, required) and a complete sample data object you can adapt. No network call; uses no quota.
Inputs: no named parameters.
render_pdfRender a PDF with PaperTypeA
Render a PDF from Markdown, HTML, or a hosted template (invoice, certificate, report) using the PaperType API, and save it to disk. Returns the absolute file path, page count and remaining quota; the PDF bytes are never returned inline. Provide exactly one source: markdown, html, or template + data. Each call uses one document of the account's monthly quota.
Inputs: css, toc, data, date, +13 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
The three tools have clearly distinct purposes: rendering a document, listing available templates, and inspecting account/quota status. There is no overlap in selection intent, and list_templates explicitly supports render_pdf without competing with it.
render_pdf and list_templates follow a clear verb_noun pattern, while account is a noun-only name. The deviation is minor and still readable, but it prevents a perfect consistency score.
Three tools are well-scoped for a focused PDF rendering service. Each tool earns its place: rendering, template discovery, and account/quota inspection.
The surface covers the core lifecycle: discovering templates, rendering documents, and checking quota/account state. Minor gaps exist, such as no separate template-detail or validation operation, but list_templates largely mitigates this.
Maintenance
Related MCP Connectors
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
Convert PDF documents to Markdown for AI agents through an authenticated remote MCP server.
MCP server for Api2Pdf — generate PDFs & images from HTML, URLs or office files; merge, barcodes.
Design, publish and render PDF templates with Typst. Full template lifecycle over MCP.
Related MCP Servers
- AlicenseAqualityCmaintenanceTurn markdown into designed PDFs with cover page, table of contents, and code blocks that hold across pages. One command from Claude Desktop, Claude Code, Cursor, Cline, Zed, or any MCP-capable client.298 npm2MIT
- AlicenseAqualityDmaintenanceGenerate production-ready PDFs from Markdown, HTML, or built-in templates (invoices, resumes, reports) directly from Claude or any MCP-compatible AI agent via the DocRenders API.6MIT

pdfluent-mcpofficial
AlicenseAqualityBmaintenanceEnables MCP clients to read local PDFs as markdown, plain text, tables, or positioned blocks; inspect metadata; search documents; list and fill form fields into new files; and identify pages needing vision, while keeping documents on-machine and limiting access to allowed directories.952 PyPIAGPL 3.0
FastOCR MCP serverofficial
AlicenseAqualityCmaintenanceEnables MCP clients such as Claude Desktop, Claude Code and Cursor to OCR local scanned PDFs and images in 100+ languages, returning the extracted text or a searchable PDF. It also lets agents check document status, list recent documents and delete them.689 PyPIMIT