# Mejoras recomendadas

`list_improvements`

Acciones recomendadas por Bison para mejorar la visibilidad, por prioridad, con impacto, esfuerzo y pasos. Cada una trae su jugada de la metodología (play, family), nivel, cuadrante, estado del entregable, plan y fecha de verificación.

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

## Parámetros

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `status` | una de `pending`, `done`, `dismissed`, `resolved`, `all` | No | Estado a listar; pending por defecto. |
| `limit` | entero (1 a 50) | No | Máximo de mejoras; 10 por defecto. |
| `play` | texto (hasta 10 caracteres) | No | Jugada de la metodología, p. ej. CON-06. |
| `family` | texto (hasta 5 caracteres) | No | Familia: IDE, TEC, CON, AUT, REP, PRE, COM o MED. |
| `format` | una de `task`, `plan` | No | task (tarea suelta) o plan (paso de un plan). |
| `level_min` | entero (1 a 5) | No | Nivel mínimo (3: con datos de la marca; 4: con entregable). |
| `quadrant` | una de `quick_win`, `bet`, `incremental`, `questionable` | No | Cuadrante impacto × esfuerzo. |
| `plan_id` | texto (hasta 200 caracteres) | No | Solo los pasos de este plan. |
| `deliverable_status` | una de `pending`, `ready`, `stale` | No | Estado del entregable: pending (en preparación), ready o stale. |

## 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_improvements",
    "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": 2,
  "improvements": [
    {
      "id": "mej_listas",
      "title": "Entra a las listas «mejores seguros» que cita la IA",
      "description": "Paso 2 de 3: contactos enviados. La IA cita 7 veces listas comparadoras.",
      "status": "pending",
      "impact": "medium",
      "effort": "medium",
      "area": null,
      "source": "onboarding",
      "steps": [
        {
          "text": "Envía el pitch a los comparadores",
          "done": false
        }
      ],
      "competitors": [],
      "play": "AUT-02",
      "family": "AUT",
      "format": "plan",
      "level": 4,
      "quadrant": "quick_win",
      "priority_score": 81,
      "deliverable_status": "ready",
      "plan": {
        "id": "AUT-02:site:site",
        "stage": 2,
        "stage_total": 3
      },
      "verification": {
        "metric": "source_presence",
        "due_at": "2026-12-21T00:00:00.000Z"
      }
    },
    {
      "id": "mej_llms_txt",
      "title": "Publicar un archivo llms.txt",
      "description": "Tu sitio no tiene llms.txt: los asistentes de IA no encuentran un resumen de tu oferta.",
      "status": "pending",
      "impact": "high",
      "effort": "low",
      "area": "technical",
      "source": null,
      "steps": [
        {
          "text": "Crear el archivo /llms.txt con tus productos y enlaces clave",
          "done": false
        },
        {
          "text": "Subirlo a la raíz del sitio",
          "done": false
        },
        {
          "text": "Volver a auditar",
          "done": false
        }
      ],
      "competitors": [],
      "play": null,
      "family": null,
      "format": null,
      "level": null,
      "quadrant": null,
      "priority_score": 74,
      "deliverable_status": null,
      "plan": null,
      "verification": null
    }
  ]
}
```