Skip to content
MCP server

PDF Spec (PDF Agent Stack)

Look up ISO 32000 clauses, definitions and shall/should/may requirements, not file checks

Runs locallyStatus and history
Pricing
Free
Platforms
CLI
Runs
Locally
Version
0.14.0
Listing updated
2 days ago

About PDF Spec (PDF Agent Stack)

PDF Spec (PDF Agent Stack) is a free MCP server for files and documents. It runs locally on your machine and is started by your AI client.

A search that comes back empty here means the answer is not in the corpus, not that no such requirement exists. This server is a reference for the text of ISO 32000 and up to 16 related PDF documents, and the README is firm that it is not a rule engine: it never opens or examines a PDF and cannot say whether a file conforms. Conformance questions go to its sibling pdf-verify-mcp.

Within that scope it offers section-aware full-text search, structured extraction of headings, paragraphs, lists, tables and notes, term definitions from the terms clause, normative requirement extraction by shall, should and may, and a comparison of PDF 1.7 and PDF 2.0 section structure. ISO 19005 (PDF/A) and ETSI PAdES are outside the corpus.

The specification files are not included. You download them separately, for example from the PDF Association's sponsored standards page, and point the server at a local folder. It is one of four servers in the author's PDF Agent Stack, alongside reader, verify and writer servers.

Install

Run in a terminal

claude mcp add pdf-spec-mcp -- npx -y @shuji-bonji/pdf-spec-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "pdf-spec-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-spec-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "pdf-spec-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-spec-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "pdf-spec-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-spec-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "pdf-spec-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-spec-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "pdf-spec-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@shuji-bonji/pdf-spec-mcp"
      ]
    }
  }
}

What it does

Spec text search
Keyword search with section-aware context snippets across the loaded documents.
Requirement extraction
Pulls shall, should and may statements per ISO conventions.
Definitions lookup
Returns term definitions from the terms and definitions clause.
Table extraction
Detects multi-page tables and merges their headers.
Version comparison
Diffs PDF 1.7 and PDF 2.0 section structures.
Multi-document corpus
Auto-discovers up to 17 PDF-related documents placed in a local folder.

Good for

  • Quote the clause behind a PDF structure question
  • List the normative requirements in a section
  • Compare how PDF 2.0 reorganised a topic
  • Ground an agent's PDF answers in the standard

Pricing

Free

Free npm package; spec documents must be obtained separately

Prices change. Check shuji-bonji.github.io before you buy.

PDF Spec (PDF Agent Stack) FAQ

Can it tell me whether my PDF is valid?

No. It is a specification reference only; use pdf-verify-mcp for validation.

Are the spec documents bundled?

No. You obtain them separately and point the server at a local directory.

Does it cover PDF/A?

No. ISO 19005 and ETSI PAdES are outside the corpus.

What does an empty search mean?

It means the corpus cannot answer, not that no requirement exists.

Is PDF Spec (PDF Agent Stack) free?

Yes. PDF Spec (PDF Agent Stack) is free to use.

How do I add PDF Spec (PDF Agent Stack) to Claude Code?

Run this command in your terminal: claude mcp add pdf-spec-mcp -- npx -y @shuji-bonji/pdf-spec-mcp

What are the best alternatives to PDF Spec (PDF Agent Stack)?

The closest alternatives to PDF Spec (PDF Agent Stack) are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

Alternatives to PDF Spec (PDF Agent Stack)

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  3. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  4. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  5. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory
  6. Ouroboros

    MCP server

    Spec-first layer that pins requirements and verifies results of AI coding agent work

    Runs locally
    • Open source
    • 6.4K GitHub stars
    • Developer tools