pretext-pdf-mcp
Click 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., "@pretext-pdf-mcp generate an invoice for Acme Corp"
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.
pretext-pdf-mcp
MCP server for pretext-pdf — generate professional PDFs from structured JSON in Claude, Cursor, or any AI agent.
No headless browser. No puppeteer. Pure Node.js with embedded fonts and precision text layout.
Live Demo
▶ Open Live Demo — edit JSON, click Generate, see a real PDF in seconds. No install.
▶ Open in StackBlitz — fork and edit the playground code.
4 templates included: GST Invoice · Market Report · Resume/CV · Custom
Related MCP server: PDF Generator API MCP Server
Connect via Smithery
The fastest way — no install, works instantly in any MCP-compatible agent:
https://pretext-pdf.run.toolsOr add via CLI:
smithery mcp add himaan4149-kv55/pretext-pdfLocal Install (Claude Desktop / Cursor / Windsurf)
Option 1: npx (no global install needed)
npx pretext-pdf-mcpOption 2: Global install
npm install -g pretext-pdf-mcp
pretext-pdf-mcpClaude Desktop Configuration
Add to your claude_desktop_config.json:
{
"mcpServers": {
"pretext-pdf": {
"command": "npx",
"args": ["-y", "pretext-pdf-mcp"]
}
}
}Config file location:
macOS:
~/Library/Application Support/Claude/claude_desktop_config.jsonWindows:
%APPDATA%\Claude\claude_desktop_config.json
Using with Claude Code CLI
Option A — one-liner (user-scoped, persists across projects):
claude mcp add pretext-pdf-mcp -- npx -y pretext-pdf-mcpOption B — project-scoped .mcp.json (checked into repo, shared with your team):
Create .mcp.json in your project root:
{
"mcpServers": {
"pretext-pdf": {
"command": "npx",
"args": ["-y", "pretext-pdf-mcp"]
}
}
}Then restart Claude Code (or run /mcp to verify). All 6 tools are available in your session. Type /mcp to confirm the server appears.
HTTP Transport Mode (advanced)
By default the server runs over stdio (MCP standard transport). For HTTP transport:
MCP_TRANSPORT=http MCP_PORT=3000 npx pretext-pdf-mcpEnvironment variables:
MCP_TRANSPORT— Set tohttpto enable HTTP transport (default:stdio)MCP_PORT— HTTP listen port whenMCP_TRANSPORT=http(default:3000)MCP_HOST— HTTP listen host (default:127.0.0.1)
Security note: HTTP transport is intended for trusted local networks only. Do not expose the HTTP port to the public internet without adding an authentication layer.
Known Limitations
Italic fonts — Italic markdown (
*text*) requires an italic font variant. Inter italic is supported via@fontsource/inter(installed automatically). For other fonts, provide{ family, weight, style: 'italic', src }indoc.fonts.QR codes, barcodes, charts — Require optional peer dependencies:
qrcode,bwip-js,vega/vega-lite. Install the ones you need.SVG and images — Image URLs must be HTTPS. Private/local IP addresses are blocked (SSRF prevention). File paths require absolute paths.
Large documents — No hard page limit, but generation time scales with page count. Documents over 10,000 content elements trigger a performance advisory.
CJS consumers — pretext-pdf is ESM-only. If your project uses CommonJS, use dynamic
import().
Tools
Tool | Input | Output |
| PdfDocument JSON descriptor | Base64 PDF + filename + size |
| Invoice data (parties, items, GST, currency) | Base64 PDF |
| Report sections with optional tables and callouts | Base64 PDF |
| Markdown string | Base64 PDF |
| PdfDocument JSON | Validation result (valid/errors) |
| none | Markdown reference of all element types |
generate_pdf
Full-power access to the pretext-pdf API. Pass any PdfDocument descriptor.
{
"document": {
"pageSize": "A4",
"footer": { "text": "Page {{pageNumber}} of {{totalPages}}", "fontSize": 9 },
"content": [
{ "type": "heading", "level": 1, "text": "My Document" },
{ "type": "paragraph", "text": "Hello world." }
]
},
"filename": "my-document"
}Returns:
{
"success": true,
"base64": "<base64-encoded PDF bytes>",
"filename": "my-document.pdf",
"size_bytes": 42816
}generate_invoice
Business-friendly invoice generator. No PDF knowledge needed.
{
"from": {
"company": "Antigravity Systems",
"address": "Gurugram, Haryana",
"gstin": "06AABCA1234Z1ZK",
"email": "hello@antigravity.dev"
},
"to": {
"company": "TCS Ltd",
"address": "Mumbai, Maharashtra",
"gstin": "27AAACT2727Q1ZW"
},
"invoice_number": "INV-2026-001",
"date": "2026-04-08",
"due_date": "2026-05-08",
"currency": "INR",
"items": [
{
"description": "LLM Fine-tuning Pipeline",
"hsn_code": "998314",
"quantity": 1,
"rate": 250000,
"gst_rate": 18
},
{
"description": "AI Strategy Workshop",
"quantity": 2,
"rate": 75000,
"gst_rate": 18
}
],
"notes": "Payment due within 30 days. NEFT/IMPS preferred."
}Returns:
{
"success": true,
"base64": "<base64-encoded PDF bytes>",
"filename": "invoice-INV-2026-001.pdf",
"size_bytes": 68420
}Features:
Supports INR, USD, EUR, GBP
Auto-calculates IGST per line item when
gst_rateis setHSN/SAC code column appears automatically when any item has it
Company header with from/to details in a 2-column table
Professional footer with invoice number and page numbers
generate_report
Multi-section report with optional TOC, tables, and callout boxes.
{
"title": "Haryana Real Estate Q1 2026",
"subtitle": "Residential & Commercial Analysis",
"author": "Antigravity Research",
"include_toc": true,
"sections": [
{
"heading": "Executive Summary",
"body": "Strong growth across all micro-markets.\n\nGurugram led with 18% YoY volume growth.",
"table": {
"headers": ["Market", "Avg Rs./sqft", "YoY"],
"rows": [
["New Gurugram", "9,800", "+15.6%"],
["Sohna Road", "8,400", "+12.1%"]
]
},
"callout": {
"style": "warning",
"text": "Repo rate risk: any hike above 6.75% could suppress volumes 10-15%."
}
}
]
}list_element_types
No input. Returns a markdown reference of all 22 element types (paragraph, heading, table, list, image, svg, code, blockquote, callout, toc, form-field, comment, hr, spacer, page-break, rich-paragraph, qr-code, barcode, chart, footnote-def, float-group, and toc-entry) with key properties and examples.
generate_from_markdown
Convert a Markdown string to a PDF without writing any JSON. Supports headings, bold/italic, strikethrough, inline code, links, ordered/unordered lists (up to 3 levels), GFM tables (with column alignment), GFM task lists (☑/☐), blockquotes, fenced code blocks, and horizontal rules. Note: code blocks render as plain indented text — not styled monospace. For styled code blocks or richer layouts, use generate_pdf.
{
"markdown": "# Hello\n\nThis is a **bold** paragraph.\n\n- Item 1\n- Item 2",
"filename": "hello",
"page_size": "A4",
"font_size": 12
}Returns:
{
"success": true,
"base64": "<base64-encoded PDF bytes>",
"filename": "hello.pdf",
"size_bytes": 18432
}Limits: markdown max 100,000 characters. font_size must be 6–144. page_size one of: A4, Letter, Legal. Default filename: document.
validate_document
Validate a pretext-pdf document schema without rendering it. Use this as a cheap preflight check before calling generate_pdf — catches typos, missing required fields, and unknown props in strict mode.
{
"document": {
"pageSize": "A4",
"content": [{ "type": "heading", "level": 1, "text": "Test" }]
},
"strict": true
}Valid response:
{ "valid": true, "error_count": 0, "warning_count": 0, "errors": [], "warnings": [] }Invalid response:
{
"valid": false,
"error_count": 2,
"warning_count": 0,
"errors": [
{
"path": "doc.content[0].colour",
"message": "unknown property. did you mean \"color\"",
"code": "UNKNOWN_PROPERTY",
"severity": "error",
"unknownProp": "colour",
"suggestion": "color"
},
{
"path": "doc.pageSize",
"message": "unknown property. did you mean \"pageSize\"",
"code": "UNKNOWN_PROPERTY",
"severity": "error",
"unknownProp": "pageSise",
"suggestion": "pageSize"
}
],
"warnings": []
}Tip: Pass strict: true to catch misspelled props with Levenshtein-nearest suggestions. Default is strict: false — only checks required fields and types.
Decoding the base64 PDF
In Node.js:
const bytes = Buffer.from(result.base64, 'base64')
fs.writeFileSync('output.pdf', bytes)In TypeScript (browser):
const bytes = Uint8Array.from(atob(result.base64), c => c.charCodeAt(0))
const blob = new Blob([bytes], { type: 'application/pdf' })In Python:
import base64
pdf_bytes = base64.b64decode(result['base64'])
with open('output.pdf', 'wb') as f:
f.write(pdf_bytes)License
MIT — Himanshu Jain
Available Tools
6 toolsgenerate_from_markdownA
Convert a Markdown string to a PDF. Supports headings, bold/italic, strikethrough, inline code, links, ordered/unordered lists (nested up to 3 levels), GFM tables (with column alignment), GFM task lists (☑/☐), blockquotes, fenced code blocks (rendered as plain indented text — not styled monospace), and horizontal rules. For richer layouts or styled code blocks, use generate_pdf instead. Returns a base64-encoded PDF.
Inputs: markdown (required), filename, page_size, font_size.
generate_invoiceA
Generate a professional invoice PDF. Accepts structured invoice data (from/to parties, line items, optional GST/tax). Returns base64-encoded PDF. Supports INR/USD/EUR/GBP currencies. Currency symbols (₹ $ € £) are guaranteed not to break away from adjacent numbers across line wraps. gst_rate on items creates a tax column — use it for any tax system (GST, VAT, sales tax). Per-item gst_rate is summed as IGST in the totals; CGST/SGST inter-vs-intra-state routing is not currently supported.
Inputs: from (required), to (required), items (required), invoice_number, +6 more.
generate_pdfA
Generate a PDF from a custom PdfDocument JSON descriptor. Use this for any layout not covered by generate_invoice or generate_report — e.g. resumes, contracts, certificates, presentations, or any multi-element composition. Returns base64-encoded PDF bytes. Call list_element_types first to see available elements and options.
Inputs: document (required), filename.
generate_reportA
Generate a professional multi-section report PDF. Features: auto-generated TOC, per-section headings with PDF bookmarks, page-numbered footer, running header, optional tables and callout boxes per section. Returns base64-encoded PDF.
Inputs: title (required), sections (required), subtitle, author, +3 more.
list_element_typesA
Returns a markdown reference of all pretext-pdf element types and their key properties. Use this before calling generate_pdf to understand what elements and options are available.
Inputs: no named parameters.
validate_documentA
Validate a pretext-pdf document schema without rendering it. Returns immediately with all validation errors — use this as a cheap preflight check before calling generate_pdf. Each error includes a structured path, message, and optional typo suggestion.
Inputs: document (required), strict.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool has a clearly distinct purpose: markdown conversion, invoice generation, custom layout PDF, report generation, element type listing, and document validation. No overlap or ambiguity.
All tool names follow a consistent verb_noun pattern (generate_*, list_*, validate_). The naming is predictable and makes the action and target clear.
With 6 tools, the server is well-scoped, covering the core PDF generation needs (markdown, invoice, report, custom) plus essential helpers for validation and element discovery. Not too many or too few.
The tool surface covers the main PDF generation workflows. A minor gap is the lack of a tool for merging PDFs or converting other formats, but the custom generate_pdf tool can likely cover many of those scenarios. Validation and element listing are nice additions.
Maintenance
Related MCP Connectors
HTML and CSS to PDF MCP server with page headers, footers and page numbers. No headless browser.
MCP server for Api2Pdf — generate PDFs & images from HTML, URLs or office files; merge, barcodes.
Hosted MCP server: convert PDFs to clean, LLM-ready Markdown with tables, formulas and OCR.
MCP server for the PDFGate API. Generate PDFs, manage documents and handle e-signatures.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP server that converts Markdown to high-quality PDF documents using LaTeX, enabling AI agents like Claude to generate professional PDFs without requiring sign-ups or credit cards.180 npm11MIT
- AlicenseNot gradedqualityBmaintenanceAn MCP server that enables interaction with the PDF Generator API for automated document generation and management. It supports both stdio and HTTP transports, allowing AI models to create and handle PDFs using OpenAPI v4 specifications.1MIT
- AlicenseAqualityDmaintenanceMCP server for Word document (.docx) creation and manipulation — the production-grade document automation tool for AI agents.946 npmMIT
- AlicenseNot gradedqualityDmaintenanceMCP server that lets AI agents produce print-ready, typographically correct PDFs using Typst, with a page-as-canvas engine, multiple templates, and per-page layout quality control.9MIT