pdfnative MCP — PDF generation, PAdES signing & introspection
Generate, sign, inspect and edit PDFs, including PDF/A and PAdES, from an AI client
pdfnative MCP — PDF generation, PAdES signing & introspection is an MCP server for files and documents. It runs locally on your machine and is started by your AI client.
- Platforms
- CLI
- Runs
- Locally
- Version
- 1.8.0
- Listing updated
Similar MCP servers
Install
Run in a terminal
claude mcp add pdfnative-mcp --env PDFNATIVE_MCP_HTTP_TOKEN='<PDFNATIVE_MCP_HTTP_TOKEN>' --env PDFNATIVE_MCP_TSA_AUTH='<PDFNATIVE_MCP_TSA_AUTH>' -- npx -y pdfnative-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"pdfnative-mcp": {
"command": "npx",
"args": [
"-y",
"pdfnative-mcp"
],
"env": {
"PDFNATIVE_MCP_HTTP_TOKEN": "<PDFNATIVE_MCP_HTTP_TOKEN>",
"PDFNATIVE_MCP_TSA_AUTH": "<PDFNATIVE_MCP_TSA_AUTH>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"pdfnative-mcp": {
"command": "npx",
"args": [
"-y",
"pdfnative-mcp"
],
"env": {
"PDFNATIVE_MCP_HTTP_TOKEN": "<PDFNATIVE_MCP_HTTP_TOKEN>",
"PDFNATIVE_MCP_TSA_AUTH": "<PDFNATIVE_MCP_TSA_AUTH>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"pdfnative-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"pdfnative-mcp"
],
"env": {
"PDFNATIVE_MCP_HTTP_TOKEN": "<PDFNATIVE_MCP_HTTP_TOKEN>",
"PDFNATIVE_MCP_TSA_AUTH": "<PDFNATIVE_MCP_TSA_AUTH>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"pdfnative-mcp": {
"command": "npx",
"args": [
"-y",
"pdfnative-mcp"
],
"env": {
"PDFNATIVE_MCP_HTTP_TOKEN": "<PDFNATIVE_MCP_HTTP_TOKEN>",
"PDFNATIVE_MCP_TSA_AUTH": "<PDFNATIVE_MCP_TSA_AUTH>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"pdfnative-mcp": {
"command": "npx",
"args": [
"-y",
"pdfnative-mcp"
],
"env": {
"PDFNATIVE_MCP_HTTP_TOKEN": "<PDFNATIVE_MCP_HTTP_TOKEN>",
"PDFNATIVE_MCP_TSA_AUTH": "<PDFNATIVE_MCP_TSA_AUTH>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
PDFNATIVE_MCP_OUTPUT_DIRAbsolute path of a sandboxed directory where outputMode='file' may write PDFs. Unset: every tool returns base64 only (file output disabled).PDFNATIVE_MCP_OUTPUT_BASE_URLOptional public base URL of PDFNATIVE_MCP_OUTPUT_DIR when the operator serves it over HTTP (e.g. https://files.example.com/pdf/). File-mode results then carry url (base + sandbox-relative path, percent-encoded) and name it instead of the host path. Absolute http(s) URL, no credentials, query or fragment; requires PDFNATIVE_MCP_OUTPUT_DIR; invalid value refuses to start. Never requested by the server.PDFNATIVE_MCP_CACHE_DIROpt-in content-addressed response cache directory (SHA-256 keyed, 1h TTL, 256 MiB LRU, plaintext at rest). Never caches encrypt/decrypt, sign, timestamp, add_ltv, update_metadata, encrypted builds or file output.PDFNATIVE_MCP_FONT_DIROptional operator font sandbox: absolute path of a directory of .ttf / .otf files (at most 64, 16 MiB each), each parsed by the engine and registered at boot under the slug of its file name; tools name one with the font input (FONT_NOT_FOUND otherwise). An invalid directory or file refuses to start. Never a path from a tool argument.PDFNATIVE_MCP_PORTServe Streamable HTTP on this loopback port instead of stdio (MCP 2026-07-28, stateless). Unauthenticated unless PDFNATIVE_MCP_HTTP_TOKEN is set.PDFNATIVE_MCP_HTTP_TOKENOpt-in bearer token for the HTTP transport (>= 16 chars, no whitespace). When set, /mcp requires 'Authorization: Bearer <token>' or answers 401. Never logged.PDFNATIVE_MCP_MAX_INFLATE_BYTESPer-stream FlateDecode decompression cap in bytes (zip-bomb mitigation; default 104857600 = 100 MiB). Integer >= 1024; an invalid value refuses to start the server.PDFNATIVE_MCP_CREATION_DATEISO 8601 instant with a time zone (e.g. 2026-01-01T00:00:00Z) pinned as the creation date of every generated document: reproducible bytes on any host. A call's own creationDate still wins. An invalid value refuses to start the server.SOURCE_DATE_EPOCHreproducible-builds.org convention: integer seconds since the Unix epoch, used as the pinned creation date when PDFNATIVE_MCP_CREATION_DATE is unset. An invalid value refuses to start the server.PDFNATIVE_MCP_TSA_URLhttp(s) URL of the RFC 3161 timestamp authority used by sign_pdf timestamp=true and timestamp_pdf (PAdES B-T / B-LTA). Unset: those calls fail with TSA_NOT_CONFIGURED and no network request is made. Tool arguments can never supply a URL.PDFNATIVE_MCP_TSA_AUTHOptional Authorization header value sent to the TSA (e.g. 'Basic ...' or 'Bearer ...'). Never logged or echoed.PDFNATIVE_MCP_REVOCATION'ocsp', 'crl' or 'ocsp,crl': enables online revocation collection for add_ltv mode='online' (PAdES B-LT). Unset: that mode fails with REVOCATION_NOT_CONFIGURED; mode='offline' stays fully offline. Requires PDFNATIVE_MCP_NETWORK_ALLOWED_HOSTS.PDFNATIVE_MCP_NETWORK_ALLOWED_HOSTSComma-separated allow-list of OCSP / CRL responder hosts ('host', 'host:port' or '*.suffix'). Mandatory when PDFNATIVE_MCP_REVOCATION is set: responder URLs found in certificates are fetched only if the host matches (http(s) only, no credentials, no redirects, internal addresses rejected unless listed verbatim).PDFNATIVE_MCP_NETWORK_TIMEOUT_MSPer-request timeout for TSA / OCSP / CRL calls in milliseconds, 1000-120000 (default 10000).
About pdfnative MCP — PDF generation, PAdES signing & introspection
Built on the zero-dependency pdfnative engine, this server offers 28 tools and 7 prompts. Document generation takes 13 block kinds (headings, tables, images, barcodes, SVG, charts, form fields and more), with options for PDF/A archival, PDF/X-4 print exchange, spot colours, CMYK, watermarks, outlines and encryption. Text handling covers 32 Unicode scripts, right-to-left layout and colour emoji, and a dry-run layout tool reports page count and block placement without producing a PDF.
The signing side covers PAdES B-B and B-T signatures, long-term validation material, RFC 3161 timestamps and verification of every signature. Other tools read and fill existing AcroForms, merge, split and extract pages, encrypt and decrypt, extract text and attachments (including Factur-X and ZUGFeRD XML), annotate, and validate structure for PDF/UA or PDF/X-4. A governance tool drafts a GitHub issue locally and never submits it.
By default every tool returns base64. File output is off until the operator sets PDFNATIVE_MCP_OUTPUT_DIR, which sandboxes writes. Timestamping needs an operator-configured authority URL, and tool arguments can never supply one. An opt-in loopback HTTP mode takes an optional bearer token, and a decompression cap guards against zip bombs.
Tools this server provides (17)
Taken from the project documentation; the running server may differ.
- generate_basic_pdf
- Builds multi-page documents from 13 block kinds.
- inspect_layout
- Dry-run pagination report without producing a PDF.
- add_barcode
- Embeds a QR, Code 128, EAN-13, Data Matrix or PDF417 barcode.
- add_table
- Creates tabular reports.
- add_form
- Creates a new interactive AcroForm PDF.
- read_form_fields
- Lists an existing form's fields.
- fill_form
- Fills or flattens an existing AcroForm.
- sign_pdf
- Adds PAdES B-B or B-T signatures.
- add_ltv
- Embeds long-term validation material.
- timestamp_pdf
- Appends an RFC 3161 document timestamp.
- verify_pdf
- Verifies signatures and timestamps.
- validate_pdf
- Checks PDF/UA or PDF/X-4 structural conformance.
- merge_pdfs
- Concatenates 2 to 50 PDFs.
- split_pdf
- Splits a PDF by page range.
- encrypt_pdf
- Re-secures a PDF with AES-128 or AES-256.
- extract_text
- Extracts Unicode text.
- inspect_pdf
- Read-only inspection of a PDF.
What it does
- Rich PDF generation
- Thirteen block kinds with PDF/A, PDF/X-4, spot colours and CMYK.
- PAdES signing
- B-B to B-LTA signatures, LTV data and RFC 3161 timestamps.
- Form handling
- Create AcroForms, read their fields and fill or flatten existing ones.
- Page operations
- Merge, split and extract pages, or encrypt and decrypt.
- Inspection and validation
- Report signatures, PDF/A claims, annotations and PDF/UA or PDF/X-4 structure.
- Sandboxed file output
- Writes are confined to an operator-set directory.
Good for
- Generate a multilingual report with tables and charts
- Sign a contract PDF and verify its signatures later
- Fill an existing AcroForm and flatten it
- Extract text or Factur-X XML from received invoices
- Merge or split documents and check pagination before rendering
Pricing
Pricing unknown
Installed from npm; no price listed
pdfnative MCP — PDF generation, PAdES signing & introspection FAQ
Where do generated PDFs go?
Tools return base64 by default; file output needs PDFNATIVE_MCP_OUTPUT_DIR.
Can pdfnative MCP — PDF generation, PAdES signing & introspection sign with a timestamp?
Yes, if the operator configures a timestamp authority URL in PDFNATIVE_MCP_TSA_URL.
Does pdfnative MCP — PDF generation, PAdES signing & introspection support right-to-left text?
Yes, with a direction option and 32 supported scripts.
Is annotation the same as redaction?
No. The annotate tool is a visual overlay, not a redaction.
How do I add pdfnative MCP — PDF generation, PAdES signing & introspection to Claude Code?
Run this command in your terminal: claude mcp add pdfnative-mcp --env PDFNATIVE_MCP_HTTP_TOKEN='<PDFNATIVE_MCP_HTTP_TOKEN>' --env PDFNATIVE_MCP_TSA_AUTH='<PDFNATIVE_MCP_TSA_AUTH>' -- npx -y pdfnative-mcp
What are the best alternatives to pdfnative MCP — PDF generation, PAdES signing & introspection?
The closest alternatives to pdfnative MCP — PDF generation, PAdES signing & introspection are PDFGate, Pdfops MCP, Pdfstudio, Pdfedit MCP and PDFLean.
Where this comes from
- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.