io.github.beepboop2025/pdf-toolkit-mcp

NPM · PDF-SUITE-MCP · SCANNED AUG 3

37 tools to read, create, merge, split, watermark, fill, redact & search PDFs. Local, no API key.

Available components

+25 this week 65 65 Trust /100

Trust breakdown (6 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 →

Supply Chain Security87

No malware found by supply-chain analysis.Pass
Only part of the dependency tree could be resolved (101 of 105), so this covers what we could see, not the whole tree.Partial
No install/post-install scripts declared.Pass
Only part of the dependency tree could be resolved (101 of 105), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency19

Repository check failed: the declared repository URL redirects; it must resolve directly. See how to fix → View diagnostics → Fail
Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
Clear OSI-approved license (MIT).Pass
Actively maintained (last published 21 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability80

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 3965 tokens (~107/item across 37 items; 37 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 Management27

Stability observed for 8 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial

Tool Coverage100

100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
100% of tool parameters carry a description.Pass

Capabilities100

Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · pdf-suite-mcp

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add beepboop2025-pdf-toolkit-mcp -- npx -y pdf-suite-mcp

# add to Codex CLI

codex mcp add beepboop2025-pdf-toolkit-mcp -- npx -y pdf-suite-mcp

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "beepboop2025-pdf-toolkit-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "pdf-suite-mcp"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add beepboop2025-pdf-toolkit-mcp --command npx --arg -y --arg pdf-suite-mcp

# ~/.hermes/config.yaml

mcp_servers:
  beepboop2025-pdf-toolkit-mcp:
    command: "npx"
    args: ["-y", "pdf-suite-mcp"]

// mcp.json

{
  "mcpServers": {
    "beepboop2025-pdf-toolkit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "pdf-suite-mcp"
      ]
    }
  }
}

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.

3 Aug 26 +50
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- MCP protocol: unverified → pass ▲ functional
- Stability: unverified → 0.27 ▲ functional
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- Licence: MIT functional
2 Aug 26 −39
- Install scripts: pass → unverified ▼ security
- Provenance: fail → unverified ▼ security
- Stability: Stability not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. security
- Capabilities: pass → unverified ▼ functional
- License: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Maintenance: pass → unverified ▼ functional
- Licence: MIT functional
1 Aug 26 −10
- Known CVEs: partial → unverified ▼ security
- Dependency health: partial → unverified ▼ functional
31 Jul 26 +54
- We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
30 Jul 26 −51
- Known CVEs: partial → unverified ▼ security
- Malware scan: pass → unverified ▼ security
- Tool coverage: 100 → unverified ▼ functional
- First check of Schema quality: unverified functional
29 Jul 26 +21
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Maintenance: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- License: unverified → pass ▲ functional
- Licence: MIT functional
27 Jul 26 40

First indexed and scored.

Show 2 earlier entries Hide earlier entries

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 3 Aug 2026 · Analysed npm/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 101 packages

101 packages in the resolved dependency tree · 101 deprecated · 32 stale.

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools — 37 exposed · ~3,965 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.

Tool Tokens

pdf_add_image ~164

Add an image (PNG/JPG) at a position on a page. Aspect ratio is preserved when only width or height is given.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
height	number	—	Height in points (scales proportionally if width omitted)
imagePath	string	yes	Image file (PNG or JPG)
opacity	number	—	Opacity 0-1 (default: 1)
outputPath	string	yes	Output path
page	number	yes	Page number (1-indexed)
width	number	—	Width in points (scales proportionally if height omitted)
x	number	yes	X from left edge (points)
y	number	yes	Y from bottom edge (points)

No output schema declared.

No examples provided.

pdf_add_text ~186

Add text at a specific position on a PDF page. Supports multi-line text (use \n). Coordinates are in points from bottom-left.

Input Output Examples

Name	Type	Req	Description
color	string	—	Color (default: black)
filePath	string	yes	PDF file path
font	string	—	Font (default: Helvetica)
fontSize	number	—	Font size (default: 12)
lineSpacing	number	—	Line spacing multiplier for multi-line text (default: 1.4)
outputPath	string	yes	Output path
page	number	yes	Page number (1-indexed)
text	string	yes	Text to add. Use \n for multiple lines.
x	number	yes	X from left edge (points)
y	number	yes	Y from bottom edge (points). For multi-line, this is the top line position.

No output schema declared.

No examples provided.

pdf_attach ~81

Embed one or more files as attachments inside a PDF. Attached files travel with the PDF and can be extracted by PDF readers. Useful for bundling source data, receipts, supporting documents, etc.

Input Output Examples

Name	Type	Req	Description
attachments	array	yes	Files to attach
filePath	string	yes	PDF file to attach files to
outputPath	string	yes	Output path

No output schema declared.

No examples provided.

pdf_blank_pages ~105

Insert blank pages into a PDF at specified positions. Useful for adding separator pages or ensuring chapters start on odd pages.

Input Output Examples

Name	Type	Req	Description
afterPages	array	yes	Insert a blank page after each of these page numbers (1-indexed). Use 0 to add at the beginning.
filePath	string	yes	PDF file path
outputPath	string	yes	Output path
pageSize	string	—	"MatchPrevious" matches the size of the preceding page (default)

No output schema declared.

No examples provided.

pdf_compare ~67

Compare the text content of two PDFs page by page. Reports which pages are identical, which differ, and shows a summary of differences. Useful for verifying document versions.

Input Output Examples

Name	Type	Req	Description
filePath1	string	yes	First PDF file path
filePath2	string	yes	Second PDF file path

No output schema declared.

No examples provided.

pdf_compress ~114

Attempt to reduce PDF file size by rebuilding the document structure. Copies all pages to a fresh PDF (dropping orphaned objects), and optionally strips metadata. Results vary — works best on PDFs with accumulated edits or orphaned data.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
flattenForms	boolean	—	Flatten form fields to reduce size (default: false)
outputPath	string	yes	Output path
stripMetadata	boolean	—	Remove title, author, subject, keywords (default: false)

No output schema declared.

No examples provided.

pdf_create ~196

Create a new PDF from text. Supports auto word-wrapping, pagination, bold/italic, configurable fonts, margins, page sizes. Lines starting with "# " render as bold headings.

Input Output Examples

Name	Type	Req	Description
author	string	—	Document author (metadata)
content	string	yes	Text content. Use \n for line breaks. Lines starting with "# " become bold headings. Text auto-wraps and paginates.
font	string	—	Font family (default: Helvetica)
fontSize	number	—	Font size in points (default: 12)
lineSpacing	number	—	Line spacing multiplier (default: 1.4)
margin	number	—	Page margin in points (default: 50)
outputPath	string	yes	Path where the PDF will be saved
pageSize	string	—	Page size (default: A4)
title	string	—	Document title (metadata)

No output schema declared.

No examples provided.

pdf_crop ~134

Crop pages by setting the visible area (crop box). Trims margins or isolates a region. Coordinates are in points from bottom-left.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
height	number	yes	Height of crop area in points
outputPath	string	yes	Output path
pages	array	—	Pages to crop (1-indexed). Omit for all pages.
width	number	yes	Width of crop area in points
x	number	yes	Left edge of crop area (points from left)
y	number	yes	Bottom edge of crop area (points from bottom)

No output schema declared.

No examples provided.

pdf_decrypt ~81

Remove password protection from an encrypted PDF. Requires the correct password. Saves an unencrypted copy that can be opened without a password.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Path to the encrypted PDF file
outputPath	string	yes	Path where the decrypted (unprotected) PDF will be saved
password	string	yes	Password to unlock the PDF

No output schema declared.

No examples provided.

pdf_delete_pages ~52

Remove specific pages from a PDF.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
outputPath	string	yes	Output path
pages	array	yes	Page numbers to delete (1-indexed)

No output schema declared.

No examples provided.

pdf_draw ~71

Draw shapes on PDF pages: rectangles (filled or outlined), lines, and circles/ellipses. Useful for annotations, diagrams, or marking up documents.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
outputPath	string	yes	Output path
shapes	array	yes	Shapes to draw

No output schema declared.

No examples provided.

pdf_extract_pages ~53

Extract specific pages into a new PDF.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Source PDF path
outputPath	string	yes	Output path
pages	array	yes	Page numbers to extract (1-indexed)

No output schema declared.

No examples provided.

pdf_flatten ~59

Flatten a PDF — converts all form fields and annotations into static page content. Fields become non-editable. Useful for finalizing documents before distribution.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
outputPath	string	yes	Output path

No output schema declared.

No examples provided.

pdf_form_fill ~168

Fill form fields in a PDF by name. Supports text fields, checkboxes ("true"/"false"), dropdowns, option lists, and radio groups. Use pdf_form_read first to discover field names and types. Optionally flatten the form to make it non-editable.

Input Output Examples

Name	Type	Req	Description
fields	object	yes	Object mapping field names to values. For checkboxes: "true" or "false". For dropdowns/radio: the option value string.
filePath	string	yes	Path to the PDF file with form fields
flatten	boolean	—	If true, flattens the form making fields non-editable (default: false)
outputPath	string	yes	Path where the filled PDF will be saved
password	string	—	Password if the PDF is encrypted

No output schema declared.

No examples provided.

pdf_form_read ~85

Read all form fields from a PDF. Returns each field's name, type (Text, CheckBox, Dropdown, OptionList, RadioGroup), current value, and available options. Use this before pdf_form_fill to discover field names.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Path to the PDF file with form fields
password	string	—	Password if the PDF is encrypted

No output schema declared.

No examples provided.

pdf_header_footer ~145

Add headers and/or footers with dynamic placeholders: {page} for current page, {pages} for total.

Input Output Examples

Name	Type	Req	Description
align	string	—	Alignment (default: center)
color	string	—	Color (default: dark gray)
filePath	string	yes	PDF file path
fontSize	number	—	Font size (default: 9)
footer	string	—	Footer text. Use {page} and {pages} placeholders.
header	string	—	Header text. Use {page} and {pages} placeholders.
margin	number	—	Edge distance (default: 30)
outputPath	string	yes	Output path

No output schema declared.

No examples provided.

pdf_highlight ~79

Add translucent highlight boxes over regions on PDF pages — like using a highlighter pen. Great for marking important sections.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
highlights	array	yes	Regions to highlight
opacity	number	—	Highlight opacity (default: 0.35)
outputPath	string	yes	Output path

No output schema declared.

No examples provided.

pdf_images_to_pdf ~111

Convert one or more images (PNG/JPG) into a PDF. Each image becomes a page, scaled to fit while maintaining aspect ratio.

Input Output Examples

Name	Type	Req	Description
imagePaths	array	yes	Array of image file paths (PNG or JPG)
margin	number	—	Margin around image in points (default: 0)
outputPath	string	yes	Path where the PDF will be saved
pageSize	string	—	"FitImage" sizes each page to match the image (default: A4)

No output schema declared.

No examples provided.

pdf_info ~70

Get detailed information about a PDF: page count, file size, metadata (title, author, dates), form field count, and page dimensions in points and inches.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Absolute or relative path to the PDF file
password	string	—	Password if the PDF is encrypted

No output schema declared.

No examples provided.

pdf_insert_pages ~122

Insert pages from one PDF into another at a specific position. Useful for adding cover pages, appendices, or inserting content mid-document.

Input Output Examples

Name	Type	Req	Description
insertAfter	number	yes	Insert after this page number (0 = insert at beginning, use page count for end)
outputPath	string	yes	Output path
sourcePages	array	—	Which pages to take from source (1-indexed). Omit for all source pages.
sourcePath	string	yes	PDF to take pages from
targetPath	string	yes	PDF to insert pages into

No output schema declared.

No examples provided.

pdf_merge ~59

Merge multiple PDF files into a single PDF. Pages are combined in the order listed.

Input Output Examples

Name	Type	Req	Description
filePaths	array	yes	PDF file paths to merge in desired order (min 2)
outputPath	string	yes	Output path for the merged PDF

No output schema declared.

No examples provided.

pdf_overlay_pdf ~129

Overlay one PDF on top of another. The overlay PDF is drawn on top of the base PDF pages. Perfect for adding letterheads, templates, or watermark PDFs.

Input Output Examples

Name	Type	Req	Description
basePath	string	yes	Base PDF (background)
outputPath	string	yes	Output path
overlayPage	number	—	Which page of the overlay PDF to use (1-indexed, default: 1)
overlayPath	string	yes	Overlay PDF (drawn on top)
pages	array	—	Which base pages to apply the overlay to (1-indexed). Omit for all pages.

No output schema declared.

No examples provided.

pdf_page_layout ~127

Arrange multiple PDF pages onto single sheets in N-up layouts. Puts 2 or 4 source pages onto each output page side-by-side. Useful for printing handouts, saving paper, or creating thumbnail sheets.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Source PDF file path
layout	string	yes	"2-up" = 2 pages per sheet side-by-side, "4-up" = 4 pages per sheet in a 2x2 grid
outputPath	string	yes	Output path
pageSize	string	—	Output page size (default: Letter)

No output schema declared.

No examples provided.

pdf_page_numbers ~155

Add page numbers to every page. Supports various positions, custom prefix/suffix, and starting number.

Input Output Examples

Name	Type	Req	Description
color	string	—	Color (default: dark gray)
filePath	string	yes	PDF file path
fontSize	number	—	Font size (default: 10)
margin	number	—	Edge distance in points (default: 30)
outputPath	string	yes	Output path
position	string	—	Position (default: bottom-center)
prefix	string	—	Prefix text (e.g. "Page ")
startNumber	number	—	Starting number (default: 1)
suffix	string	—	Suffix text (e.g. " of 50")

No output schema declared.

No examples provided.

pdf_read_text ~75

Extract text content from a PDF file. Can extract from all pages or specific pages. Works with text-based PDFs (not scanned images).

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Absolute or relative path to the PDF file
pages	array	—	Specific page numbers to extract (1-indexed). If omitted, extracts all pages.

No output schema declared.

No examples provided.

pdf_redact ~150

VISUAL-ONLY redaction: draws opaque rectangles over regions on PDF pages. WARNING: This does NOT remove the underlying text/data from the PDF — it only covers it visually. The original content can still be extracted programmatically. Do NOT use this for true document sanitization of sensitive data (SSNs, passwords, etc). For true redaction, use a tool that rewrites the PDF content stream (e.g. Adobe Acrobat Pro, qpdf, or mutool).

Input Output Examples

Name	Type	Req	Description
color	string	—	Redaction color (default: black)
filePath	string	yes	PDF file path
outputPath	string	yes	Output path
regions	array	yes	Regions to redact

No output schema declared.

No examples provided.

pdf_reorder ~78

Reorder pages. Can also duplicate pages by repeating numbers in the order array.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
outputPath	string	yes	Output path
pageOrder	array	yes	New page order (1-indexed). Example: [3, 1, 2] puts page 3 first.

No output schema declared.

No examples provided.

pdf_repair ~78

Attempt to repair a damaged or malformed PDF by loading it with lenient parsing, copying all recoverable pages to a clean document, and re-saving. May fix issues like corrupted cross-reference tables or orphaned objects.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	Path to the damaged PDF
outputPath	string	yes	Path for the repaired PDF

No output schema declared.

No examples provided.

pdf_reverse ~48

Reverse the page order of a PDF. Useful for fixing scan order or printing back-to-front.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
outputPath	string	yes	Output path

No output schema declared.

No examples provided.

pdf_rotate ~75

Rotate pages by 90, 180, or 270 degrees clockwise.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
outputPath	string	yes	Output path
pages	array	—	Pages to rotate (1-indexed). Omit for all pages.
rotation	string	yes	Clockwise rotation degrees

No output schema declared.

No examples provided.

pdf_search ~108

Search for text in a PDF. Returns all matches with page numbers and surrounding context. Supports plain text and regex search.

Input Output Examples

Name	Type	Req	Description
caseSensitive	boolean	—	Case-sensitive search (default: false)
contextChars	number	—	Characters of context around each match (default: 60)
filePath	string	yes	PDF file path
query	string	yes	Text or regex pattern to search for
regex	boolean	—	Treat query as a regex pattern (default: false)

No output schema declared.

No examples provided.

pdf_set_metadata ~132

Set or update PDF document metadata fields: title, author, subject, keywords, creator, and producer. Only specified fields are changed; others remain untouched.

Input Output Examples

Name	Type	Req	Description
author	string	—	Document author
creator	string	—	Creator application name
filePath	string	yes	Path to the PDF file
keywords	array	—	Document keywords as an array of strings
outputPath	string	yes	Path where the modified PDF will be saved
producer	string	—	Producer application name
subject	string	—	Document subject/description
title	string	—	Document title

No output schema declared.

No examples provided.

pdf_sign ~137

Add a signature image to a PDF with smart positioning. Simplified alternative to pdf_add_image for signing documents.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path
imagePath	string	yes	Path to signature image (PNG or JPG)
margin	number	—	Distance from page edge (default: 50)
outputPath	string	yes	Output path
page	number	—	Page to sign (1-indexed). Default: last page.
position	string	—	Signature position (default: bottom-right)
width	number	—	Signature width in points (default: 150). Height scales proportionally.

No output schema declared.

No examples provided.

pdf_split ~64

Split a PDF into multiple files — either individual pages or custom page ranges.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file to split
outputDir	string	yes	Directory for output files
ranges	array	—	Page ranges. If omitted, splits into individual pages.

No output schema declared.

No examples provided.

pdf_stamp ~177

Apply a styled business stamp (like a rubber stamp) to PDF pages. Pre-configured styles for common stamps, or create custom ones. Draws a bordered rectangle with text inside, slightly rotated for authenticity.

Input Output Examples

Name	Type	Req	Description
customText	string	—	Custom stamp text (only used when type is CUSTOM)
filePath	string	yes	PDF file path
opacity	number	—	Opacity (default: 0.75)
outputPath	string	yes	Output path
pages	array	—	Pages to stamp (1-indexed). Omit for all.
position	string	—	Stamp position (default: top-right)
rotation	number	—	Rotation in degrees for rubber-stamp look (default: -15)
type	string	yes	Stamp type. Use CUSTOM with customText for your own stamp.

No output schema declared.

No examples provided.

pdf_validate ~53

Validate a PDF file — checks if it can be parsed, reports page count, metadata, form fields, and any structural issues. Useful as a health check before processing.

Input Output Examples

Name	Type	Req	Description
filePath	string	yes	PDF file path

No output schema declared.

No examples provided.

pdf_watermark ~177

Add a diagonal text watermark across PDF pages. The text is properly centered regardless of rotation angle.

Input Output Examples

Name	Type	Req	Description
color	string	—	Color — hex (#f00), short hex (#ff0000), or name (red, navy, etc). Default: #888888
filePath	string	yes	PDF file path
fontSize	number	—	Font size in points (default: 60)
opacity	number	—	Opacity 0-1 (default: 0.15)
outputPath	string	yes	Output path
pages	array	—	Pages to watermark (1-indexed). Omit for all.
rotation	number	—	Rotation in degrees (default: 45)
text	string	yes	Watermark text (e.g. "CONFIDENTIAL", "DRAFT")

No output schema declared.

No examples provided.

On this page

Handy links

Scoring key

80+ high trust
60–79 medium
below 60 low

How we score

Score history · last 30 days

27 Jul 3 Aug

Day	Score
27 Jul	40
28 Jul	40
29 Jul	61
30 Jul	10
31 Jul	64
1 Aug	54
2 Aug	15
3 Aug	65