SmartMemory

Retrieve a structured surfacing response (CORE-MEMORY-DYNAMICS-1 M1a). Returns JSON matching ``smart-memory-docs/docs/features/CORE-MEMORY-DYNAMICS-1/context-api-contract.json``. Cross-type retrieval, ``strategy_used="fast:recency"``. Standalone MCP does not currently compose anchors.

Authenticate with a SmartMemory API key. Restart MCP server to unlock PRO tools.

Enable or disable automatic memory lifecycle. When enabled, SmartMemory automatically recalls context at session start, observes tool calls, distills conversation turns, learns from errors, and persists session summaries. Zero manual tool calls needed. Session-scoped overrides — settings apply to the current session only, not persisted to config.toml.

Explain a memory's full provenance: origin, every belief the system held for it over time, what replaced it, what it derives from, and whether its history is cryptographically intact. The single-call audit answer (PLAT-AUDITABLE-MEMORY-1). FREE tier by design: agents should always be able to answer "how do you know that?". chain_verified null means nothing to verify (legacy or unversioned) — it is NOT a tamper warning.

Export all memories as an OKF bundle directory or tar.gz archive.

Report which search results you used from a previous memory_search call. Call this after using results from memory_search to help SmartMemory learn which memories are actually useful. Pass the search_session_id from the memory_search response and the item_ids you incorporated into your response.

Retrieve a memory item by ID with full content and metadata.

Losslessly import an OKF bundle through the direct add path.

Ingest content through the full NLP pipeline with entity extraction.

Migrate all memories to a different backend via a temporary OKF bundle.

Compile active workspace decisions into a Stratum policy bundle. ``workflow`` is echoed in the selector for the runner. ``domain`` narrows the source decisions. The returned JSON is the policy-exchange contract bundle and is identical for local and hosted backends.

**Deprecated:** Use ``get_working_context``. Legacy surface kept for backward compatibility. Internally delegates to the surfacing helper (CORE-MEMORY-DYNAMICS-1 M1a) and post-filters cross-type results through ``_LEGACY_RECALL_TYPE_SCOPE`` to preserve the pre-shim ``memory_type="working"`` scope.

Assemble the most useful context that fits in a token budget. Returns one priority-ordered block (active plan, anchors, latest snapshot, tier-1 user content, tier-2 graduated content, notes) packed to fit ``budget_tokens``, plus a manifest accounting every token spent and every item truncated or dropped (CORE-RECALL-BUDGET-1). ``query`` ranks each section by relevance; omit it to rank by recency. ``sections`` overrides the default list/order/caps as ``{name, cap_tokens}`` entries. ``preset`` selects a named section set instead: pass ``"wakeup"`` with a small budget (~300 tokens) at session start for an L1 orientation card (active plan, anchors, workspace topics, last-session headline) — the default sections go degenerate at that size. Use ``get_working_context`` for the L2 drill-in. Returns ``{block, manifest}``.

Search memories using semantic similarity with optional hybrid mode. hop_strategy: consensus follows entities several top results agree on; relevance follows best-result entities and one-off bridges; semantic asks an LLM. since/until: ISO-8601 or relative (7d, 24h, 30m), echoed as an absolute window. as_of_date (ISO-8601) travels transaction time: what the system believed at that instant. include_superseded keeps replaced items visible in results (PLAT-AUDITABLE-MEMORY-1). include_retracted keeps WITHDRAWN beliefs visible (CORE-RETRACTED-RECALL-1) — a separate lifecycle state with no replacement, not covered by include_superseded. include_archived keeps ARCHIVED items visible (CORE-ARCHIVED-RECALL-1) — memories the decay/prune evolvers retired, or the source an episodic-to-semantic promotion replaced; a third lifecycle state, again with no replacement and no version chain. All three default to false, so by default you will not be shown a memory the system already knows was replaced, withdrawn, or retired. Results from an as_of_date search carry as_of_resolution. A value of "unresolved" means that result is PRESENT-DAY content the system could not resolve to the requested time, so it must not be cited as what was believed then. Set as_of_strict to refuse a partial history outright rather than receive labelled results (gap #2).

Auto-centered conversation read (CORE-RECALL-CENTERED-1 Phase 2). Given a matched conversation-chunk ``item_id`` (from a recall hit's ``conversation_handle``), return a char-budgeted ASYMMETRIC window of the surrounding conversation chunks (~``before_ratio`` back / ``after_ratio`` forward; leftover spills to the other side) plus a continue-cursor — so a caller pulls just the relevant slice of a long conversation into context instead of the whole transcript. "Centered" is over neighbour 15-turn chunks, not individual turns. Returns ``{window_items, window_text, handle, continue_cursor:{prev_pos, next_pos}, chars_used, char_budget}``. Pass a returned ``continue_cursor`` back as ``cursor`` to page further in one direction without overlap.

Switch to a different workspace/team.

Show current session: user, team, tier, and backend mode.