Skip to main content
Glama
papertype-mcp

papertype-mcp

Official

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.

Requirements

Related MCP server: docrenders-mcp

Configuration

Environment variable

Required

Default

Meaning

PAPERTYPE_API_KEY

yes

—

Your API key. The server refuses to start without it and prints where to get one.

PAPERTYPE_BASE_URL

no

https://papertype.dev

API origin; change only for self-hosted or test deployments.

PAPERTYPE_OUTPUT_DIR

no

<OS temp dir>/papertype (e.g. /tmp/papertype)

Where PDFs are written when a call gives no output_path.

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-mcp

Add -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), or

  • html — an HTML document or fragment, or

  • template + data — one of invoice, certificate, report with 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 PAPERTYPE_API_KEY.

400

No html, markdown or template given.

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

Source 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 version in package.json and src/version.ts (a test checks they match), then npm publish. prepublishOnly runs the build and tests.

  • MCP Registry (https://registry.modelcontextprotocol.io): server.json in this folder follows the 2025-12-11 server.json schema and validates against it. Publishing additionally requires: (1) proving ownership of the dev.papertype/* namespace with the mcp-publisher CLI (mcp-publisher login dns or login http for papertype.dev; a GitHub-based namespace such as io.github.<owner>/papertype-mcp would use login github instead, and name plus mcpName below must then be changed to match), (2) the npm package containing an "mcpName": "dev.papertype/papertype-mcp" field in package.json so the registry can confirm the package belongs to that namespace, and (3) mcp-publisher publish run from this folder after the npm version is live. The registry's rules can change; run mcp-publisher validate (or the schema check in npm 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 tools
accountPaperType account statusA
Read-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 templatesA
Read-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

    A4.4/5.0

    Scored across 3 tools

    Disambiguation5/5

    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.

    Naming Consistency4/5

    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.

    Tool Count5/5

    Three tools are well-scoped for a focused PDF rendering service. Each tool earns its place: rendering, template discovery, and account/quota inspection.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      C
      maintenance
      Turn 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.
      2
      98 npm
      2
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Generate 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.
      6
      MIT
    • A
      license
      A
      quality
      B
      maintenance
      Enables 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.
      9
      52 PyPI
      AGPL 3.0
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      6
      89 PyPI
      MIT