memory_search
Read-only
Search memories using hybrid vector and keyword matching to find semantically similar content and exact matches. Apply filters for scope, tags, date range, and temporal decay to refine results.
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 | |
| auto_decay | No | When true and no explicit temporal_decay is given, derive decay per result from its volatility class (volatile facts decay fast, stable facts not at all). Down-ranks stale volatile facts without hand-tuning a half-life. | |
| 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. |