# pdfnative MCP — PDF generation, PAdES signing & introspection

> pdfnative MCP — PDF generation, PAdES signing & introspection is an MCP server for files and documents. Generate, sign, inspect and edit PDFs, including PDF/A and PAdES, from an AI client. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Platforms:** CLI
- **Repository:** https://github.com/nizoka/pdfnative-mcp
- **MCP Registry name:** io.github.Nizoka/pdfnative-mcp
- **Categories:** [files and documents](https://ai-powered.com/categories/files-and-documents), [developer tools](https://ai-powered.com/categories/developer-tools)
- **Listing updated:** 2026-11-15

## About

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.

## Features

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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

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

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

## Alternatives

- [PDFGate](https://ai-powered.com/mcp/pdfgate): PDFGate is an MCP server for files and documents.
- [Pdfops MCP](https://ai-powered.com/mcp/pdfops-mcp): Pdfops MCP is a freemium MCP server for files and documents.
- [Pdfstudio](https://ai-powered.com/mcp/pdfstudio): Pdfstudio is an open-source MCP server for files and documents.
- [Pdfedit MCP](https://ai-powered.com/mcp/pdfedit-mcp): Pdfedit MCP is a freemium MCP server for files and documents.
- [PDFLean](https://ai-powered.com/mcp/pdflean): PDFLean is a freemium MCP server for files and documents.
- [S3eidat Tools](https://ai-powered.com/mcp/s3eidat-tools): S3eidat Tools is a free MCP server for files and documents.
- [pdf.net](https://ai-powered.com/mcp/pdf-net): pdf.net is a free MCP server for files and documents.
- [Nutrient MCP](https://ai-powered.com/mcp/nutrient-mcp): Nutrient MCP is a freemium MCP server for files and documents.

---
Source: https://ai-powered.com/mcp/pdfnative-mcp-pdf-generation-pades-signing-and-introspection
