# recall

Recupera contexto duradero relevante cuando un agente necesita una respuesta concreta. Recall busca en todas tus memorias de forma predeterminada; en la superficie completa de herramientas MCP, pasa bucket para buscar solo en un bucket.

- Canonical: https://docs.xmemo.dev/es/docs/tools/recall
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: a5f520ad1f7164b71407d71502e21638cd59fcf0e2c2b3e0226ca364286b5bb5
- Edition-Digest: f89faa950162f06fada7ddf5fb5b63a295c04f3523b5d90e57b76bc43614304b
- Source-Revision: sha256:27b29297ea0ca25f76efcb7223face20624379ddfff4699feaaedd6ba1f0fe42

## Tool Reference: `recall`

### Purpose

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

### Parameters

- `query` (string, required): Pregunta o tema en lenguaje natural que se quiere recuperar.
- `limit` (integer, optional, default: 5): Cantidad pequeña de resultados; mantenla acotada para una consulta rápida.

### Returns

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.

### Errors

- 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.

### Examples

#### Recuperación rápida de mejor esfuerzo



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

### Related Tools

- [search_memory](/docs/tools/search): Usa coincidencias estrictas y dirigidas con filtros de proyecto/equipo.
- [recall_context](/docs/tools/recall-context): Usa un paquete de contexto acotado con varias memorias.
- [remember](/docs/tools/remember): Conserva un hecho o una decisión explícitamente duraderos.

## Distingue un resultado vacío de un fallo

Un resultado vacío es una respuesta válida cuando no hay coincidencias. Una credencial ausente o insuficiente produce 401 o 403.

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