# recall

Rufen Sie relevanten dauerhaften Kontext ab, wenn ein Agent eine gezielte Antwort benötigt. Recall durchsucht standardmäßig alle Ihre Erinnerungen; auf der vollständigen MCP-Tool-Oberfläche übergeben Sie bucket, um nur einen Bucket zu durchsuchen.

- Canonical: https://docs.xmemo.dev/de/docs/tools/recall
- Locale: de-DE
- Content-Locale: de-DE
- Canonical-Content-Digest: a5f520ad1f7164b71407d71502e21638cd59fcf0e2c2b3e0226ca364286b5bb5
- Edition-Digest: 07dde551e19d49f090a2413af51569aa62daf494c25a2c039aa9794faef47a3b
- Source-Revision: sha256:27b29297ea0ca25f76efcb7223face20624379ddfff4699feaaedd6ba1f0fe42

## Tool Reference: `recall`

### Purpose

Einen schlanken, fehlertoleranten Best-Effort-Abruf ausführen und die wenigen relevantesten gespeicherten Erinnerungen vor dem Antworten zurückgeben.

### Parameters

- `query` (string, required): Natürlichsprachliche Suchanfrage oder Frage zur Suche nach relevanten Erinnerungen.
- `limit` (integer, optional, default: 5): Maximale Anzahl zurückzugebender Erinnerungen, begrenzt von 1 bis 10.

### Returns

Eine bewertete Textantwort, die jede Speicherreferenz, den Ort, den Inhalt und die verfügbare Herkunftsgrenze enthält. Leere Ergebnisse stellen eine gültige Antwort ohne Treffer dar, kein Autorisierungssignal.

### Errors

- 401/403: Das MCP-Token fehlt oder enthält nicht memory:read.
- Validierungsfehler: Die Suchanfrage ist leer oder das Limit liegt außerhalb des zulässigen Bereichs.
- Sicherheitsablehnung: Eine bösartige oder reservierte Abfragestruktur wird blockiert.

### Examples

#### Schneller Best-Effort-Abruf



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

### Related Tools

- [search_memory](/docs/tools/search): Strikte bereichsbezogene Suche verwenden, wenn der genaue Projektpfad bekannt ist.
- [recall_context](/docs/tools/recall-context): Ein budgetiertes Kontextpaket für eine längere Agentenaufgabe zusammenstellen.
- [remember](/docs/tools/remember): Einen neuen dauerhaften Fakt speichern, nachdem ein Wissensdefizit festgestellt wurde.

## Ein leeres Ergebnis von einem Fehler unterscheiden

Ein leeres Ergebnis ist eine gültige Rückmeldung ohne Treffer. Fehlende oder unzureichende Anmeldedaten schlagen stattdessen mit 401 oder 403 fehl.

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