# recall

agent에게 focused answer가 필요할 때 관련 있는 영구 context를 검색합니다. recall은 기본적으로 모든 memory를 검색하며, 전체 MCP tool surface에서는 bucket을 전달하면 해당 bucket만 검색합니다.

- Canonical: https://docs.xmemo.dev/ko/docs/tools/recall
- Locale: ko-KR
- Content-Locale: ko-KR
- Canonical-Content-Digest: a5f520ad1f7164b71407d71502e21638cd59fcf0e2c2b3e0226ca364286b5bb5
- Edition-Digest: 72b1801a5b71f101acced95024b3e7b1700d0af190a33e712e32855f373bd7eb
- Source-Revision: sha256:27b29297ea0ca25f76efcb7223face20624379ddfff4699feaaedd6ba1f0fe42

## Tool Reference: `recall`

### Purpose

가볍고 유연한 best-effort lookup을 수행하고 답변 전에 저장된 memory 중 가장 관련 있는 몇 개를 반환합니다.

### Parameters

- `query` (string, required): recall할 자연어 질문 또는 topic입니다.
- `limit` (integer, optional, default: 5): 빠른 lookup을 위해 제한된 작은 결과 수입니다.

### Returns

각 memory reference, location, content 및 사용 가능한 attribution boundary를 포함한 ranked text 응답입니다. 빈 결과는 authorization signal이 아니라 유효한 no-match 응답입니다.

### Errors

- 401/403: 요청에 유효한 bearer token이 없거나 memory:read가 없습니다.
- Validation failure: query, limit 또는 filter syntax가 유효하지 않습니다.
- Scope 또는 team mismatch: 요청한 boundary가 인증된 owner에게 보이지 않습니다.

### Examples

#### 빠른 best-effort recall



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

### Related Tools

- [search_memory](/docs/tools/search): project/team filter를 사용한 엄격한 targeted matching을 수행합니다.
- [recall_context](/docs/tools/recall-context): 범위가 제한된 multi-memory context pack을 사용합니다.
- [remember](/docs/tools/remember): 명시적으로 영구적인 fact 또는 decision을 저장합니다.

## 빈 결과와 실패 구분하기

빈 결과는 유효한 no-match 응답입니다. 자격 증명이 없거나 부족하면 대신 401 또는 403으로 실패합니다.

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