anymd · diff
git:20260925.c32b5b7 to git:20260925.85d7291
21 added, 20 removed. Audit C to A.
- # anymd — PDF evidence for agents
+ ---
+ name: anymd
+ description: Read any file as Markdown with the anymd MCP server - PDF, Word, PowerPoint, Excel, CSV, EPUB, HTML and web pages, images (OCR), audio and video. Use it when a task needs the contents of a document, a folder of documents, or a URL, or needs to find text across them.
+ ---
- ## Install
+ # anymd
- ```bash
- npx -y @sylphx/anymd setup # add it to the MCP clients on this machine
- npm i -g @sylphx/anymd # or install the CLI
- ```
+ anymd turns files, folders and URLs into Markdown, locally, with no API key.
## Tools
- | Tool | Job |
- | --- | --- |
- | `read_pdf` | Agent Document Twin (structure, tables, citations) |
- | `search_pdf` | Literal search with page/bbox evidence |
- | `pdf_evidence` | inspect / render / crop / OCR follow-ups |
+ | Tool | Use it to | Key arguments |
+ | --- | --- | --- |
+ | `read` | Turn a file, URL, or folder into Markdown | `source`, `pages` (`"1-5,8"`), `max_tokens` (default 20000), `cursor`, `ocr`, `transcript` |
+ | `search` | Find text across files, folders, and URLs | `query`, `sources`, `mode` (`auto`, `literal`, `ranked`), `glob`, `max_results` |
+ | `inspect` | Go deeper on a PDF | `operation`: `render_page`, `extract_regions`, `ocr_pages`, `structure`, `compare`, `inspect` |
+ ## How to use it
+
+ - Read long documents in parts: pass `pages`, or continue with the `cursor` that `read` returns when it stops at the token budget.
+ - Cite pages from the `<!-- page N -->` anchors in `read` output.
+ - Use `search` before reading a whole folder. With no exact match it returns BM25-ranked passages.
+ - Use `inspect` only for PDF layout, page images, regions or OCR.
+
## CLI
```bash
- anymd /abs/doc.pdf > doc.md
- anymd search "indemnification" contracts/
+ anymd report.pdf > report.md
+ anymd search "indemnification" contracts/ --glob '*.pdf'
+ anymd doctor
```
-
- ## Rules
-
- - Local-first; no API key required for default path
- - Missing native binary → fail closed
- - Evidence on results (envelope v1); no `evidence_first` tool
- - Do not install Prism for PDF routing