# recall

agentがfocused answerを必要とするとき、関連する永続contextを取得します。recallは既定ですべてのmemoryを検索します。フルMCP tool surfaceでは、bucketを渡すとそのbucketだけを検索します。

- Canonical: https://docs.xmemo.dev/ja/docs/tools/recall
- Locale: ja-JP
- Content-Locale: ja-JP
- Canonical-Content-Digest: a5f520ad1f7164b71407d71502e21638cd59fcf0e2c2b3e0226ca364286b5bb5
- Edition-Digest: b3ee9303bb4742790d587568ad99bffdb5dd04784b475b06193cd8b69574ec65
- Source-Revision: sha256:27b29297ea0ca25f76efcb7223face20624379ddfff4699feaaedd6ba1f0fe42

## Tool Reference: `recall`

### Purpose

承認済みのmemory scopeからagentが集中した回答を必要とするとき、関連する永続contextを取得します。

### Parameters

- `query` (string, required): recallする自然言語の質問またはtopicです。
- `limit` (integer, optional, default: 5): quick lookup向けの少数の結果数です。範囲を限定してください。

### Returns

各memoryのreference、location、content、利用可能なattribution boundaryを含むranked text responseです。空のresultは有効なno-match responseであり、authorization signalではありません。

### Errors

- 401/403: requestに有効なbearer tokenがない、またはmemory:readがありません。
- Validation failure: query、limit、またはfilter syntaxが無効です。
- Scope or team mismatch: 要求されたboundaryは認証済みownerから見えません。

### Examples

#### Quick best-effort recall



```typescript
recall({
  query: "current MCP authentication decision",
  limit: 3
})
```

### Related Tools

- [search_memory](/docs/tools/search): strict matchingが必要な場合に、targetedな検索を使います。
- [recall_context](/docs/tools/recall-context): boundedなmulti-memory context packを使います。
- [remember](/docs/tools/remember): 明示的に永続化するfactまたはdecisionを保存します。

## 空のresultとfailureを見分ける

空のresultは有効なno-match answerです。credentialがない、または不十分な場合は、代わりに401または403でfailureになります。

```ts
recall({ query: "a topic that was never saved", limit: 3 })
// -> empty result set, HTTP 200
```