Recall
chaoscore_recallSearch stored semantic memory by exact key, substring query, or tags; excludes expired records and returns matching results in markdown or JSON.
Instructions
Search Semantic Memory records previously stored with chaoscore_remember. Supports exact key lookup, substring search over keys/values, and tag filtering. Expired records (past their ttl_seconds) are never returned. Reads the same durable store regardless of which transport you connected through.
Args:
key (string, optional): Exact key to fetch one record directly
query (string, optional): Substring to match against keys/values
tags (array of strings): Only return records with ALL of these tags (default: [])
limit (number, 1-100): Max results (default: 20)
offset (number): Pagination offset (default: 0)
response_format ('markdown' | 'json'): Output format (default: 'markdown')
Returns: For JSON format (key lookup): { "key": string, "value": string, "tags": string[], ... } or null if not found For JSON format (search): { "total": number, "count": number, "offset": number, "records": [...], "has_more": boolean, "next_offset"?: number }
Examples:
Use when: "What do we know about staging?" -> query="staging"
Use when: "Get the exact record for key X" -> key="staging.region"
Don't use when: You want to write/update a memory -> use chaoscore_remember instead
Error Handling:
Returns "No memory found for key ''" (not an error) if an exact key lookup misses
Returns empty records array (not an error) if a search finds nothing
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key | No | Exact key to fetch a single record. If set, other filters are ignored. | |
| tags | No | Only return records that have ALL of these tags | |
| limit | No | Max results to return | |
| query | No | Substring to match against memory keys and values | |
| offset | No | Number of results to skip for pagination | |
| response_format | No | Output format: 'markdown' for human-readable or 'json' for machine-readable | markdown |