nutrient-pdf-mcp-server CLAUDE.md

nutrient-pdf-mcp-server CLAUDE.md is an instructions file for coding agents from PSPDFKit/nutrient-pdf-mcp-server. It costs 758 tokens per session, scanned A, original, MIT.

Repository-specific instructions for a PDF MCP server that lets agents inspect the internal object structure of PDF files. It explains the project, its architecture, and tools for navigating and resolving PDF objects.

In plain words
What is it for?
Setting up the project and investigating PDF object trees, including selected paths or objects, with shallow or deeper resolution.
Why use it?
It helps an agent understand how to use and modify the server while keeping large PDF structures manageable through on-demand loading.

Instructions file

Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

agentmods
npx agentmods add instructions/pspdfkit/nutrient-pdf-mcp-server/claude-md
Clone the repo
git clone --depth 1 https://github.com/PSPDFKit/nutrient-pdf-mcp-server

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for nutrient-pdf-mcp-server CLAUDE.md

README.md
[![agentmods](https://agentmods.dev/badge/instructions/pspdfkit/nutrient-pdf-mcp-server/claude-md.svg)](https://agentmods.dev/instructions/pspdfkit/nutrient-pdf-mcp-server/claude-md)
Your own site
<a href="https://agentmods.dev/instructions/pspdfkit/nutrient-pdf-mcp-server/claude-md"><img src="https://agentmods.dev/badge/instructions/pspdfkit/nutrient-pdf-mcp-server/claude-md.svg" alt="Measured on agentmods" height="20"></a>
Per session 758 This file is loaded in full into every session.
When invoked 758 The same file — it is already loaded in full.
Security scan A 0 findings. Scan, not verified.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5 $0.00758 $0.00758
Opus 5 $0.00379 $0.00379
Sonnet 5 $0.00152 $0.00152
Haiku 4.5 $0.00076 $0.00076

Measured 3d ago against content hash 2539b416adce, method: parsed. Prices are Anthropic first-party input rates as of 2026-08-30, from the pricing page.

Security

Grade A, and why

nutrient-pdf-mcp-server CLAUDE.md scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 3d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

CLAUDE.md · 86 lines

How it starts

The opening of the file, as written. The whole thing — 86 lines — stays where its author put it; the contents beside it link to each section on GitHub.

Nutrient PDF MCP Server - Claude Memory

Project Overview

This is the Nutrient PDF MCP Server, a Model Context Protocol (MCP) server for investigating PDF object trees with lazy loading support. The server allows LLMs to explore PDF structure efficiently by providing selective resolution of indirect objects and path-based navigation.

Key Features

  • Lazy Loading: Only resolves indirect objects on demand to reduce token usage
  • Path Navigation: Supports dot notation paths like Pages.Kids.0 for drilling down
  • Two Resolution Modes: Shallow (single object) and deep (with dependencies)
  • Type Safety: Comprehensive TypedDict definitions for all PDF objects
  • Error Handling: Custom exception hierarchy with detailed error messages

Architecture

  • pdf_mcp/server.py - Main MCP server with two tools
  • pdf_mcp/parser.py - Core PDF parsing logic with pypdf integration
  • pdf_mcp/types.py - Type definitions for PDF objects and responses
  • pdf_mcp/exceptions.py - Custom exception hierarchy

MCP Tools

  1. get_pdf_object_tree - Get JSON representation of PDF structure
    • Parameters: pdf_path, mode (lazy/full), path (optional), object_id (optional)
  2. resolve_indirect_object - Resolve specific indirect objects by ID
    • Parameters: pdf_path, object_id, depth (shallow/deep)

Development

  • Python 3.10+ required (for MCP library pattern matching)
  • Use make commands for common tasks:
    • make test - Run test suite (64 tests)
    • make test-cov - Run tests with coverage analysis
    • make quality - Run all quality checks (format, lint, type check, test)
    • make format - Auto-format code with black/isort
    • make lint - Check code with ruff
    • make typecheck - Type check with mypy

Quality Standards

  • 76% test coverage with comprehensive test suite
  • Full type checking with mypy (custom overrides for pypdf interactions)
  • Modern Python syntax (union types with |, lowercase builtins)
  • Code formatting with black, isort, ruff

Read the full file on GitHub · 86 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 3d ago First seen · 86 lines · 758 tokens per session scan A 2539b416adce

Subscribe to this mod's changes

nutrient-pdf-mcp-server CLAUDE.md is an instructions file published in the GitHub repository PSPDFKit/nutrient-pdf-mcp-server (4 stars, last pushed 10d ago), licensed MIT. It adds 758 tokens to every session, about $0.0038 per session on Opus 5. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-31.

Related

Other instructions, from other repositories

PDF-Tools AGENTS.md

AGENTS.md instructions for Open-Document-Alliance/PDF-Tools, covering repository guidelines, active kepano / shannon work, project structure & module organization, tools currently shipped and build, test, and development commands.

Open-Document-Alliance/PDF-Tools · 2,821 tokens

PDF-Tools CLAUDE.md

Claude Code instructions for Open-Document-Alliance/PDF-Tools, covering pdf toolkit mcp - development guide, active kepano / shannon work, project overview, key features and technical architecture.

Open-Document-Alliance/PDF-Tools · 7,798 tokens

docs-to-pdf CLAUDE.md

Claude Code instructions for jean-humann/docs-to-pdf, covering claude development guide for docs-to-pdf, project overview, development environment setup, using mise (recommended) and install mise (if not already installed).

jean-humann/docs-to-pdf · 4,714 tokens

PDF-Writer CLAUDE.md

Instructions for galkahana/PDF-Writer, covering claude code context - pdf-writer development guide, project overview, coding standards discovered, project structure and key components.

galkahana/PDF-Writer · 1,432 tokens

autorename-pdf CLAUDE.md

Instructions for ptmrio/autorename-pdf, covering autorename-pdf, development setup, source venv/bin/activate # linux/macos, commands and ai tool integration.

ptmrio/autorename-pdf · 1,295 tokens

pdfnative-mcp AGENTS.md

Instructions for Nizoka/pdfnative-mcp, covering agents.md — pdfnative-mcp, 1. tool catalogue (28 tools), 2. decision tree, 3. token-frugal responses and 4. output modes & environment.

Nizoka/pdfnative-mcp · 10,137 tokens