memory_search
Read-only
Find memories using hybrid vector and keyword search, with filters for scope, department, tags, date range, and temporal decay.
Instructions
Search memories using hybrid vector+keyword search. Finds semantically similar content and exact keyword matches, with optional filters for scope, department, tags, date range, and temporal decay.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Search query — supports natural language for semantic search and keywords for exact matching | |
| scope | No | Memory scope for isolation | |
| namespace | No | Namespace within scope (e.g., project name, team name) | |
| department | No | Department (e.g., legal, engineering, hr, sales, finance) | |
| document_type | No | Type of document (e.g., contract, policy, code, incident, decision) | |
| access_level | No | Access classification level | |
| language | No | Content language (ISO 639-1 code) | |
| tags | No | Filter to memories containing ALL specified tags | |
| limit | No | Maximum results to return | |
| offset | No | Skip this many results for pagination | |
| search_mode | No | Search mode: hybrid (vector+keyword), vector only, or keyword only | hybrid |
| temporal_decay | No | Apply time-based decay to favor recent memories | |
| date_from | No | Filter: only memories created at/after this full ISO-8601 timestamp (e.g. 2026-03-01T00:00:00Z) | |
| date_to | No | Filter: only memories created at/before this full ISO-8601 timestamp (e.g. 2026-03-31T23:59:59Z) | |
| min_confidence | No | Minimum confidence score threshold (0-1) | |
| min_groundedness | No | Minimum TRUST threshold (0-1), distinct from min_confidence (relevance). Drops results whose groundedness — stored confidence_score + provenance tier + recency — is below this. Use to demand well-sourced memories. | |
| as_of | No | ISO 8601 point-in-time: return memories that were valid at this instant (bi-temporal). Defaults to currently-valid memories when omitted. Must be a full ISO-8601 timestamp (date + time + zone); a date-only or non-padded value is rejected to avoid a silently-wrong lexicographic slice. | |
| use_graph | No | Enable HippoRAG multi-hop recall: seed the entity graph from the query and fuse Personalized PageRank as a third ranker, surfacing memories connected through entities (associative recall) that pure vector+keyword search misses. Default false. | |
| rerank | No | Enable local cross-encoder reranking: reorder the top candidates by joint (query, document) relevance using a cross-encoder model — the biggest precision win over the bi-encoder base embedder. Slower (runs a model per candidate) and lazy-loads the model on first use. Defaults ON at the MCP server (precision matters more than latency for agent recall); pass false to skip. Left unset, programmatic callers do not rerank. | |
| rerank_top_n | No | How many top candidates to rerank when "rerank" is true (default 50). Higher = better recall coverage but slower. | |
| detail_level | No | Controls response detail: "summary" returns titles + snippets (default, saves tokens), "full" returns complete content, "ids_only" returns just IDs and titles for browsing | summary |
| max_tokens | No | Approximate maximum response size in tokens (~4 chars per token). Results are truncated to fit within budget. Applies after detail_level projection. |