omniseek_read
Read text from any URL or document file, automatically routing to the right reader; extract sections, grep terms, export media, or OCR embedded images.
Instructions
Read text from any URL OR document FILE: OmniSeek's single "read this deep" verb. AUTO-ROUTES.
Tool name: omniseek_read (your MCP config adds its own prefix; never guess one). Not in your tool list? ToolSearch "omniseek_read".
A local path, or a name ending in .pdf/.pptx/.docx/.xlsx/.txt/.md/.csv (and a local .html/.htm), goes to the document reader; anything else to the URL reader. arXiv /abs/ gives metadata, /pdf/ or /html/ the whole paper. A file from another machine goes into OmniSeek host's inbox ~/.omniseek/inbox first (or pass its URL).
Args: target: the URL or document path. start_char: where the returned window starts. max_chars: window size (default 24000); when truncated, re-call with start_char + returned_chars. level: "full" (default) | "brief" (title, author, abstract, size) | "head" (section list with char ranges) | "section". section: a section title (case-insensitive prefix) or index from level="head"; implies level="section". grep: a term, comma-separated terms or a list: return only the sentences that contain one, with one sentence of context. grep_word: grep matches whole words only. grep_case: grep matches case. export_media: (documents) export the embedded images. ocr: (documents) OCR every embedded image and append its text.
Returns (URL) {url, matched, total_chars, returned_chars, start_char, truncated, cached, fetched_at?, text_quality?, document, reason?}: matched false carries reason walled (drill the source by name with omniseek_search) | empty | blocked. Returns (document) {source, total_chars, returned_chars, start_char, truncated, cached, format, title, outline, media_total, media, media_dir, ocr_images?, text_quality?, text} or {source, error, inbox_files?}. text_quality (a PDF whose text layer reads as garbled): {level "low", readings, thresholds, hint}; read those pages with omniseek_view render_pages, and a term not found in that text may still be in the paper. With grep the body is replaced by grep: {terms, hits, occurrences, matches: [{start, end, text, terms}], returned_matches, truncated, next_start_char?}. An unknown section returns error and available_sections. To see figures use omniseek_view. More: omniseek docs/TOOLS.md, omniseek_read.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"target": "<target>"
},
"name": "omniseek_read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ocr | No | ||
| grep | No | ||
| level | No | full | |
| target | Yes | ||
| section | No | ||
| grep_case | No | ||
| grep_word | No | ||
| max_chars | No | ||
| start_char | No | ||
| export_media | No |