omniseek_search
Search curated sources to get ranked, deduplicated, cross-lingual results, then drill into a single source for focused or hard-to-reach coverage.
Instructions
Search the curated sources. The default for "best/latest on X". ONE verb, three shapes.
Tool name: omniseek_search (your MCP config adds its own prefix; never guess one). Not in your tool list? ToolSearch "omniseek_search".
Shapes: default = one ranked, deduped, cross-lingual list; raw=True with exactly one source = an unbounded drill of that source (the way to reach walled or slow sources, which the broad sweep drops at its deadline); raw=True otherwise = uncollapsed per-source buckets.
Args: query: search words; empty browses by recency. sources: source names (None = every non-explicit_only source); take names from omniseek_sources. limit: max documents (per source in buckets). semantic: None = lexical plus vector recall; False = exact tokens only; True = lean on vectors. raw: see shapes. full: whole content per document. wait_s: patience budget in seconds (None = default deadline). staleness: "fresh" (bypass cache) | "cached_ok" (default) | "cache_only" (read what already warmed, send nothing). debug: keep the ranking telemetry in each document's metadata. filters: dict ({"year": {"gte": 2020}}) or expressions ("k=v", "k=a,b", "k>=n", "k=a..b", "k~text"); fields per source in omniseek_sources. as_of: "YYYY-MM-DD" or an ISO time with zone: only items that existed then.
Fire then collect: call with a small wait_s, then again ~20 s later with staleness="cache_only", the SAME query and the SAME limit (limit is in the cache key): faster and more complete.
Returns {query, count, documents, _meta, routing_hint?} (ranked); {source, query, count, documents, _meta?} (one-source drill: _meta.diagnostic when empty or errored, _meta.held when the eye's own gate sent nothing); {query, results: {source: [...]}, total_count, _meta} (buckets). _meta names timed_out / empty / errored / held sources (held = not tried, says nothing about the topic) and excluded_relevant walled sources worth naming. A bad filter returns error, filter_problems and available_filters and sends nothing; a bad as_of returns error. When _meta.web_search_backend shows cooling, wait cooling_s before retrying. More: omniseek docs/TOOLS.md, omniseek_search.
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": {
"query": "<query>"
},
"name": "omniseek_search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| raw | No | ||
| full | No | ||
| as_of | No | ||
| debug | No | ||
| limit | No | ||
| query | Yes | ||
| wait_s | No | ||
| filters | No | ||
| sources | No | ||
| semantic | No | ||
| staleness | No | cached_ok |