mcp-pdf
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MCP_LICENSE_KEY | No | Set this in the same config block to run in Pro mode (optional). Alternatively call the license_activate tool once with your key. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pdf_infoB | Call this tool to inspect a PDF: page count, page sizes in points/mm, paper name, metadata (title, author, producer, dates) and whether it is encrypted. Read-only, never modifies the file. Free tier: unlimited. |
| pdf_countB | Page count per file plus the total, for any number of PDFs, with how many were readable. A file that cannot be read is reported on its own row and the others still count. Read-only. Free and unlimited. |
| pdf_mergeA | Call this tool to join several PDFs into one, in the order given. Page sizes are kept as-is, so a merged file may have mixed sizes, and the answer says so. Inputs are never modified. Free tier: up to 5 files per merge. |
| pdf_splitA | Call this tool to write one new PDF per range. Ranges are 1-based and may be open-ended: "1-3,5,7-" gives pages 1-3, page 5, and 7 to the end. The input is never modified. Free tier: files up to 30 pages. |
| pdf_pagesA | Call this tool to pull selected pages into one new PDF, in the order written: "2,4-6" gives four pages. Asking for a page twice copies it twice. The input is never modified. Free tier: files up to 30 pages. |
| pdf_rotateA | Call this tool to turn pages by a multiple of 90 degrees, clockwise for positive. Rotation is added to whatever the page already had, for a sideways scan. Writes a new file. Free tier: files up to 30 pages. |
| pdf_stampA | Call this tool to draw a word such as PAID or DRAFT across the pages, in a colour and position you choose. Writes a new file; input untouched. Free tier: the PAID and DRAFT presets in their preset colours. |
| pdf_watermark_businessB | Call this tool to put your business name and VAT id in the footer of every page, from the shared profile mcp-invoice and mcp-docx write. Use it before sending a document out. Pro. |
| pdf_reorderA | Call this tool to write a new PDF with pages in the order you give. The order must name every page exactly once, so nothing drops by accident; use pdf_pages for a subset. Pro. |
| pdf_textA | Call this tool for best-effort text extraction from standard-font PDFs. Returns nothing for a scan (no OCR), or glyph indices for a custom-encoded font, and says which case applies. Read-only. Free tier: unlimited. |
| license_statusA | Report this server's licence state: product, tier free or pro, licence id, expiry, the key source and the upgrade URL. No arguments, no network. Explains a free-tier refusal; license_activate installs a key. |
| license_activateA | Activate a Pro key (MCPL1.xxx.yyy) from checkout: verified offline against a built-in public key, saved to your config file. A wrong, malformed or expired key is refused, unsaved. license_status reads it back. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| mark_invoice_paid | Find an invoice, stamp PAID across it and save the stamped copy beside the original. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| recent-operations | What this server has done, newest first: the operation, the input files, the files written and when. |
TDQS
Scored across 12 tools
Each tool has a clearly distinct role: inspection/counting, extraction, and specific output-producing PDF operations. The potentially overlapping trio pdf_split, pdf_pages, and pdf_reorder is explicitly differentiated by descriptions (ranges vs subset vs full-page permutation). License tools are also cleanly separated from PDF content tools.
Names are consistently snake_case and use recognizable prefixes: pdf_ for document tools and license_ for licensing. The only minor inconsistency is that some suffixes are nouns (pdf_info, pdf_pages) while others are verbs (pdf_merge, pdf_rotate), but the pattern remains readable and predictable.
Twelve tools are well-scoped for a PDF utility server, with each tool covering a meaningful operation. The two license-related tools support the product tiering without bloating the surface.
The set covers core PDF workflows: inspection, counting, text extraction, merge, split, page selection, rotation, stamping, watermarking, and reordering. Minor gaps remain, such as OCR/scan text recovery, metadata editing, or compression, but agents can work around most of these for common tasks.