# Preguntas frecuentes

`list_faqs`

FAQs de la marca preparadas para IA (pregunta, respuesta, si está publicada y qué datos faltan), más nuevas primero.

**Permiso:** Lectura. Funciona con cualquier token.

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `status` | texto (hasta 40 caracteres) | No | Filtrar por estado exacto (p. ej. active). |
| `limit` | entero (1 a 100) | No | Máximo; 20 por defecto. |

## Ejemplo de llamada

No tienes que escribir esto: tu agente decide cuándo usar la herramienta según lo que le pidas. Es la llamada MCP equivalente, con valores de relleno:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "list_faqs",
    "arguments": {}
  }
}
```

## Ejemplo de respuesta

Lo que devuelve con `{"limit":2}`, para una marca ficticia («Altavista Seguros»). Tu respuesta tendrá los datos de tu empresa.

```json
{
  "total": 1,
  "faqs": [
    {
      "id": "faq_01",
      "question": "¿El seguro cubre el robo del auto?",
      "answer": "Sí, la cobertura completa incluye robo total y parcial, con el deducible que indica tu póliza.",
      "status": "active",
      "implemented": false,
      "category": null,
      "promptId": null,
      "missingData": []
    }
  ]
}
```