Pdfops MCP
Fill, merge, split, watermark and protect PDFs through a hosted deterministic API
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/mcpAdd to Settings → Connectors → Add custom connector
https://pdfops.dev/api/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"pdfops-mcp": {
"url": "https://pdfops.dev/api/mcp"
}
}
}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

ASTra
MCP serverLet agents read, edit, validate and undo Word .docx files with exact operations
Runs locally- 5 tools
- Freemium
- Files and documents

CARTESIAN ECU
MCP serverCheck and repair ECU and TCU flash-file checksums from Claude (Ultimate plan)
Not checked yet- 5 tools
- Remote
- Paid
- Files and documents
Invoices
MCP serverMCP server that reads supplier invoices and returns data plus DATEV, CSV or Excel files
- 4 tools
- Remote
- Paid
- Files and documents

SigPen
MCP serverMCP server that drafts e-signature documents while you approve every send
Not checked yet- 13 tools
- Remote
- Freemium
- Files and documents

ConvertAudioToText
MCP serverTranscribe audio and video links from Claude or ChatGPT and read the results
Not checked yet- 5 tools
- Remote
- Freemium
- Design and media

WhoScribe
MCP serverSearch and read your WhoScribe audio and video transcripts from ChatGPT, read-only
Not checked yet- Remote
- Freemium
- Design and media