recall

Herramienta MCP pública

recall

Propósito

Realiza una búsqueda ligera, flexible y de mejor esfuerzo, y devuelve las pocas memorias guardadas más relevantes antes de responder.

Cuándo usar

• Necesitas una respuesta rápida sin alcance, y es aceptable una relevancia aproximada pero útil.
• El llamador quiere un conjunto pequeño y ordenado de memorias, no un paquete de contexto del tamaño de un prompt.
• Una comprobación al inicio de la tarea necesita contexto de trabajo reciente sin un filtro estricto de proyecto/equipo.

Cuándo NO usar

• No lo uses cuando no debas presentar una coincidencia débil como respuesta; usa search_memory para coincidencias estrictas.
• No lo uses para reunir varias memorias acotadas para una inyección de prompt; usa recall_context.
• No lo uses para escribir, actualizar ni eliminar memorias.
• La API REST acepta un conjunto de campos más amplio que la herramienta MCP pública; consulta /docs/api/memory para los filtros de scope, bucket, team y provenance.

Ámbito requerido

• Se requiere memory:read; las memorias devueltas siguen limitadas al scope del owner/equipo autenticado.

Parámetros

Esquema de retorno

Respuesta de texto ordenada que contiene la referencia, ubicación, contenido y límite de atribución disponible de cada memoria. Los resultados vacíos son una respuesta válida cuando no hay coincidencias, no una señal de autorización.

Ejemplos

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

Errores

• 401/403: la solicitud no tiene un bearer token válido o carece de memory:read.
• Error de validación: la sintaxis de query, limit o los filtros no es válida.
• Desajuste de scope o equipo: el owner autenticado no puede ver el límite solicitado.

Herramientas relacionadas

• search_memory — Usa coincidencias estrictas y dirigidas con filtros de proyecto/equipo.
• recall_context — Usa un paquete de contexto acotado con varias memorias.
• remember — Conserva un hecho o una decisión explícitamente duraderos.