Skip to content
MCP server

Pdfops MCP

Fill, merge, split, watermark and protect PDFs through a hosted deterministic API

Status and history

Answered our latest tool-list check 21 hours ago with 22 tools. It will be marked verified after 3 successful checks in 7 days.

Pricing
Freemium
Platforms
API, CLI
Runs
Locally or Remotely
Version
0.4.5
Listing updated
3 days ago

About Pdfops MCP

Pdfops MCP is a freemium MCP server for files and documents. It can run locally on your machine or as a hosted remote server.

Behind the MCP server is a hosted PDF API with fourteen endpoints. The vendor stresses determinism: the same input gives byte-identical output, with no headless browser involved. Tools cover inspecting a form's fields, filling AcroForm fields, merging, extracting, deleting, rotating and splitting pages, watermarks, page numbers, unlock and protect, metadata read and write, and building an invoice from JSON.

Run it locally via npx -y pdfops-mcp or use the remote endpoint. The same service also ships an n8n community node and a Python package, and a browser invoice generator and field inspector.

The free route is 100 requests per IP per month with no key, or 250 a month with a free key. Paid tiers start at $16 a month; the vendor lists Indie at 4,000 requests.

Install

Run in a terminal

claude mcp add --transport http pdfops-mcp https://pdfops.dev/api/mcp

Add to Settings → Connectors → Add custom connector

https://pdfops.dev/api/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdfops-mcp": {
      "url": "https://pdfops.dev/api/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pdfops-mcp": {
      "type": "http",
      "url": "https://pdfops.dev/api/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdfops-mcp": {
      "serverUrl": "https://pdfops.dev/api/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pdfops-mcp": {
      "type": "http",
      "url": "https://pdfops.dev/api/mcp"
    }
  }
}

Tools this server provides (22)

Read directly from the server.

