# PDF Modifier (pypi · pdf-modifier)

Modify PDF text, replace with regex, and analyze layout while preserving fonts.

- Trust score: 75/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-04

## Components

- pypi · `pdf-modifier`: 75/100 (this document), [markdown](https://verifymcp.io/servers/mlorentedev-pdf-modifier/pdf-modifier.md), [page](https://verifymcp.io/servers/mlorentedev-pdf-modifier/pdf-modifier)

## Channel facts

- Registry: `pypi`
- Package: `pdf-modifier`
- Version: `1.10.1`
- Transport: `stdio`

## Trust breakdown

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. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-04.

- **Supply Chain Security**: 50/100
  - Malware scan not yet available for this package.
  - No known CVEs affecting this package version or its production dependencies.
  - Runs hatchling.build at install time, a recognised build step with no custom scripting around it.
  - 5 of 46 dependencies flagged as unhealthy.
- **Provenance & Transparency**: 100/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to mlorentedev/pdf-modifier).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 8 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 68/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1201 tokens (~200/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 70/100
  - Stability observed for 21 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 98/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 93% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the PDF Modifier MCP server?

PDF Modifier runs locally as a PyPI package, launched with uvx pdf-modifier. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add mlorentedev-pdf-modifier -- uvx pdf-modifier
```

### Cursor

```json
{
  "mcpServers": {
    "mlorentedev-pdf-modifier": {
      "command": "uvx",
      "args": [
        "pdf-modifier"
      ]
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "mlorentedev-pdf-modifier": {
      "command": "uvx",
      "args": [
        "pdf-modifier"
      ]
    }
  }
}
```

### Codex

```bash
codex mcp add mlorentedev-pdf-modifier -- uvx pdf-modifier
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "mlorentedev-pdf-modifier": {
      "type": "local",
      "command": [
        "uvx",
        "pdf-modifier"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add mlorentedev-pdf-modifier --command uvx --arg pdf-modifier
```

### Hermes

```yaml
mcp_servers:
  mlorentedev-pdf-modifier:
    command: "uvx"
    args: ["pdf-modifier"]
```

### Netclaw

```json
{
  "McpServers": {
    "mlorentedev-pdf-modifier": {
      "Transport": "stdio",
      "Command": "uvx",
      "Arguments": [
        "pdf-modifier"
      ]
    }
  }
}
```

### Vellum

```bash
assistant mcp add mlorentedev-pdf-modifier -t stdio -c uvx -a pdf-modifier
```

### Other

```json
{
  "mcpServers": {
    "mlorentedev-pdf-modifier": {
      "command": "uvx",
      "args": [
        "pdf-modifier"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-04 (score 75, −14)

- [security regression] Malware scan: pass → unverified

### 2026-11-03 (score 89, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-11-02 (score 74, +1)

No change was recorded against any check on this day. Stability & Change Management went from 60 to 63. That category is still filling its 30-day observation window: 18 days of observed history at the previous scan, 19 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-30 (score 73, −14)

- [security regression] Malware scan: pass → unverified

### 2026-10-29 (score 87, +15)

- [security improvement] Malware scan: unverified → pass

### 2026-10-28 (score 72, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-10-27 (score 71, −15)

- [security regression] Malware scan: pass → unverified
- [functional] Package version: 1.10.0 → 1.10.1

### 2026-10-26 (score 86, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

## MCP tools (6)

### `read_pdf_structure` (~173 tokens)

Read Pdf Structure

Extract the complete structural content of a PDF document.

Returns detailed information about each page including:
\- Page dimensions (width, height)
\- All text elements with their:
  \- Exact text content
  \- Bounding box coordinates (x0, y0, x1, y1)
  \- Origin point for text insertion
  \- Font name and size
  \- Color value

Use this tool FIRST to understand the document layout before
making any modifications. The output helps identify exact text
to target for replacements.

Input parameters:

- `input_path` (string, required): Absolute path to the PDF file to analyze.        Must be a valid, accessible PDF file.
- `max_file_size` (integer): Maximum allowed input file size in bytes (default: 100 MB).
- `password`: Optional password if the PDF is encrypted.

Output parameters:

- `result` (string)

### `inspect_pdf_fonts` (~199 tokens)

Inspect Pdf Fonts

Search for specific text terms and report their font properties.

Use this tool to understand the exact font styling of text you
want to replace. This ensures replacements will match the
surrounding document style as closely as possible.

The tool searches through all pages and returns matches with:
\- Page number where the term was found
\- The search term that matched
\- Surrounding context (first 100 characters)
\- Font name (e.g., "Helvetica-Bold", "Times-Roman")
\- Font size in points
\- Origin coordinates for precise positioning

Input parameters:

- `input_path` (string, required): Absolute path to the PDF file to inspect.
- `max_file_size` (integer): Maximum allowed input file size in bytes (default: 100 MB).
- `password`: Optional password if the PDF is encrypted.
- `terms` (array, required): List of text strings to search for (1-50 terms).    Each term is searched as a substring.

Output parameters:

- `result` (string)

### `modify_pdf_content` (~426 tokens)

Modify Pdf Content

Find and replace text in a PDF while preserving font styles.

This tool performs text replacement by:
1\. Locating all occurrences of the search text
2\. Redacting the original text (white fill)
3\. Inserting the replacement text with matched styling

IMPORTANT BEHAVIORS:
\- Text is matched within individual text spans
\- Font style is approximated using Base 14 fonts (Helvetica, Times, Courier)
\- Replacement text should be similar length to avoid overlap
\- Multiple replacements can be specified in a single call

HYPERLINK SUPPORT:
\- Append "|URL" to create a clickable link: "Click Here|https://example.com"
\- Use "|void(0)" to neutralize existing links: "Product|void(0)"

REGEX SUPPORT:
\- Set use_regex=true to treat keys as regex patterns
\- Useful for matching dates, IDs, or variable content
\- Example: {"Order #\d+": "Order #REDACTED"}

PAGE RANGE:
\- Use pages="1-3" to process only pages 1 through 3 (1-indexed, inclusive)
\- Use pages="5" to process only page 5
\- Omit to process all pages

Input parameters:

- `input_path` (string, required): Absolute path to the source PDF file.
- `max_file_size` (integer): Maximum allowed input file size in bytes (default: 100 MB).
- `output_path` (string, required): Absolute path where the modified PDF will be saved.         Parent directory must exist.
- `pages`: Optional page range, e.g. "1-3" or "5". Defaults to all pages.
- `password`: Optional password if the source PDF is encrypted.
- `replacements` (object, required): Dictionary mapping old text to new text.          Keys are search strings (or regex if use_regex=true).          Values are replacement strings (optionally with |URL).
- `use_regex` (boolean): If true, treat replacement keys as regex patterns.       Default is false for literal string matching.
- `whole_span` (boolean)

Output parameters:

- `result` (string)

### `list_pdf_hyperlinks` (~111 tokens)

List Pdf Hyperlinks

Extract all existing hyperlinks and clickable URIs from a PDF.

Use this tool to inventory the links in a document before or after
making modifications. It reports the target URI, its location (bbox),
and the text covered by the link if detectable.

Input parameters:

- `input_path` (string, required): Absolute path to the PDF file to scan.
- `max_file_size` (integer): Maximum allowed input file size in bytes (default: 100 MB).
- `password`: Optional password if the PDF is encrypted.

Output parameters:

- `result` (string)

### `extract_embedded_fonts` (~129 tokens)

Extract Embedded Fonts

Extract metadata and buffers of all embedded fonts in a PDF.

Use this tool to inspect which fonts are actually embedded in a document.
Custom fonts (TrueType, OpenType) appear as Type0 with their binary
buffer. Base 14 system fonts (Helvetica, Times, Courier) are NOT
embedded and will not appear in the results.

Input parameters:

- `input_path` (string, required): Absolute path to the PDF file to inspect.
- `max_file_size` (integer): Maximum allowed input file size in bytes (default: 100 MB).
- `password`: Optional password if the PDF is encrypted.

Output parameters:

- `result` (string)

### `batch_modify_pdf_content` (~163 tokens)

Batch Modify Pdf Content

Apply the same text replacements to multiple PDF files at once.

Each file is processed independently -- a failure in one file does
not stop the rest of the batch. Output files are written to
\``output_dir`` using the same filename as the input.

Input parameters:

- `input_paths` (array, required): List of absolute paths to input PDF files.
- `max_file_size` (integer): Maximum allowed input file size in bytes (default: 100 MB).
- `output_dir` (string, required): Directory where modified PDFs will be saved.
- `password`: Optional password if PDFs are encrypted.
- `replacements` (object, required): Dictionary mapping old text to new text.
- `use_regex` (boolean): If true, treat keys as regex patterns.
- `whole_span` (boolean)

Output parameters:

- `result` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Install scripts, Dependencies. The full working is on the page: https://verifymcp.io/servers/mlorentedev-pdf-modifier/pdf-modifier#diagnostics

## Score history

- 2026-11-04: 75
- 2026-11-03: 89
- 2026-11-02: 74
- 2026-11-01: 73
- 2026-10-31: 73
- 2026-10-30: 73
- 2026-10-29: 87
- 2026-10-28: 72
- 2026-10-27: 71
- 2026-10-26: 86
- 2026-10-25: 85
- 2026-10-24: 85
- 2026-10-23: 79
- 2026-10-22: 84
- 2026-10-21: 83
- 2026-10-20: 80
- 2026-10-19: 80
- 2026-10-18: 80
- 2026-10-17: 80
- 2026-10-16: 80
- 2026-10-15: 80
- 2026-10-14: 65
- 2026-10-13: 35

## Common questions

### What is the PDF Modifier MCP server?

PDF Modifier is an MCP server listed in the public MCP registry as io.github.mlorentedev/pdf-modifier. Modify PDF text, replace with regex, and analyze layout while preserving fonts. This page covers its PyPI package (pdf-modifier).

### Is the PDF Modifier MCP server safe to use?

PDF Modifier scores 75 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 4 November 2026. 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 PDF Modifier MCP server expose?

PDF Modifier exposes 6 tools: read_pdf_structure, inspect_pdf_fonts, modify_pdf_content, list_pdf_hyperlinks, extract_embedded_fonts, batch_modify_pdf_content. Their descriptions and schemas cost roughly 1,201 tokens of context every time the server is loaded.

### Is the PDF Modifier MCP server still maintained?

PDF Modifier is still listed as active in the MCP registry. We last reached this channel on 4 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 PDF Modifier MCP server under?

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

## Links

- PyPI project: https://pypi.org/project/pdf-modifier/
- Socket report: https://socket.dev/pypi/package/pdf-modifier
- Repository: https://github.com/mlorentedev/pdf-modifier
- Changelog RSS feed: https://verifymcp.io/servers/mlorentedev-pdf-modifier/pdf-modifier.xml
- Changelog JSON feed: https://verifymcp.io/servers/mlorentedev-pdf-modifier/pdf-modifier.json
- HTML version of this page: https://verifymcp.io/servers/mlorentedev-pdf-modifier/pdf-modifier