# PDF Agent Stack

> Building a PDF-expert AI agent

Read, verify, write — grounded in the spec. Four MCP servers and three skills for AI agents.

## Table of Contents

- [Accessibility (PDF/UA)](/pdf-agent-stack/use-cases/accessibility.md): Accessibility (PDF/UA) — from tagged generation to veraPDF scoring. Both sides measured — a 106/106 pass and a real untagged document failing 10 rules
- [AI が PDF を読むときに失われる情報](/pdf-agent-stack/ja/guide/ai-and-pdf.md): PDF Association の「FAQ: AI and PDF」が AI の PDF 取り込みに求める 10 項目と、PDF Agent Stack のどのツールがそれに答えるか
- [Architecture & Responsibilities](/pdf-agent-stack/guide/architecture.md): The whole picture of PDF Agent Stack and each MCP's responsibility boundary — four independent MCPs and the Skills that decide the calling order, the four-layer model, declaration vs. conformance vs. validation, assertion strength T1/T2/T3, verdicts returned by code while the LLM writes only the explanation
- [Batch Audit](/pdf-agent-stack/use-cases/batch-audit.md): Batch audit — run evaluate_policy over many PDFs for a deterministic triage, then deep-dive only the problem files. Measured on 5 specimens producing all 4 verdicts
- [Building PDF Agents](/pdf-agent-stack/guide/agents.md): Three levels of building a PDF-specialist agent — connecting MCPs, orchestrating with Skills, defining focused subagents, and notes for local LLMs
- [Constraint Tables (pdf-constraints)](/pdf-agent-stack/reference/pdf-constraints.md): pdf-constraints — the shared library that maps ISO 32000 clauses to machine-checkable constraint tables. Four states, given facts, traces of violations, and the ground veraPDF does not cover
- [Delivery Pipeline](/pdf-agent-stack/use-cases/publish-pipeline.md): Quality-gated delivery pipeline — the write → read-back → verify loop, traced through a real run that passed veraPDF for both PDF/A-3b and PDF/UA-1
- [Environment Variables](/pdf-agent-stack/reference/env-vars.md): Environment variables of each MCP server — PDF_SPEC_DIR / PDF_SPEC_CACHE / PDF_READER_CONCURRENCY / PDF_VERIFY_VERAPDF / PDF_VERIFY_TRUST_ANCHORS / PDF_WRITER_FONT
- [Error Codes](/pdf-agent-stack/reference/error-codes.md): Structured error codes of pdf-writer and pdf-verify
- [Getting Started](/pdf-agent-stack/guide/getting-started.md): Setup with npx — configuration examples for each MCP server, required environment variables (PDF_SPEC_DIR / PDF_WRITER_FONT etc.), and smoke-test prompts
- [Glossary](/pdf-agent-stack/reference/glossary.md): Glossary — declaration vs conformance vs validation, assertion strength T1/T2/T3, basis (grounds for a rectangle), PAdES, LTV, DocMDP, veraPDF, the 4-value verdict
- [How to Read ISO Specs (Primer)](/pdf-agent-stack/reference/iso-reading-primer.md): A primer on reading ISO specifications — NOTEs are not normative, only shall is a condition of conformance, definitions override everyday language
- [Incoming PDF Audit](/pdf-agent-stack/use-cases/incoming-audit.md): Incoming PDF audit — how pdf-trust returns a Trust Report built on evaluate_policy's deterministic 4-value verdict, traced through a real audit of the Japanese official gazette
- [Invoice for Japan's e-Bookkeeping Rules (Denchōhō)](/pdf-agent-stack/use-cases/denchoho-invoice.md): Invoice for Japan's e-bookkeeping rules (Denchōhō) — attach the detail CSV with attach_file, run ensure_pdfa(pdfa-3b) last, score with veraPDF and deliver. No legal-compliance diagnosis. Measured log included
- [ISO 仕様書の読み方（入門）](/pdf-agent-stack/ja/reference/iso-reading-primer.md): ISO 仕様書の読み方入門 — NOTE は規範ではない・shall だけが適合の必要条件・定義は日常語を上書きする、等の読解規約
- [Large or Unreadable PDFs](/pdf-agent-stack/use-cases/pdf-read.md): Large or unreadable PDFs — measure with summarize, narrow with search_text, and read pages without a text layer as images via render_page. Measured on a 21-page specimen and a scan-like specimen
- [Long-Term Preservation (PDF/A)](/pdf-agent-stack/use-cases/pdfa-archive.md): Long-term preservation (PDF/A) — producers run attach_file → ensure_pdfa → veraPDF scoring; recipients check the PAdES structure and whether LTV data really exists. With measured logs
- [MCP Servers](/pdf-agent-stack/mcp.md): The four MCP servers and their layers — pdf-spec (canon) / pdf-reader (substance) / pdf-verify (judgment) / pdf-writer (creation)
- [MCP サーバー一覧](/pdf-agent-stack/ja/mcp.md): 4 つの MCP サーバーの一覧と層構成 — pdf-spec（正典）/ pdf-reader（実体）/ pdf-verify（判定）/ pdf-writer（生成）
- [PDF Agent Stack とは](/pdf-agent-stack/ja/guide/overview.md): PDF Agent Stack の全体像 — 4 つの MCP サーバーと 3 つの Skill の構成要素、観測・判定・生成・規範を分離する理由
- [pdf-publish — Delivery Pipeline](/pdf-agent-stack/skills/pdf-publish.md): The exit-gate Skill that runs the write → read-back → verify quality loop and delivers with a Publish Report
- [pdf-publish — 納品パイプライン](/pdf-agent-stack/ja/skills/pdf-publish.md): pdf-writer で書き、pdf-reader で読み戻し、pdf-verify（veraPDF）で採点する品質ゲートを通してから Publish Report 付きで納品する Skill
- [pdf-read — Reading Pipeline](/pdf-agent-stack/skills/pdf-read.md): The reading-pipeline Skill that pulls what you need out of large or unreadable PDFs and reports what could not be read
- [pdf-read — 読み取りパイプライン](/pdf-agent-stack/ja/skills/pdf-read.md): 大きな PDF・読めない PDF から必要な箇所を取り出し、読めなかった箇所を Read Report に書く読み取り Skill
- [pdf-reader-mcp](/pdf-agent-stack/ja/mcp/pdf-reader.md): PDF の中身と位置を観測する MCP（18 ツール） — テキスト・表・タグ・フォント・署名フィールド・bbox。観測であり判定ではない
- [pdf-reader-mcp](/pdf-agent-stack/mcp/pdf-reader.md): The MCP that observes what is inside a PDF and where it is (18 tools) — text, tables, tags, fonts, signature fields, bboxes. Observation, never judgment
- [pdf-reader-mcp — Tools Reference](/pdf-agent-stack/reference/mcp/pdf-reader.md): Tools reference for pdf-reader-mcp v0.17.0 — parameters, types, defaults and returns of all 18 tools, generated from the server's tools/list.
- [pdf-reader-mcp — ツールリファレンス](/pdf-agent-stack/ja/reference/mcp/pdf-reader.md): pdf-reader-mcp v0.17.0 の全 18 ツールの引数・型・既定値・戻り値（tools/list から自動生成）
- [pdf-spec の出力の読み方](/pdf-agent-stack/ja/reference/pdf-spec-output.md): pdf-spec-mcp の出力 3 種類（仕様条文・要件・定義）の JSON の形と、読み違えやすい箇所
- [pdf-spec-mcp](/pdf-agent-stack/ja/mcp/pdf-spec.md): ISO 32000 系仕様書の構造化参照 MCP — 条文・要件（shall/should/may）・定義・表・版間比較。ファイルは開かず判定もしない
- [pdf-spec-mcp](/pdf-agent-stack/mcp/pdf-spec.md): The structured reference MCP for the ISO 32000 family — clauses, requirements (shall/should/may), definitions, tables, version comparison. Never opens the PDF under examination, never judges
- [pdf-spec-mcp — Tools Reference](/pdf-agent-stack/reference/mcp/pdf-spec.md): Tools reference for pdf-spec-mcp v0.9.0 — parameters, types, defaults and returns of all 8 tools, generated from the server's tools/list.
- [pdf-spec-mcp — ツールリファレンス](/pdf-agent-stack/ja/reference/mcp/pdf-spec.md): pdf-spec-mcp v0.9.0 の全 8 ツールの引数・型・既定値・戻り値（tools/list から自動生成）
- [pdf-trust — Incoming Audit](/pdf-agent-stack/skills/pdf-trust.md): The Skill that audits incoming PDFs — returns a Trust Report built around evaluate_policy's 4-value verdict
- [pdf-trust — 受入監査](/pdf-agent-stack/ja/skills/pdf-trust.md): 受け取った PDF の信頼性監査を行う Skill — evaluate_policy の 4 値判定を軸に Trust Report を返す Skill
- [pdf-verify-mcp](/pdf-agent-stack/ja/mcp/pdf-verify.md): 真正性・準拠性を判定する MCP（7 ツール） — 署名検証・改ざん検知・PAdES 観測・PDF/A / PDF/UA 検証・条文検査・決定論的 4 値判定。条文に反する箇所は見つけられるが、規格どおりであることは証明しない
- [pdf-verify-mcp](/pdf-agent-stack/mcp/pdf-verify.md): The MCP that judges authenticity and conformance (7 tools) — signature verification, tamper detection, PAdES observation, PDF/A / PDF/UA validation, clause checks, deterministic 4-value verdict. It can find breaches of the standard; it never proves conformance
- [pdf-verify-mcp — Tools Reference](/pdf-agent-stack/reference/mcp/pdf-verify.md): Tools reference for pdf-verify-mcp v0.31.0 — parameters, types, defaults and returns of all 7 tools, generated from the server's tools/list.
- [pdf-verify-mcp — ツールリファレンス](/pdf-agent-stack/ja/reference/mcp/pdf-verify.md): pdf-verify-mcp v0.31.0 の全 7 ツールの引数・型・既定値・戻り値（tools/list から自動生成）
- [pdf-writer-mcp](/pdf-agent-stack/ja/mcp/pdf-writer.md): PDF を生成・編集する MCP（20 ツール） — text / Markdown / 表からの生成、日本語フォント埋め込み。適合宣言は書けるが、規格適合そのものは保証しない
- [pdf-writer-mcp](/pdf-agent-stack/mcp/pdf-writer.md): The MCP that creates and edits PDFs (20 tools) — creation from text / Markdown / tables, CJK font embedding. It can write a conformance declaration; it cannot guarantee conformance itself
- [pdf-writer-mcp — Tools Reference](/pdf-agent-stack/reference/mcp/pdf-writer.md): Tools reference for pdf-writer-mcp v0.22.0 — parameters, types, defaults and returns of all 20 tools, generated from the server's tools/list.
- [pdf-writer-mcp — ツールリファレンス](/pdf-agent-stack/ja/reference/mcp/pdf-writer.md): pdf-writer-mcp v0.22.0 の全 20 ツールの引数・型・既定値・戻り値（tools/list から自動生成）
- [Reading pdf-spec Output](/pdf-agent-stack/reference/pdf-spec-output.md): The three kinds of pdf-spec-mcp output (clauses, requirements, definitions) — their JSON shape and where they are easy to misread
- [Skill 一覧](/pdf-agent-stack/ja/skills.md): 4 つの MCP を呼ぶ順番と結果の読み方を決める 3 つの Skill — pdf-trust（受入監査）・pdf-publish（検証してから納品）・pdf-read（読み取り）
- [Skills](/pdf-agent-stack/skills.md): The three Skills that orchestrate PDF Agent Stack — pdf-trust (incoming audit), pdf-publish (verify, then deliver), and pdf-read for the most frequent job of all, reading
- [Spec Research](/pdf-agent-stack/use-cases/spec-research.md): Spec research — quoting ISO 32000 clauses and shall/may requirements from the original text via pdf-spec. Measured queries — incremental updates §7.5.6 = 10 requirements, DocTimeStamp = §12.8.5
- [Untitled](/pdf-agent-stack/ja.md): AI エージェントのための PDF ツール群 — 読む・検証する・書く・仕様で裏付ける 4 つの MCP サーバーと 3 つの Skill
- [Use Cases](/pdf-agent-stack/use-cases.md): Eight use cases — incoming audit, delivery pipeline, long-term preservation (PDF/A), accessibility (PDF/UA), spec research, batch audit, large or unreadable PDFs, e-bookkeeping invoice
- [What an AI drops when it reads a PDF](/pdf-agent-stack/guide/ai-and-pdf.md): The ten things the PDF Association's "FAQ: AI and PDF" asks of an AI that ingests PDFs, and which PDF Agent Stack tool answers each
- [What is PDF Agent Stack?](/pdf-agent-stack/guide/overview.md): The big picture of PDF Agent Stack — four MCP servers, three Skills, and why observation, judgment, creation and norms are kept apart
- [アクセシビリティ (PDF/UA)](/pdf-agent-stack/ja/use-cases/accessibility.md): アクセシビリティ (PDF/UA) — タグ付き生成から veraPDF 採点まで。UA-1 106/106 通過の実走と、タグなし実文書が 10 規則で落ちる実測の両面
- [エラーコード一覧](/pdf-agent-stack/ja/reference/error-codes.md): pdf-writer と pdf-verify の構造化エラーコード一覧
- [ユースケース一覧](/pdf-agent-stack/ja/use-cases.md): 8 つのユースケース — 受入監査・納品パイプライン・長期保存 (PDF/A)・アクセシビリティ (PDF/UA)・仕様調査・一括監査・大きい PDF・読めない PDF・電帳法を意識した請求書
- [一括監査](/pdf-agent-stack/ja/use-cases/batch-audit.md): 一括監査 — 複数 PDF に evaluate_policy を回して決定論的にトリアージし、問題のあるファイルだけを深掘りする。5 検体で 4 値判定が全て出た実測付き
- [仕様調査](/pdf-agent-stack/ja/use-cases/spec-research.md): 仕様調査 — pdf-spec で ISO 32000 の条文・要求(shall/may)を原文から引く。増分更新 §7.5.6 = 10 要求、DocTimeStamp = §12.8.5 系の実測クエリ付き
- [全体構成と責務](/pdf-agent-stack/ja/guide/architecture.md): PDF Agent Stack の全体構成と各 MCP の責務境界 — 独立した 4 つの MCP と呼び出し順を決める Skill、4 層モデル、宣言・準拠・検証の区別、言い切り強度 T1/T2/T3、判定はコードが返し LLM は説明文だけを書く
- [制約テーブル (pdf-constraints)](/pdf-agent-stack/ja/reference/pdf-constraints.md): pdf-constraints — ISO 32000 の条文を機械検査できる制約テーブルに書き起こした共有ライブラリ。4 状態・given・違反の痕跡・veraPDF が見ない領域
- [受入監査](/pdf-agent-stack/ja/use-cases/incoming-audit.md): 受け取った PDF の受入監査 — pdf-trust が evaluate_policy の決定論的 4 値判定を軸に Trust Report を返すまでを、インターネット官報の実監査ログで追う
- [大きい PDF・読めない PDF](/pdf-agent-stack/ja/use-cases/pdf-read.md): 大きい PDF・読めない PDF — summarize で測ってから search_text で絞り込み、テキスト層の無いページは render_page で画像として読む。21 ページ検体とスキャン相当検体の実測付き
- [専門エージェントの構築方法](/pdf-agent-stack/ja/guide/agents.md): PDF 専門エージェント構築の 3 レベル — MCP 接続・Skill の追加・専門サブエージェント定義、ローカル LLM 適用時の注意
- [導入手順](/pdf-agent-stack/ja/guide/getting-started.md): npx での導入手順 — 各 MCP サーバーの設定例、必須環境変数（PDF_SPEC_DIR / PDF_WRITER_FONT 等）、動作確認プロンプト
- [環境変数一覧](/pdf-agent-stack/ja/reference/env-vars.md): 各 MCP サーバーの環境変数一覧 — PDF_SPEC_DIR / PDF_SPEC_CACHE / PDF_READER_CONCURRENCY / PDF_VERIFY_VERAPDF / PDF_VERIFY_TRUST_ANCHORS / PDF_WRITER_FONT
- [用語集](/pdf-agent-stack/ja/reference/glossary.md): 用語集 — 宣言/準拠/検証の区別、言い切り強度 T1/T2/T3、basis（位置の根拠）、PAdES・LTV・DocMDP・veraPDF・4 値判定
- [納品パイプライン](/pdf-agent-stack/ja/use-cases/publish-pipeline.md): 品質ゲート付き納品パイプライン — write → read-back → verify のループを、請求書デモ（PDF/A-3b + PDF/UA-1 を veraPDF 権威判定で通過）の実走ログで追う
- [長期保存 (PDF/A)](/pdf-agent-stack/ja/use-cases/pdfa-archive.md): 長期保存 (PDF/A) — 作る側は attach_file → ensure_pdfa → veraPDF 採点、受け取る側は PAdES 構造と LTV データの実在確認。電帳法文脈の実測ログ付き
- [電帳法を意識した請求書](/pdf-agent-stack/ja/use-cases/denchoho-invoice.md): 電帳法を意識した請求書 — 明細 CSV を attach_file で同梱し、ensure_pdfa(pdfa-3b) を最後に掛け、veraPDF で採点して納品する。法令への適合は診断しない。実測ログ付き