recall

Distinguer un résultat vide d'un échec

Un résultat vide est une réponse valide d'absence de correspondance. Un identifiant manquant ou insuffisant échoue plutôt avec un code 401 ou 403.

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

Outil MCP public

recall

Objectif

Effectuer une recherche légère au mieux (best-effort) et tolérante pour renvoyer les quelques mémoires enregistrées les plus pertinentes avant de répondre.

Quand l'utiliser

Vous avez besoin d'une réponse rapide sans périmètre strict, et une pertinence approximative mais utile est acceptable.
L'appelant souhaite un petit ensemble classé de mémoires plutôt qu'un pack de contexte dimensionné pour un prompt.
Une vérification au début d'une tâche nécessite un contexte de travail récent sans filtre strict de projet ou d'équipe.

Quand NE PAS l'utiliser

Ne l'utilisez pas lorsqu'une correspondance approximative ne doit pas être présentée comme réponse ; utilisez search_memory pour une correspondance stricte.
Ne l'utilisez pas pour rassembler plusieurs mémoires délimitées destinées à l'injection de prompt ; utilisez recall_context.
Ne l'utilisez pas pour écrire, mettre à jour ou supprimer de la mémoire.
L'API REST accepte un ensemble de champs plus large que l'outil MCP public ; consultez /docs/api/memory pour les filtres de périmètre, bucket, équipe et provenance.

Périmètre requis

memory:read est requis ; les mémoires renvoyées restent délimitées par le périmètre du propriétaire/de l'équipe authentifié.

Paramètres

Nom	Type	Description
`query`	string · requis	Question ou sujet en langage naturel à rappeler.
`limit`	integer · par défaut : 5	Nombre restreint de résultats ; gardez-le délimité pour une recherche rapide.

Schéma de retour

Une réponse textuelle classée contenant chaque référence de mémoire, emplacement, contenu et limite d'attribution disponible. Les résultats vides constituent une réponse valide d'absence de correspondance, et non un signal d'autorisation.

Exemples

Rappel rapide au mieux (best-effort)

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

Erreurs

401/403 : la requête ne dispose pas d'un jeton porteur valide ou manque de memory:read.
Échec de validation : la syntaxe de la requête, de la limite ou des filtres est invalide.
Non-concordance de périmètre ou d'équipe : la limite demandée n'est pas visible pour le propriétaire authentifié.

search_memory — Utiliser une correspondance ciblée stricte avec des filtres de projet/équipe.
recall_context — Utiliser un pack de contexte multi-mémoires délimité.
remember — Persister un fait ou une décision explicitement durable.

Source : Surface des outils MCP