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.031 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.
Bought one at a time, these 3 tools cost $0.034 together; the pack is that sum less a 10% bundle discount, rounded up to the $0.001 settlement floor, which is $0.031.
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.
Arguments
| Name | Required | Description | Example |
|---|---|---|---|
url | yes | PDF URL to summarize (e.g. https://example.com/report.pdf) | https://bitcoin.org/bitcoin.pdf |
What one call returns
A JSON object with pack, args, steps, summary; steps holds one entry per tool (pdf-info, pdf-summarize, pdf-extract-pages), each with its own result or error. Full example on the API page.
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.