Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

dev.pdfops/pdfops-mcp

NPM · PDFOPS-MCP · 2 COMPONENTS

PDF tools for AI agents: fill, merge, edit, read text and tables, create, protect and invoice PDFs.

0 this week 92 Trust /100

Last scanned (9 hours ago)

Scores higher than 91% of npm servers

Category Documents and Files

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security98
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 30 of 93 dependencies flagged as unhealthy. View diagnostics → Partial
Provenance & Transparency97
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Cryptographically verified build provenance (signed, bound to pdfops/pdfops-mcp). View diagnostics → Pass
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 0 days ago).Pass
  • Security-disclosure policy not yet verified: we couldn't inspect the source repository.Unverified
Schema Quality & AI Usability61
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 9871 tokens (~429/item across 23 items; 23 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
  • No destabilizing schema changes in the last 30 days.Pass
Tool Coverage99
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 97% of tool parameters carry a description.Partial
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Tool Safety100
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • All 2 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.Pass
  • An AI judge read all 23 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
What we tested

Checks we ran (15)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Checks we could not complete (1)

These are gaps on our side, not findings about this package. We only credit what we can confirm, so a category made up entirely of them scores 0.

  • Security disclosure in Provenance & TransparencySecurity-disclosure policy not yet verified: we couldn't inspect the source repository.

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 22 Nov 26 0
    • Schema quality: 298 → 429 ▼ functional
    • Security disclosure: fail → unverified ▼ functional
    • Package version: 0.4.5 → 0.5.0 functional
  • 19 Nov 26 0
    • Stability: 0.97 → pass security
  • 18 Nov 26 0
    • Stability: pass → 0.97 functional
  • 13 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 12 Nov 26 −15
    • Malware scan: pass → unverified ▼ security
    • Stability: 0.97 → pass security
    • Package version: 0.4.3 → 0.4.5 functional
    • Package version: 0.4.3 → 0.4.4 functional
  • 11 Nov 26 +11
    • CVE-2023-54404 no longer affects this package ▲ security
    • Known CVEs: unverified → pass ▲ security
    • Dependency health: unverified → 0.86 ▲ functional
  • 10 Nov 26 −5
    • Stability: 0.90 → unverified ▼ security
    • Known CVEs: fail → unverified ▼ security
    • Tool safety: pass → unverified ▼ security
    • Tool coverage: 100 → unverified ▼ functional
    • Dependency health: 0.86 → unverified ▼ functional
    • Capabilities: pass → unverified ▼ functional
    • Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
    • Package version: 0.4.2 → 0.4.3 functional
  • 9 Nov 26 +15
    • Tool safety: pass → unverified ▼ security
    • Stability: 0.87 → unverified ▼ security
    • Malware scan: unverified → pass ▲ security
    • Schema quality: 257 → 298 ▼ functional
    • Capabilities: pass → unverified ▼ functional
    • Tool coverage: 100 → unverified ▼ functional
    • Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
    • Package version: 0.2.0 → 0.4.2 functional
    • Package version: 0.4.0 → 0.4.2 functional
    • Package version: 0.4.0 → 0.4.1 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 22 Nov 2026 · Analysed npm/pdfops-mcp@0.5.0

Provenance Verified

A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.

Result Verified
Ecosystem npm
Reason Verified
Discovered via Registry attestation endpoint
Source repo pdfops/pdfops-mcp
Certificate issuer https://token.actions.githubusercontent.com
Certificate SAN https://github.com/pdfops/pdfops-mcp/.github/workflows/publish.yml@refs/tags/v0.5.0
Rekor log index 4035682605
Predicate type SLSA build provenance https://slsa.dev/provenance/v1
Subject digest sha512:1e896c3fc9fb12132255dce936439baef3a748e2133d3464103c2285f4ad6437ef596433ecd29895de0b801b23c5f2454d15b2969d8ee03e294a106ce

Background: How many MCP packages publish verified provenance →

Dependencies 93 packages
Packages resolved 93
Stale 30
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 23 exposed · ~9,871 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
pdf_add_attachment ~616

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 (a local path, an https:// URL or a data: URI with base64) 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). A local path must end in .xml, .csv, .json, .txt, .md, .html, .xlsx, .pdf, .png, .jpg or .jpeg and lie inside the allowed directories (PDFOPS_ROOT, default the working directory). name is 1-255 characters and at most 255 UTF-8 bytes with no / or backslash or control characters, and defaults to the file name of a path or the last part of an https:// URL path (a data: URI needs a name). mime_type looks like text/xml, with no parameters and no #. At most 10 files and 3 MB in total per call, and at most 200 attachments in the finished PDF. A PDF whose list of embedded files has over 2,000 entries (name_tree_too_large) or an unreadable existing name (attachments_too_complex) is refused. A name already used by an attachment in the PDF (as a key or as an entry's /UF or /F), or twice in the call, is refused. Existing content, including any existing attachments, is kept. Each file keeps its full name; the lookup key for qpdf --show-attachment is plain ASCII and is returned in the result as keys. Unknown keys are rejected. The whole file is saved again, so an existing digital signature on the PDF stops validating. Returns the result written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
filesarrayyesFiles to embed. Nothing is added unless every entry is valid.
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
keysarray–One entry per added file, in order: the ASCII key for qpdf --show-attachment (qpdf --list-attachments shows it)
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_add_fields ~780

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 whole rectangle must lie inside the page (each side at least 4 pt). Every entry needs type, name and page; every type except radio also needs x, y, width and height; radio and dropdown need options. Unknown keys are rejected. A radio entry is one group whose options each carry their own value, x, y, width and height. name is 1-200 characters with no dot, unique in the request and not already a field name in the PDF (a name that equals the first part of an existing dotted name is also taken). Text takes multiline, max_length, default and font_size; checkbox takes checked; dropdown takes options (strings), default and font_size. All entries also take required, read_only, border (default true) and background (default false). font_size is a number from 1 to 200 or "auto". If omitted, text, multiline text and dropdown fields get a fixed size of min(12 pt, the largest size at which one line fits the field height), at least 4 pt, so they draw predictably when filled; a value longer than the box is then clipped, not shrunk. "auto" stores size 0, and pdf_fill then sizes the text to the box when the blank field is first filled (a short value is enlarged, a long one shrunk) and keeps that size, so a later, longer value is clipped: for predictable text omit font_size or set a number. Defaults and dropdown options use standard fonts (WinAnsi characters only: euro sign and curly quotes work, Polish L-stroke and CJK fail). The signature type creates an EMPTY signature field for a signing tool to use: nothing is signed, it is not an e-signature. At most 200 entries and 200 widgets per call,…

NameTypeReqDescription
fieldsarrayyesFields to create. Nothing is added unless every entry is valid. Required keys: every entry type, name, page; text, checkbox, dropdown and signature also x, y, width, height; radio and dropdown also o…
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted
warningstring–Present as xfa-layer-dropped when a hybrid AcroForm/XFA input lost its XFA layer

No examples provided.

pdf_delete_pages ~307

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified. Deleting every page fails with no_pages_left.

NameTypeReqDescription
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
pagesstringyes1-based pages to REMOVE, e.g. "2,4-6,9-"
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_edit ~494

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_characters) and can wrap to max_width. Images are PNG or JPEG, up to 2 MB each and 10 distinct images per call (the PDF and all images together must stay under 4.5 MB), given as a local path, an https:// URL or a data:image/png;base64,... URI. Barcodes (QR, Data Matrix, PDF417, Aztec, Code 128, Code 39, EAN-13/8, UPC-A, ITF-14, Interleaved 2 of 5, GS1-128) are generated from a value and drawn as vector paths, so they scan at any print size (up to 25 per call). Use pdf_fill for fillable form fields and pdf_watermark for a diagonal stamp on every page. Returns the result written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
itemsarrayyesStamps to draw, in order (later items draw on top).
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_extract_pages ~353

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified. Fails with invalid_pages if a page is out of range.

NameTypeReqDescription
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
pagesstringyes1-based page spec, e.g. "1-3,5,8-" (open-ended range runs to the last page)
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_extract_text ~632

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 bottom-left of the page as the viewer sees it, the same frame pdf_edit uses, so you can stamp text next to something you found. Up to 200 pages per call; pass pages to read a large document in parts. To search for specific text instead, use pdf_find_text. With tables_format xlsx the tables come back as one Excel workbook instead (one sheet per table, all cells text): written to output_path (a .xlsx file) when given, otherwise returned inline as an application/vnd.openxmlformats-officedocument.spreadsheetml.sheet resource (a workbook over 7 MB is never returned inline: pass output_path). The source PDF is never modified; output_path is only written with tables_format xlsx.

NameTypeReqDescription
include_linesboolean–Also return every line of text with x, y, width and font size in points. Default false (smaller output).
output_pathstring–Only with tables_format xlsx: path of a .xlsx file to write the workbook to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit w…
pagesstring–Pages to read, 1-based: "1-3,5,8-". Default: all pages.
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
tables_formatstring–csv adds a csv string (RFC 4180, CRLF line ends) to each table next to rows. xlsx instead returns one Excel workbook, one sheet per table ("Page 3 Table 1"), with a short summary (no text, lines or r…
NameTypeReqDescription
bytesinteger–Only with tables_format=xlsx: size of the workbook
cells_truncatedboolean–Only with tables_format=xlsx: a cell over 32,767 characters was cut
output_pathstring–Only with tables_format=xlsx: absolute path written, when output_path was supplied
page_countinteger–Pages in the document
pagesarray––
pages_without_textarray––
resource_uristring–Only with tables_format=xlsx: where the workbook resource is attached, when output_path was omitted
truncatedboolean––
truncated_byarray–Only with tables_format=xlsx and truncated: which cap stopped the read or cut the workbook

No examples provided.

pdf_fill ~378

Fill AcroForm form fields in a PDF and save or 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 written to output_path, or inline as an application/pdf resource when output_path is omitted; an existing file at output_path is overwritten. Owner-locked PDFs (empty user password, common for government blanks) fill without a password; a user-password PDF needs the password parameter, otherwise it is rejected with encrypted_pdf. A rejected fill writes no file at all.

NameTypeReqDescription
fieldsobjectyesField name → string value (from pdf_inspect's fillTemplate)
flattenboolean–Bake values into page content and drop the AcroForm so fields are no longer editable
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesTemplate PDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_find_text ~509

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. Set regex to treat query as a regular expression from a safe subset (literals, classes, dot, anchors, word boundaries, groups, alternation, quantifiers including lazy ones); backreferences, lookahead, lookbehind, named groups, property escapes and inline flags are rejected. A match never spans lines. Scanned PDFs have no text layer: their pages are listed in pages_without_text (no OCR). While next_page is not null, call again with pages set to next_page followed by a dash (for example 4-) to continue with no gaps or repeated hits. If truncated is true but next_page is null, hits on a page listed in pages_skipped beyond max_hits cannot be retrieved: raise max_hits or narrow the query. Read-only: the source is never modified.

NameTypeReqDescription
case_sensitiveboolean–Default false: matching ignores case.
max_hitsinteger–Stop once more hits than this exist. Default 100.
pagesstring–Pages to search, 1-based: "1-3,5,8-". Default: all pages. At most 200 pages per call.
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
querystringyesText to find, or a pattern when regex is true. At most 200 characters.
regexboolean–Treat query as a regular expression (the supported subset). Default false.
whole_wordboolean–Only report matches with no letter, digit, underscore or combining mark directly before or after. Default false.
NameTypeReqDescription
countintegeryesHits returned
hitsarrayyes–
lines_skippedinteger––
next_page–yesFirst page not fully searched, or null when finished
pages_scannedintegeryes–
pages_skippedarray––
pages_without_textarrayyes–
truncatedbooleanyesThe scan stopped before every selected page was searched; continue from next_page while it is not null; null with truncated means hits beyond max_hits on a page in pages_skipped were dropped

No examples provided.

pdf_html_to_pdf ~679

Render an HTML string to a PDF with a headless browser, so layout, CSS (flexbox, grid, print styles), images and web fonts come out as in a browser print. It takes HTML text only: there is no URL input, and JavaScript is switched off, so scripts do not run and pages that build themselves with JavaScript render empty. External resources (images, stylesheets, fonts) load only over https from public hosts; anything else (http, file, private or internal addresses, redirects to them) is blocked and skipped, and the PDF is still made. Data URIs work and are the safest way to include images. Letter or A4, portrait or landscape, margin in points (default 36), backgrounds printed by default, optional scale. html is capped at 1 MB, the document at 50 pages and 16 MB, external resources at 50 requests and 40 MB, and rendering at 15 seconds. Frames, iframes, objects, embeds, audio and video are not rendered, and an inline or fetched image is decoded and checked first. Common fonts (Helvetica, Arial, Times, Courier and generic families) render as Liberation faces, metric-compatible with the originals. Once the renderer is reached every outcome costs 5 of your monthly request quota, not 1, failures included; a cheap refusal before a browser starts (for example an inline image refused: image_too_large or unsupported_image, with the image named in the message) costs 1; only input validation errors and a busy or unreachable renderer cost nothing. Images: 16 megapixels at most each (96 in total), PNG, JPEG, GIF, WebP or SVG (simplified: scripts, style sheets, filters, masks, embedded images and links are removed; inline style colours are kept); AVIF, BMP, ICO, TIFF, animated PNG and colour-bitmap fonts are not supported, and an image in an unsupported format or over a limit fails the request (a missing image, such as a 404 or a tracking pixel, is skipped). For Markdown, text or CSV with no HTML use pdf_text_to_pdf; to build an invoice from data use pdf_invoice. Returns the result wr…

NameTypeReqDescription
htmlstringyesThe document as HTML text, up to 1 MB of UTF-8. A full document or a fragment.
landscapeboolean–Landscape orientation. Default false.
marginnumber–Margin on every side in points, 0-144. Default 36.
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
page_sizestring–Default letter.
print_backgroundboolean–Print background colors and images. Default true.
scalenumber–Page content scale, 0.1-2. Default 1.
NameTypeReqDescription
blocked_requestsinteger–External requests the page made that were blocked by the network policy
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
pagesinteger–Pages in the PDF
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_image_to_pdf ~647

Make a PDF from JPG and PNG images: one image per page, in the order given. Each image is a local path (.png, .jpg, .jpeg), an https:// URL or a data:image/jpeg;base64,… or data:image/png;base64,… URI; 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 px = 1 pt; pages longer than 5,000 pt on a side are scaled down, tiny images are enlarged to a 3 pt minimum); "a4" or "letter" put the image on a standard page, centred, shrunk to fit inside the margin and never enlarged. orientation (auto, portrait, landscape; default auto picks per image) applies to a4 and letter only. margin is 0-200 pt (default 0 for fit, where the page grows by the margin on every side; 36 for a4 and letter). A JPEG's EXIF orientation is applied, so phone photos come out upright. PNG: 8-bit and 16-bit, palette, grey, interlaced and transparent files work (transparency is kept); animated PNGs, other formats (GIF, WebP, HEIC, TIFF, SVG) and PDFs are rejected. JPEG: baseline and progressive, grey, RGB and Adobe-style CMYK. Very large images fail with image_too_large (PNG over 10 megapixels or a memory estimate; JPEG over 250 megapixels), and many large PNGs in one call with images_too_large_together. Deterministic: the same images give byte-identical output. To join images with existing PDFs use pdf_merge, which also accepts images. Returns the result written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
image_pathsarrayyesIn order, one page each: a local path (.png, .jpg, .jpeg) inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:image/jpeg;base64,… / data:image/png;…
marginnumber–Points, 0-200. Default 0 for fit, 36 for a4 and letter.
orientationstring–a4 and letter only; auto (default) picks portrait or landscape per image.
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
page_sizestring–fit (default): page = image size. a4 or letter: standard page, image centred and shrunk to fit.
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_inspect ~219

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 or read but never modified. Call this FIRST when filling an unfamiliar PDF, since pdf_fill rejects unknown field names and over-length values.

NameTypeReqDescription
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
countintegeryesNumber of form fields found; 0 when the PDF has no fillable form
fieldsarrayyesOne entry per form field, in document order
fillTemplateobjectyesField name to empty-or-current value, ready to edit and pass to pdf_fill
hasXFAbooleanyesTrue for hybrid AcroForm/XFA documents, whose XFA layer is dropped when filled
truncatedbooleanyesTrue when the form exceeded an API enumeration cap; fields is then a prefix, not the full list

No examples provided.

pdf_invoice ~530

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 written to output_path, or inline as an application/pdf resource when output_path is omitted; an existing file at output_path is overwritten. Use this when you have invoice DATA and no document; if you already have an invoice PDF or a fillable template to populate, use pdf_fill instead. Set invoice.e_invoice to "factur-x" to produce an e-invoice instead: a PDF/A-3 file with the invoice data embedded as factur-x.xml (UN/CEFACT Cross Industry Invoice, profile EN 16931, also called COMFORT). Several more fields then become required, and a missing one fails with einvoice_fields_required naming every missing field: invoice_number, date, currency (no default), due or payment_terms, from.country and to.country (ISO 3166-1 alpha-2 codes), from.vat_id (or from.tax_id with from.registration_id), tax_category when tax_rate is 0, and a UN/ECE Recommendation 20 unit code on every item. Amounts in the XML and on the page come from the same exact decimal arithmetic: each line is rounded to 2 decimals, VAT is computed once on the summed basis. On that path text is limited to Latin letters, Latin Extended-A, the euro sign and common punctuation (other characters fail with unrenderable_text); leading and trailing whitespace is trimmed, over-long or control-character text is refused with a 400, and long text wraps onto further lines or pages on the page and is carried in full in the XML. Per-item tax fields and other unknown fields are refused, and a buyer tax_id is refused (use to.vat_id). Checked in testing with the Mustang validator 2.26.0 (PDF/A-3 via veraPDF, XSD, EN 16931 schematron); this is not a statement of legal compliance, and XRechnung and Peppol output are not produced.

NameTypeReqDescription
invoiceobjectyesInvoice data
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_merge ~315

Merge two or more PDFs into one, in the order given, and save or return the result. Source files are read only and never modified; an existing file at output_path is overwritten. Returns the merged PDF written to output_path, or inline as an application/pdf resource when output_path is omitted. This tool only concatenates whole documents: it does not reorder, rotate or delete pages within them, and it does not fill forms — use pdf_fill for a fillable form and pdf_invoice to build a document from data. An unreadable or rejected input fails with an error and writes no file, so a partial merge is never left behind.

NameTypeReqDescription
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it). Applies to every input.
pdf_pathsarrayyesIn order, each a PDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or d…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_metadata ~204

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 or read but never modified.

NameTypeReqDescription
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
authorstring|nullyes–
creation_datestring|nullyes–
creatorstring|nullyes–
encryptedbooleanyes–
form_field_countintegeryes–
form_field_count_cappedboolean–True when the form-field count stopped at the 2,000 cap, so the real number may be higher
has_formbooleanyes–
keywordsstring|nullyes–
modification_datestring|nullyes–
page_countintegeryes–
pagesarrayyes–
producerstring|nullyes–
subjectstring|nullyes–
titlestring|nullyes–

No examples provided.

pdf_page_numbers ~423

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
formatstring–Template with {n} and {total}, default "{n} / {total}"
marginnumber–Distance in points from the page edge, default 24
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
pagesstring–1-based page spec such as "1-3,5"; default all pages
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
positionstring–Default bottom-center
sizenumber–Font size in points, default 10
startinteger–Number shown on page 1, default 1
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_protect ~370

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 is set. Not byte-deterministic (random salts). Returns the result written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
owner_passwordstring–Password that lifts the restrictions
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
permissionsarray–Actions to ALLOW; omit for the default, [] for none
user_passwordstring–Password required to open the output
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_rotate ~305

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
degrees–yesClockwise rotation to add
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
pagesstring–1-based page spec such as "1-3,5"; default all pages
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_set_metadata ~331

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
authorstring––
creatorstring––
keywords––Comma-separated string or list of keywords
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
subjectstring––
titlestring––
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_split ~401

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. With output_dir the parts are written there as part-1.pdf, part-2.pdf, …; otherwise each part comes back inline as an application/pdf resource. Either way you also get a structured parts list (pages, page_count, bytes, and output_path or resource_uri). Existing part-N.pdf files with those names are overwritten, and part-N.pdf files from earlier runs in that directory are left as they are; the source is never modified. Limited to 100 parts and about 4 MB of total output; use pdf_extract_pages for a single range.

NameTypeReqDescription
everyinteger–Chunk size in pages; the last part may be shorter
output_dirstring–Path of an existing directory inside the allowed directories (PDFOPS_ROOT, default the working directory) to write part-1.pdf, part-2.pdf, … into. Omit when running remotely: the parts are then retur…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
rangesstring–1-based page spec; each comma group becomes one part, e.g. "1-2,3-5"
NameTypeReqDescription
countintegeryesNumber of parts produced
partsarrayyes–

No examples provided.

pdf_text_to_pdf ~591

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 (printed as text plus the URL; http(s) and mailto links are also clickable), fenced code blocks, bullet and numbered lists, one-level blockquotes, horizontal rules, pipe tables (header shaded and repeated per page; column alignment ignored) and \pagebreak; anything else prints as typed. format text keeps spaces and line breaks exactly. format csv draws a table whose first row is the header (up to 20 columns, 10,000 rows, 100,000 cells). content is capped at 512 KiB and the output at 200 pages. WinAnsi characters only (English and Western European letters and common punctuation): emoji, Cyrillic, Greek and CJK fail with unsupported_characters, naming the character and its line and column. Very large tables or heavy inline formatting fail with content_too_complex. Deterministic: the same input gives byte-identical output, and the PDF carries no PDFops footer. To add text to an existing PDF use pdf_edit; to build an invoice from data use pdf_invoice. Returns the result written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
contentstringyesThe document: Markdown (default), plain text or CSV, up to 512 KiB of UTF-8.
font_sizenumber–Body text size in points, 6-36. Default 11.
formatstring–How to read content. Default markdown.
marginnumber–Page margin in points, 18-144. Default 54.
monospaceboolean–Set the text in Courier. Only used with format text. Default false.
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
page_numbersboolean–Print "Page n of N" at the bottom of every page. Default false.
page_sizestring–Default letter.
titlestring–PDF Title metadata (not printed on the page), up to 200 characters.
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_unlock ~304

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
notestring–Present as "not-encrypted" when the input had no encryption
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdf_watermark ~423

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 written to output_path, or inline as an application/pdf resource when output_path is omitted (results over 7 MB are never returned inline: pass output_path); an existing file at output_path is overwritten. The source is never modified.

NameTypeReqDescription
colorstring–Hex #rgb or #rrggbb, default #808080
opacitynumber–Default 0.15
output_pathstring–Path of a .pdf file to write the result to, inside the allowed directories (PDFOPS_ROOT, default the working directory); an existing file there is overwritten. Omit when running remotely: the PDF is…
pagesstring–1-based page spec such as "1-3,5"; default all pages
passwordstring–Password to open the input, only needed for a user-password PDF (owner-locked files with an empty user password open without it).
pdf_pathstringyesPDF source: a path to a .pdf file inside the allowed directories (PDFOPS_ROOT, default the working directory), an https:// URL, or a data:application/pdf;base64,… URI. Use a URL or data URI when this…
positionstring–Default center
rotationnumber–Degrees counter-clockwise as the viewer sees it, default 45
sizenumber–Font size in points, default 48
textstringyesWatermark text, WinAnsi characters only
NameTypeReqDescription
bytesintegeryesSize of the produced PDF in bytes
output_pathstring–Absolute path written, when output_path was supplied
resource_uristring–pdfops:// uri of the inline application/pdf resource, when output_path was omitted

No examples provided.

pdfops_usage ~60

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. Requires PDFOPS_API_KEY.

Input schema present but exposes no named parameters.

NameTypeReqDescription
limitintegeryesCalls allowed in the current period
periodstringyesBilling period the counts belong to, YYYY-MM
remainingintegeryes–
resets_atstringyesISO 8601 timestamp when used resets to 0
tierstringyesPlan name, e.g. free
usedintegeryes–

No examples provided.

Install

How do I install the dev.pdfops/pdfops-mcp server?

dev.pdfops/pdfops-mcp runs locally as an npm package, launched with npx -y pdfops-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · pdfops-mcp

# add to Claude Code
claude mcp add dev-pdfops-pdfops-mcp -- npx -y pdfops-mcp
Common questions

What is the dev.pdfops/pdfops-mcp server?

dev.pdfops/pdfops-mcp is listed in the public MCP registry as dev.pdfops/pdfops-mcp. PDF tools for AI agents: fill, merge, edit, read text and tables, create, protect and invoice PDFs. This page covers its npm package (pdfops-mcp).

Is the dev.pdfops/pdfops-mcp server safe to use?

dev.pdfops/pdfops-mcp scores 92 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 22 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the dev.pdfops/pdfops-mcp server expose?

dev.pdfops/pdfops-mcp exposes 23 tools: pdf_inspect, pdf_fill, pdf_merge, pdf_invoice, pdfops_usage, and 18 more. Their descriptions and schemas cost roughly 9,871 tokens of context every time the server is loaded.

Is the dev.pdfops/pdfops-mcp server still maintained?

dev.pdfops/pdfops-mcp is still listed as active in the MCP registry. We last reached this channel on 22 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the dev.pdfops/pdfops-mcp server under?

dev.pdfops/pdfops-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the dev.pdfops/pdfops-mcp server?

VerifyMCP ran 15 checks on dev.pdfops/pdfops-mcp, covering Malware scan, Known CVEs, Install scripts, Dependency health and 11 more. One item could not be completed, a gap on our side rather than a finding about dev.pdfops/pdfops-mcp: Security disclosure. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.