TruePath PDF

NPM · @TRUEPATHPDF/MCP-SERVER · SCANNED AUG 3

Local-only PDF tools for AI — extract text, search, split/merge, render pages. Files never leave.

Available components

+24 this week 69 69 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 (112 of 116), 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 (112 of 116), so this covers what we could see, not the whole tree. View diagnostics → Partial

Provenance & Transparency45

Source repository is publicly reachable at the declared URL. View diagnostics → Pass
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 28 days ago).Pass
Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail

Schema Quality & AI Usability75

AI-judged instruction clarity (excellent).Pass
Context-footprint check failed: tool/resource definitions use about 1218 tokens (~135/item across 9 items; 9 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 · @truepathpdf/mcp-server

Claude Codex opencode OpenClaw Hermes Other

# add to Claude Code

claude mcp add joytruepath-truepath-pdf-mcp -- npx -y @truepathpdf/mcp-server

# add to Codex CLI

codex mcp add joytruepath-truepath-pdf-mcp -- npx -y @truepathpdf/mcp-server

// opencode.json

{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "joytruepath-truepath-pdf-mcp": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@truepathpdf/mcp-server"
      ],
      "enabled": true
    }
  }
}

# add to OpenClaw

openclaw mcp add joytruepath-truepath-pdf-mcp --command npx --arg -y --arg @truepathpdf/mcp-server

# ~/.hermes/config.yaml

mcp_servers:
  joytruepath-truepath-pdf-mcp:
    command: "npx"
    args: ["-y", "@truepathpdf/mcp-server"]

// mcp.json

{
  "mcpServers": {
    "joytruepath-truepath-pdf-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@truepathpdf/mcp-server"
      ]
    }
  }
}

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 +49
- Provenance: unverified → fail ▼ security
- Known CVEs: unverified → partial ▲ security
- Install scripts: unverified → pass ▲ security
- Schema quality: unverified → excellent ▲ functional
- Tool coverage: unverified → 100 ▲ functional
- License: unverified → pass ▲ functional
- Dependency health: unverified → partial ▲ functional
- Maintenance: unverified → pass ▲ functional
- Stability: unverified → 0.27 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- Licence: MIT functional
2 Aug 26 0
- Malware scan: unverified → pass ▲ security
- Tool coverage: 100 → unverified ▼ functional
31 Jul 26 −7
- 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 +1
- Malware scan: pass → unverified ▼ security
- Dependency health: partial → unverified ▼ functional
- Tool coverage: unverified → 100 ▲ functional
28 Jul 26 −19
- Tool coverage: 100 → unverified ▼ functional
- Dependency health: unverified → partial ▲ functional
- First check of Schema quality: unverified functional
27 Jul 26 45

First indexed and scored.

Show 3 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/@truepathpdf/[email protected]

Provenance none

Ecosystem: npm · Outcome: none

Dependencies 112 packages

112 packages in the resolved dependency tree · 111 deprecated · 32 stale.

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

MCP tools — 9 exposed · ~1,218 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

extract_images Extract embedded images ~131

Pull embedded images out of a PDF and write each as a PNG. Unsupported pixel layouts (e.g. CMYK, palettized) are skipped and reported.

Input Output Examples

Name	Type	Req	Description
basename	string	—	Stem for output filenames. Default = source name. Final form: '<stem>-p001-img01.png'.
outputDir	string	yes	Directory to write extracted images into.
pages	string	—	1-based page range. Omit for all pages. Format: "1-5" or "1,3,5-7".
path	string	yes	Absolute path to the source PDF.

No output schema declared.

No examples provided.

extract_text Extract text ~104

Extract plain text from a local PDF. Optionally restrict to a page range like "1-5" or "1,3,5-7". Output is split by page with === Page N === markers.

Input Output Examples

Name	Type	Req	Description
pages	string	—	Page range (1-based). Examples: "3", "1-5", "1,3,5-7". Omit for all pages.
path	string	yes	Absolute path to a PDF on the local filesystem.

No output schema declared.

No examples provided.

get_info Get PDF info ~54

Return page count, first-page size, encryption status, and embedded metadata (title, author, dates, producer, etc.) for a local PDF.

Input Output Examples

