Document brief
Metadata, an AI-written summary, and a preview of the opening pages of a PDF - understand what a document says without reading the whole thing. The catalog's first AI-summarization pack, complementary to document-intel's deterministic format extraction (no AI, no summarization there).
3 tools run server-side in one request. You pay once, settle once, and get a single response - no orchestration, no per-step payments, and a partial-success envelope if any step fails. USDC over x402 on any supported chain.
When to use this pack
An agent is handed a PDF link - a research paper, an earnings report, a whitepaper, a long contract - and needs the gist before deciding whether to read further or which section to pull next. document-intel answers "what format is this and can I get the raw text out"; document-brief answers "what does this document actually say."
Tools in this pack
All 3 run inside the single $0.050 call above. Each is also callable on its own if you only need one part.
- PDF info POST /api/pdf-info Inspect a PDF without downloading the whole thing into your model: page count, title, author, subject, creator, producer, creation/modification dates, encryption flag, and byte size. Body: {"url":"https://…/file.pdf"}.
- Summarize a PDF POST /api/pdf-summarize Fetch a PDF from a URL, extract its text, and return a concise AI-generated summary - factual, no information added beyond what's in the document. Body: {"url":"https://…/file.pdf","maxWords":200?}. Uses the same OpenAI-compatible gateway as /v1/chat/completions internally; the model that actually served is disclosed in the response.
- Extract / split PDF pages POST /api/pdf-extract-pages Pull a subset of pages into a new PDF (split). Body: {"url":"https://…/file.pdf","pages":"1-3,5"}. Returns the new PDF as base64.
Workflow
- Run pdf-info first - page count, title, author, encryption flag, byte size. Confirms the URL is really a PDF and gives you the page count before spending on the AI summary.
- Run pdf-summarize for the actual gist - a factual, AI-written summary of the document's content, with the model that served disclosed in the response. This is the one paid-AI step in the pack; the other two are pure deterministic extraction.
- Run pdf-extract-pages for a quick visual preview of the opening pages (default "1-2") - useful when you want to show the document's actual formatting/layout alongside the summary, not just prose about it.
Call it directly
Any x402 client pays the 402 and gets the whole workflow back in one response:
npx agent402-client call document-brief {"url":"https://bitcoin.org/bitcoin.pdf"}
Run it in Claude
claude mcp add agent402 -s user -- npx -y agent402-mcp@latest
Then paste this prompt into Claude:
Give me a brief on this PDF: https://bitcoin.org/bitcoin.pdf. Use Agent402's document-brief skill pack to get (1) the document's metadata and page count, (2) a ~150-word AI summary of what it actually says, and (3) the first two pages as a preview PDF. Present the summary first, then the metadata, and note the preview is available if I want to see the original formatting.