pdf_inspect
List a PDF's AcroForm form fields — names, types, options, current values, per-field maxLength where declared — plus a paste-ready fillTemplate object for pdf_fill and a hasXFA flag (hybrid AcroForm/XFA inputs lose their XFA layer when filled). A PDF with no fillable form returns count 0. Read-only: the PDF is fetched but never modified. Call this FIRST when filling an unfamiliar PDF, since pdf_fi
pdf_fill
Fill AcroForm form fields in a PDF and return the result. Field names must exist in the PDF (use pdf_inspect first). All values are strings; checkboxes take "true"/"false"; dropdown/radio/optionlist values must be one of the field's options; text values must respect the field's maxLength from pdf_inspect. The source PDF is never modified. Returns the filled PDF inline as an application/pdf resourc
pdf_merge
Merge two or more PDFs into one, in the order given, and return the result. JPG and PNG images are accepted among the sources and each becomes one page the size of the image (use pdf_image_to_pdf for A4 or Letter pages, margins and more options); the type is read from the bytes. Sources are read only and never modified. Returns the merged PDF inline as an application/pdf resource. This tool only c
pdf_invoice
Generate a complete, professionally laid-out invoice PDF from structured data — no template needed. Deterministic: the same input produces byte-identical output (safe to re-run). Note: without a paid PDFops key the output carries a small "Generated with pdfops.dev" footer line. Returns the invoice inline as an application/pdf resource. Use this when you have invoice DATA and no document; if you al
pdfops_usage
Check the current PDFops API quota for the configured key: tier, limit, used, remaining, the billing period, and the reset timestamp. Read-only and safe to call before a batch to confirm there is headroom. Uses the API key this connection authenticated with.
pdf_extract_pages
Keep only the listed pages of a PDF, in the order given, and return them as a new PDF. Because order follows the spec, it also reorders pages ("3,1,2") and can duplicate them. Use this to pull a section out of a document; use pdf_delete_pages to remove pages instead, pdf_split for several output files, and pdf_merge to join documents. Returns the result inline as an application/pdf resource; the s
pdf_delete_pages
Remove the listed pages from a PDF and return the remaining pages in their original order. Use this to drop a cover, blank or sensitive pages; use pdf_extract_pages when it is easier to name the pages to keep. Returns the result inline as an application/pdf resource; the source is never modified. Deleting every page fails with no_pages_left.
pdf_rotate
Rotate pages of a PDF clockwise by 90, 180 or 270 degrees (or -90). Rotation adds to each page's existing rotation. Omit pages to rotate every page. Use this to fix sideways scans. Returns the result inline as an application/pdf resource; the source is never modified.
pdf_split
Split one PDF into several PDFs, either by explicit ranges (each comma group becomes one part: "1-2,3-5" gives two parts) or into fixed-size chunks (every=2 on 5 pages gives 1-2, 3-4, 5). Give exactly one of ranges or every. Returns each part inline as an application/pdf resource plus a structured parts list (pages, page_count, bytes, resource_uri). Limited to 100 parts and about 4 MB of total out
pdf_watermark
Stamp a diagonal text watermark on pages of a PDF (default: centered, 45 degrees, grey, 15% opacity). Text is upright and centered for any page size or existing page rotation. Standard Helvetica only: characters outside WinAnsi (e.g. CJK, emoji) fail with unsupported_characters. Use this for DRAFT / CONFIDENTIAL stamps; use pdf_page_numbers for numbering. Returns the result inline as an applicatio
pdf_page_numbers
Print page numbers on a PDF using a format template with {n} (page number) and {total} (page count), e.g. "Page {n} of {total}". Default is "{n} / {total}" at bottom-center, 10 pt. Numbers sit upright for any page size or rotation. Standard Helvetica only (WinAnsi characters). Page i always shows start+i-1 even when pages selects only some pages. Returns the result inline as an application/pdf res
pdf_unlock
Save a PDF without encryption so print/copy/modify restrictions are gone. Works for owner-locked files (empty user password) with no password, and for user-password files when you pass the password. It does NOT crack unknown passwords: a wrong or missing user password fails with encrypted_pdf. A PDF that was not encrypted is returned re-saved, with note "not-encrypted". Returns the result inline a
pdf_protect
Encrypt a PDF with a password. user_password is required to open the result; owner_password lifts the permission restrictions. Give at least one (each 1 to 32 Latin-1 chars). permissions lists what stays ALLOWED from print, copy, modify, annotate, fill-forms (default all, except modify when an owner password is set; an empty list allows none). Restrictions only bind viewers when an owner password
pdf_metadata
Read a PDF's document info: page_count, per-page width/height (points) and rotation, title, author, subject, keywords, creator, producer, creation_date, modification_date (ISO 8601, null when absent), whether it was encrypted, and has_form / form_field_count. Call this to learn a document's size and shape before splitting, rotating or filling. Read-only: the PDF is fetched but never modified.
pdf_set_metadata
Write document info fields (title, author, subject, creator, keywords) into a PDF. Give at least one; an empty string sets an empty value. Unicode is fine. Keywords may be a list or a comma-separated string. The output is saved unencrypted. Use pdf_metadata to read the current values. Returns the result inline as an application/pdf resource; the source is never modified.
pdf_edit
Stamp text and images (logos, signature images, photos) onto specific pages of an existing PDF at exact positions. Coordinates are PDF points measured from the bottom-left corner of the page as the viewer sees it (1 inch = 72 pt; US Letter is 612 x 792), so stamps land upright on any page size or rotation. Text uses standard fonts (WinAnsi characters only: CJK and emoji fail with unsupported_chara
pdf_extract_text
Read the text of a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms), page by page, in reading order, plus any tables found from the text layout as rows of cells. Scanned PDFs (images of pages) have no text layer and come back listed in pages_without_text: OCR is not supported. Set include_lines to also get each line with its position in PDF points from the b
pdf_text_to_pdf
Create a new PDF from Markdown, plain text or a CSV table, with no template and no input PDF. This is NOT HTML-to-PDF: it does not render HTML or CSS, and it has no custom fonts or images (images in Markdown stay literal text). Text is set in the standard Helvetica family, code and monospace text in Courier, on Letter or A4 pages. Markdown supports headings 1-6, bold, italic, inline code, links (p
pdf_find_text
Search a born-digital PDF (one made by software: invoices, statements, reports, contracts, forms) for a word, phrase or pattern and get each hit with its page and box in PDF points from the bottom-left of the page as the viewer sees it, y on the text baseline: the same frame pdf_edit uses, so a hit's x, y, width and height tell you where to stamp. Case-insensitive unless case_sensitive is true. Se
pdf_add_fields
Create standard fillable AcroForm fields in an existing PDF at exact positions: text, multiline text, checkbox, radio group, dropdown and signature box. Coordinates are PDF points measured from the bottom-left corner of the page as the viewer sees it (1 inch = 72 pt; US Letter is 612 x 792), the same frame and 1-based page numbers as pdf_edit; x and y are the field's bottom-left corner and the who
pdf_image_to_pdf
Make a PDF from JPG and PNG images: one image per page, in the order given. Each image is an https:// URL or a data:image/jpeg;base64,… or data:image/png;base64,… URI (this hosted server cannot read local file paths); the type is detected from the bytes, not the name. At most 100 images, each up to 4 MB, 4.5 MB in total. page_size "fit" (default) makes each page the image's own size at 72 dpi (1 p
pdf_add_attachment
Embed one or more files (for example an XML or CSV data file) in a PDF as attachments. Each entry in files has a source (an https:// URL or a data: URI with base64, never a local path) and optional name, mime_type, description (at most 1,000 characters) and relationship (Alternative, Data, Source, Supplement or Unspecified, default Unspecified; the PDF/A-3 AFRelationship value). name is 1-255 char

What it does

Form filling
pdf_fill sets AcroForm fields.
Form inspection
pdf_inspect lists a form's fields.
Page operations
Extract, delete, rotate and split pages.
Watermark and numbers
Stamp text or page numbers.
Protect and unlock
Add or remove password protection.
Invoice generation
Build an invoice PDF from JSON.

Good for

  • Fill a tax or HR form from structured data
  • Merge a pack of documents into one PDF
  • Watermark a draft before sharing
  • Generate an invoice from an order
  • Read or set document metadata

Pricing

Freemium, from $16 a month

Free keyless and free-key tiers; paid from $16/mo

Prices change. Check pdfops.dev before you buy.

Pdfops MCP FAQ

Is there a free tier?

Yes: 100 requests per IP monthly with no key, or 250 with a free key.

What do paid plans cost?

From $16 a month; Indie is $16 for 4,000 requests.

Is output repeatable?

The vendor says the same input gives byte-identical output.

Can I run it locally?

Yes, via npx -y pdfops-mcp, though the API is hosted.

Is Pdfops MCP free?

Pdfops MCP has a free plan, with paid plans for more usage or features. Paid plans start at $16 a month.

How do I add Pdfops MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http pdfops-mcp https://pdfops.dev/api/mcp

What are the best alternatives to Pdfops MCP?

The closest alternatives to Pdfops MCP are ASTra, CARTESIAN ECU, Invoices, SigPen and ConvertAudioToText.

Alternatives to Pdfops MCP

  1. ASTra

    MCP server

    Let agents read, edit, validate and undo Word .docx files with exact operations

    Runs locally
    • 5 tools
    • Freemium
    • Files and documents
  2. CARTESIAN ECU

    MCP server

    Check and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)

    Not checked yet
    • 5 tools
    • Remote
    • Paid
    • Files and documents
  3. Invoices

    MCP server

    MCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files

    • 4 tools
    • Remote
    • Paid
    • Files and documents
  4. SigPen

    MCP server

    MCP server that drafts e-signature documents while you approve every send

    Not checked yet
    • 13 tools
    • Remote
    • Freemium
    • Files and documents
  5. Transcribe audio and video links from Claude or ChatGPT and read the results

    Not checked yet
    • 5 tools
    • Remote
    • Freemium
    • Design and media
  6. WhoScribe

    MCP server

    Search and read your WhoScribe audio and video transcripts from ChatGPT, read-only

    Not checked yet
    • Remote
    • Freemium
    • Design and media