Name	Type	Req	Description
path	string	yes	Absolute path to a PDF on the local filesystem.

No output schema declared.

No examples provided.

merge Merge PDFs ~78

Combine two or more PDFs into one, preserving page order. Outputs to a caller-specified path.

Input Output Examples

Name	Type	Req	Description
outputPath	string	yes	Absolute path for the combined output PDF. Its parent directory will be created if missing.
paths	array	yes	Two or more absolute PDF paths to combine, in order. The result preserves pages in the order given.

No output schema declared.

No examples provided.

open_in_truepath Open in TruePath PDF (Mac app) ~162

Hand a local PDF to the TruePath PDF Mac app via its truepath:// URL scheme so the user can finish work in a GUI (annotate, sign, fill forms, redact). The bridge is fire-and-forget — the app handles opening from there. Requires the app installed (https://joytruepath.com/truepath-pdf).

Input Output Examples

Name	Type	Req	Description
path	string	yes	Absolute path to the PDF to open in the TruePath PDF Mac app.
scheme	string	—	URL scheme of the receiving app. Default "truepath". Set this if you're handing off to a re-branded build of the engine — e.g. "yochenpdf" for the Yochen core build, or whatever urlScheme the destina…

No output schema declared.

No examples provided.

pages Edit pages (rotate / delete / reorder) ~207

One-pass page editor. Delete pages, rotate specific pages by 90°/180°/270°, and reorder the result — in any combination. Page numbers in `rotate` refer to the SOURCE PDF; `reorder` refers to post-delete positions.

Input Output Examples

Name	Type	Req	Description
delete	string	—	Pages to delete, 1-based, comma/range form. Example: "1,3,5-7". Applied BEFORE rotate and reorder.
outputPath	string	yes	Absolute path to write the result to.
path	string	yes	Absolute path to the source PDF.
reorder	array	—	New page order, expressed as 1-based positions in the post-delete output. Example: [3,1,2] puts page 3 first. Must be a permutation of all surviving pages.
rotate	array	—	Per-page absolute rotations applied to pages that survive the delete step. Page numbers refer to the SOURCE PDF, not the post-delete one — easier to reason about.

No output schema declared.

No examples provided.

search Search PDF ~124

Find a substring across the whole PDF. Returns each hit's page, offset within the page, and a snippet of surrounding text. Use for grep-style discovery before extracting full text.

Input Output Examples

Name	Type	Req	Description
caseSensitive	boolean	—	Case-sensitive match. Default false.
contextChars	integer	—	How many characters of surrounding text to include per hit (default 60).
maxHits	integer	—	Cap the number of hits returned (default 200).
path	string	yes	Absolute path to a PDF on the local filesystem.
query	string	yes	Text to search for.

No output schema declared.

No examples provided.

split Split PDF ~138

Split a PDF into multiple PDFs by page ranges. Each range becomes one output file written into outputDir.

Input Output Examples

Name	Type	Req	Description
basename	string	—	Stem for output filenames. Default = source filename without .pdf. Final names look like '<basename>-1-3.pdf'.
outputDir	string	—	Directory to write outputs into. Defaults to the source PDF's directory.
path	string	yes	Absolute path to the source PDF.
ranges	array	yes	Page ranges to split into separate output PDFs, 1-based. Examples: ["1-3", "4-7", "8"] produces three files. Each range becomes one output PDF.

No output schema declared.

No examples provided.

to_images Render pages to images ~220

Rasterize PDF pages as PNG or JPG at a chosen DPI. Useful for previews, OCR pipelines, or feeding pages back to a vision model.

Input Output Examples

Name	Type	Req	Description
basename	string	—	Stem for output filenames. Default = source filename without .pdf. Final names: '<basename>-001.png' (page number padded to 3 digits).
dpi	integer	—	Render resolution. Default 150. PDF native is 72; common values: 96 screen, 150 print preview, 300 print.
format	string	—	Output format. Default "png". "jpg" is smaller but lossy.
jpgQuality	integer	—	JPEG quality 40-100. Default 85. Ignored for PNG.
outputDir	string	yes	Directory to write the rendered images into.
pages	string	—	1-based page range, e.g. "3", "1-5", "1,3,5-7". Omit for all pages.
path	string	yes	Absolute path to the source PDF.

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