recall_context

公開 MCP ツール

recall_context

用途

構造化されたitemとtoken budgetで制限されたcontext textを含むbounded multi-memory context packを読み取ります。何も変更しません。

適用シーン

• sessionをまたいで作業を続けるために必要なproject、task、agent contextを復元する場合。
• 明示したitem数とtoken budgetの範囲で、promptを構成するために複数の関連memoryをまとめる場合。
• 1つのquick resultだけでは不十分なsession/taskの開始時に使います。

非推奨シーン

• 1件のquickでforgivingなlookupには使わないでください。recallを使います。
• strictでtargetedなmatchだけを受け入れる場合は使わないでください。search_memoryを使います。
• unboundedなhistory dumpを要求しないでください。max_itemsとmax_tokensは安全性とcontext qualityの制限です。
• REST APIはpublic MCP toolより広いfield setを受け付けます。scope、bucket、team、provenance filterについては/docs/api/memoryを参照してください。

必須スコープ

• memory:readが必要です。scope、bucket、team、agent boundaryは引き続きserverが適用します。

パラメーター

返却スキーマ

Public MCP profileはstructured objectではなくtextを返します。'### XMemo Context' headingと'Items: <n>' lineで始まり、resultがdropまたはshortenされた場合は'Budget: ...' lineを追加します。その後、各itemをliteral formの'Reference: <id> | Type: <type> | Location: <path>'で1行ずつ表示し、最後に'Context:' labelとbounded context bodyを続けます。一致するものがない場合は'No matching XMemo memory was found.'と表示します。referenceはopaque identifierとして扱ってください。Non-public profileはstructured pack（version、retrieval_plan、budget、items、context_text）を返せます。

使用例

recall_context({
  query: "recent decisions on the memory-os project",
  max_items: 6,
  max_tokens: 1200
})

エラー

• 401/403: requestにmemory:readがない、または該当する場合にtemporary-memory read capabilityがありません。
• 422: max_items、max_tokens、または明示的なlimitが対応するbudget/candidate範囲を超えています。
• Validation failure: queryまたは任意のfilterが不正な形式です。

関連ツール

• recall — 1件のquick answerには軽量なbest-effort pathを選びます。
• search_memory — 弱いresultが安全でない場合はstrict matchingを選びます。
• remember — capture policyの承認後に新しい永続contextを保存します。