Name: PodPDF
Author: xadlabs

PodPDF MCP

Turn HTML, Markdown, URLs and saved templates into PDFs with the PodPDF API.

Grade A Local · stdio API key 9 tools v1.1.0 · 13 Oct 2026

No reviews yet by xadlabsnpm 612 Runs on your machine, nothing hosted

95/100

trust score

downloads a day

local

runs on your machine

612

downloads in 30d

What it does

Turn HTML, Markdown, URLs or saved templates into PDFs. Render invoices and reports, track long jobs, and get download links — straight from your chat.

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --env 'PODPDF_API_KEY=${PODPDF_API_KEY}' --transport stdio podpdf-mcp '--' npx -y podpdf-mcp

# 2 — ask your agent for something these tools do
#   generate_pdf, render_template, start_long_job and 6 more

It needs PODPDF_API_KEY: this reads it from your environment, so export it first.

PodPDF costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

PublisherVerified · since 2026

xadlabs1 server

1 category · publishing since 2026

All 1 server

Installation

Where are you running it?

Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts PodPDF as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.

Claude Codedeclared by this listing

This is a public server: you run it yourself and this marketplace is not in the path. You need Node.js — the current LTS (24) is the safe choice; npx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. Claude Code reads PODPDF_API_KEY (API key from https://app.podpdf.com (Settings → API Keys)) from your environment each time it starts the server, so the value stays out of its config: export it in your shell profile (macOS, Linux), or run setx PODPDF_API_KEY … and open a new terminal (Windows). The '--' is in quotes so that PowerShell passes it on.

claude mcp add --scope user --env 'PODPDF_API_KEY=${PODPDF_API_KEY}' --transport stdio podpdf-mcp '--' npx -y podpdf-mcp

Reconnect, or start a new session, and the tools appear in the model’s tool list.

Free on mcprush, and it runs from its publisher’s own package: this marketplace is not in the path, so there is no key of ours to hold and no card to add.

What it asks of you

It reaches a system of yours, so it needs your own credential rather than the publisher’s: PODPDF_API_KEY — API key from https://app.podpdf.com (Settings → API Keys). You set it in your own client’s config, on your machine — this marketplace never holds it.

What it writes

One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.

What you approve

9 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

Convert HTML, Markdown or a public HTTPS URL to a PDF (up to 25 pages, 30 seconds). Returns a download link valid for 1 hour. Costs one PodPDF credit. Docs: https://apidocs.podpdf.com/api-reference/quickjob

Parameter	Type	Required	Notes
input_type	string	yes	What content is
content	string	yes	The HTML, the Markdown, or the https:// URL to convert
save_path	string	no	Optional local file path to save the PDF to, e.g. "./invoice.pdf". The download link is returned either way.

Fill a saved PodPDF template with data and render it to PDF. Template IDs are shown in the dashboard (Templates → Use via API). Docs: https://apidocs.podpdf.com/api-reference/templates

Parameter	Type	Required	Notes
template_id	string	yes	Template ID from the PodPDF dashboard
data	object	yes	Values for the template's fields; nested objects and arrays of objects for list fields. A dotted key such as "customer.name" is also accepted.
filename	string	no	File name for the PDF
save_path	string	no	Optional local file path to save the PDF to, e.g. "./invoice.pdf". The download link is returned either way.

Queue a large HTML or Markdown document (up to 100 pages) for asynchronous rendering. Returns a job_id; set wait to true to poll until it finishes and return the download link. Docs: https://apidocs.podpdf.com/api-reference/longjob

Parameter	Type	Required	Notes
input_type	string	yes	What content is
content	string	yes	The HTML or Markdown to render
wait	boolean	no	Wait up to 3 minutes for the job to finish (default false)

Get the status and details of a PodPDF job (queued, processing, completed, partial_failed, failed, timeout). Docs: https://apidocs.podpdf.com/api-reference/jobs

Parameter	Type	Required	Notes
job_id	string	yes	Job ID

Get a fresh 1-hour download link for a finished job's stored output (long, bulk, merge/split, or stored quick and template jobs). Docs: https://apidocs.podpdf.com/api-reference/jobs

Parameter	Type	Required	Notes
job_id	string	yes	Job ID
save_path	string	no	Optional local file path to save the PDF to, e.g. "./invoice.pdf". The download link is returned either way.

Merge 2 to 20 PDFs into one, in the order given, optionally taking only some pages of each. Costs one PodPDF credit. Docs: https://apidocs.podpdf.com/api-reference/pdf-tools

Parameter	Type	Required	Notes
files	array	yes	The PDFs to merge, in order
pages	array	no	Optional page range per file, in the same order, e.g. ["", "2-end"]. Blank means every page.
filename	string	no	Name for the merged PDF, e.g. "deal-pack.pdf"
save_path	string	no	Optional local file path to save the PDF to, e.g. "./invoice.pdf". The download link is returned either way.

Split one PDF into several: each page, every N pages, by page ranges, or just the pages you pick. Costs one PodPDF credit. Docs: https://apidocs.podpdf.com/api-reference/pdf-tools

Parameter	Type	Required	Notes
file	string	yes	A PDF: a path on this machine, e.g. "./contract.pdf", or an https:// link to one
mode	string	yes	each_page: one PDF per page. every_n: a new file every N pages. ranges: one file per range. extract: one file with the pages you name.
every_n	integer	no	For every_n: how many pages per file
ranges	array	no	For ranges: e.g. ["1-3", "4-9", "10-end"]
pages	string	no	For extract: e.g. "1-3,5"
filename_pattern	string	no	How to name the parts; {basename}, {index}, {index:03} and {pages} are filled in
save_dir	string	no	Optional local directory to save every part into

Look at a PDF without changing it: page count, page ids and sizes, encryption, and (with for_edit) every form field with its type, value and options. Free, and the right first step before edit_pdf. Docs: https://apidocs.podpdf.com/api-reference/pdf-editor

Parameter	Type	Required	Notes
file	string	yes	A PDF: a path on this machine, e.g. "./contract.pdf", or an https:// link to one
for_edit	boolean	no	true also returns page ids for recipes and the form field survey (needs the editor on your plan)

Apply a recipe of operations to a PDF in one call, charged once however many it carries: text.add, watermark.text, watermark.image, header_footer, bates.stamp, pages.rotate/delete/extract/reorder/insert, metadata.set/strip, sanitize, form.fill, form.flatten, annotate.highlight/note/stamp,…

Parameter	Type	Required	Notes
file	string	yes	A PDF: a path on this machine, e.g. "./contract.pdf", or an https:// link to one
recipe	array	yes	Operations applied in order, e.g. [{"op":"watermark.text","text":"DRAFT","rotation":45},{"op":"metadata.strip"}]. For pages, use page ids from inspect_pdf as a list (["p0","p2"]) or page numbers as
filename	string	no	Name for the edited PDF
save_path	string	no	Optional local file path to save the PDF to, e.g. "./invoice.pdf". The download link is returned either way.

Free

$0 forever

Every tool, no call limit
No card, and mcprush charges nothing for it
Source published under MIT
Runs on your machine — nothing of it reaches our gateway
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install PodPDF or to call it, at any volume.

ATrust score 95 / 100

Release 1.1.0 · scanned 13 Oct 2026

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score95

Findings1 threat · 1 capability

Capabilitymoderate

Coveragesource

Verificationnone

Surface digest675263ac0b03cb801150614eb6adbaabe0b7a2f26df9c323330fd0a71a087a31

Score vectorthreat 100 → client 95

Term	Level	What it prices	Points
capability-exposure	moderate	capability blast radius (moderate) — client exposure if the model is manipulated	−3
verification-discount	none	publisher verification (unlinked) — no provenance/repo link, but the shipped source was fully read	−2
coverage-honesty	source	inspection depth (source) — how much of the target the scan could see	−0

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

Tool surfaceread

Implementation sourceread

Package metadataread

Live transportnot available

Tools were statically extracted from the published source (9 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. moderate is the level these add up to.

Tool	Capability tags	Why the tag was assigned
generate_pdf	untrusted-inputexternal-sink	untrusted-input: keyword "download"; external-sink: declares readOnlyHint: false, openWorldHint: true
render_template	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true
start_long_job	untrusted-inputexternal-sink	untrusted-input: keyword "download"; external-sink: declares readOnlyHint: false, openWorldHint: true
get_job	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
get_download_link	untrusted-input	untrusted-input: keyword "download", declares openWorldHint: true (interacts with entities outside the server)
merge_pdfs	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true
split_pdf	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true
inspect_pdf	untrusted-input	untrusted-input: declares openWorldHint: true (interacts with entities outside the server)
edit_pdf	external-sink	external-sink: declares readOnlyHint: false, openWorldHint: true

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

flow-1

Untrusted input can drive an external action even though no sensitive source is exposed.

Supply chain and provenance

Integrityfirst-seen

Surface digest675263ac0b03cb80

Scanned2026-10-13

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.