# PDF Spec (PDF Agent Stack)

> PDF Spec (PDF Agent Stack) is a free MCP server for files and documents. Look up ISO 32000 clauses, definitions and shall/should/may requirements, not file checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI
- **Website:** https://shuji-bonji.github.io/pdf-agent-stack/
- **Repository:** https://github.com/shuji-bonji/pdf-spec-mcp
- **MCP Registry name:** io.github.shuji-bonji/pdf-spec-mcp
- **Categories:** files and documents, developer tools
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## 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

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/pdf-spec-pdf-agent-stack
