# recall_context

Restaura el contexto reciente del proyecto y del agente necesario para continuar el trabajo entre sesiones.

- Canonical: https://docs.xmemo.dev/es/docs/tools/recall-context
- Locale: es-ES
- Content-Locale: es-ES
- Canonical-Content-Digest: 0767dc0a1fcb4e59857a76cce464ac0c81e3dccf483200c4310a35325dccee22
- Edition-Digest: d80cdab83d8b6a1baf139991c2df3b6861299ee6038c7ca3db5e36db3b5d4176
- Source-Revision: sha256:0000db16929d847dd06d0f100593276843962eb54fb925e1a5f66997e039974c

## Tool Reference: `recall_context`

### Purpose

Lee un paquete de contexto acotado de varias memorias, con elementos estructurados y texto limitado por presupuesto de tokens; no modifica nada.

### Parameters

- `query` (string, required): Consulta en lenguaje natural para la que se construye el paquete de contexto.
- `max_items` (integer, optional, default: 8): Número máximo de memorias del paquete (1-50).
- `max_tokens` (integer, optional, default: 1500): Longitud máxima del contexto renderizado en tokens (1-12000).

### Returns

El perfil MCP público devuelve texto, no un objeto estructurado. Comienza con el encabezado '### XMemo Context' y una línea 'Items: <n>'; añade una línea 'Budget: ...' cuando se descartan o acortan resultados, después una línea por elemento con la forma literal 'Reference: <id> | Type: <type> | Location: <path>', y finalmente la etiqueta 'Context:' seguida del cuerpo de contexto limitado. Los perfiles no públicos pueden devolver el paquete estructurado (version, retrieval_plan, budget, items, context_text). Trata la referencia como un identificador opaco.

### Errors

- 401/403: falta memory:read o, cuando corresponde, la capacidad de lectura de memoria temporal.
- 422: max_items, max_tokens o un limit explícito está fuera de los límites admitidos de presupuesto/candidatos.
- Error de validación: query o uno de los filtros opcionales tiene un formato incorrecto.

### Examples

#### Restaura el contexto antes de una tarea



```typescript
recall_context({
  query: "recent decisions on the memory-os project",
  max_items: 6,
  max_tokens: 1200
})
```

### Related Tools

- [recall](/docs/tools/recall): Elige la ruta ligera de mejor esfuerzo para una respuesta rápida.
- [search_memory](/docs/tools/search): Elige coincidencias estrictas cuando los resultados débiles sean inseguros.
- [remember](/docs/tools/remember): Conserva contexto duradero nuevo después de que la política de captura lo apruebe.

## Comprueba el presupuesto realmente utilizado

La respuesta informa de used_items y used_tokens, lo que permite distinguir una respuesta realmente pequeña de una truncada.

```ts
recall_context({ query: "recent decisions", max_items: 6, max_tokens: 1200 })
```