Cortex API · memory.recall

memory.recall

memory:read

Recall the most relevant memories for a query, ranked relevance-first. Time words in the query are search text, not a date filter — pass a session_id to switch to a deterministic session transcript instead.

Arguments

Name	Type	Required	Rules / enum
`query`	string	required	Non-empty. Relevance search text; time words are not a date filter.
`max_results`	integer	optional	1–100. Default `10`.
`session_id`	string	optional	≤256 chars, single-line. When set, returns a session transcript instead of a ranked recall.
`after_ts`	number	optional	Unix seconds ≥0. Only meaningful with `session_id`.
`before_ts`	number	optional	Unix seconds ≥0. Must be ≥ `after_ts`. Only with `session_id`.
`order`	enum	optional	`asc` \| `desc`. Default `desc`. Only with `session_id`.

Response (required: items, degraded, store_status)

items[] — most-relevant first. Every item carries a stable trio on every tier: content (string), entry_id (string — pass to memory.forget), source_tier (string, e.g. L1_pulse, L3_semantic, L3_archive). Optional per-tier fields: key, timestamp, category, confidence, outcome, action, access_count, context. Engine internals and any credential id are masked at the edge.
degraded (bool) — true means retrieval did not complete reliably, so an empty items is not "no memories".
store_status ∈ {populated, empty, unknown} — an empty result with a status other than populated may mean a wiped or absent store, not a genuine no-match.
error (string, optional) — present on a 4xx / contract fault.

Example

curl -sS "$CONDUIR_BASE/api/cortex/mcp" \
  -H "Authorization: ApiKey $CORTEX_KEY" \
  -H "Content-Type: application/json" \
  -d '{"tool":"memory.recall","arguments":{"query":"pilot decision","max_results":5}}'

{ "result": {
    "items": [
      { "content": "The FTSE100 pilot prospect is confirmed.",
        "entry_id": "mcp_9f3c…", "source_tier": "L3_archive" }
    ],
    "degraded": false,
    "store_status": "populated"
} }

Validation test

Runs this exact tool against the live broker (POST /api/cortex/mcp) with the key saved in this browser — the same one the dashboard uses. No key yet? Create one on Your keys (Microsoft sign-in), then come back.

Arguments (editable JSON)