*MCP › Referencia › Operaciones › Personal*

# Comprobar la disponibilidad del personal

> Devuelve, para cada miembro del personal (todo el equipo, o los seleccionados por `staffIds`, `tags`, `collectionId` o `search`), si tiene compromisos que se solapan con la ventana consultada y cuáles, tipificados: líneas de pedido, servicios internos, ausencias declaradas e incidencias bloqueantes.

A diferencia de `/api/v1/availability/check`, la respuesta NO es aritmética de stock: una persona no tiene conjunto, o está libre o está en un trabajo concreto. Un identificador solicitado que no existe vuelve como `error` por elemento. Consulta idempotente (POST por el cuerpo estructurado). Comparte la cuota de disponibilidad de 30 req/min.

HERRAMIENTA `filmo_staff_availability_check` · `staff:read` · 120/min · + 30/min de disponibilidad · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `startDate` | string<date-time> | Sí | Inicio de la ventana a comprobar (ISO 8601 con desplazamiento). |
| `endDate` | string<date-time> | Sí | Fin de la ventana que se comprueba (ISO 8601 con desplazamiento); debe ser posterior a startDate. |
| `tags` | string[] | No | Solo los recursos que tengan TODOS estos identificadores de etiqueta. |
| `collectionId` | string | No | Solo los recursos de esta colección. |
| `search` | string | No | Búsqueda de texto libre en el nombre. |
| `staffIds` | string[] | No | Limita la respuesta a estos miembros del personal (1-100). Un identificador que no existe vuelve como error por elemento. |

## Resultado

En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`.

*Llamada · filmo_staff_availability_check*

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "filmo_staff_availability_check",
    "arguments": {
      "startDate": "2026-09-01T08:00:00Z",
      "endDate": "2026-09-01T08:00:00Z"
    }
  }
}
```

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "resourceId": "reso_8f2a1c",
        "name": "Example",
        "available": true,
        "commitments": [
          {
            "kind": "order",
            "orderId": "orde_8f2a1c",
            "orderNumber": "<orderNumber>",
            "label": "Example",
            "startDate": "2026-09-01T08:00:00Z",
            "endDate": "2026-09-01T08:00:00Z"
          }
        ]
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## Prompts de ejemplo

*Prompt*

```text
¿Qué miembros del equipo están libres el 20 de enero?
```

## La misma operación por REST

Esta herramienta ejecuta [`POST /api/v1/staff/availability`](https://docs.filmo.io/es/rest-api/endpoint-reference/staff/check-staff-availability).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/staff/filmo-staff-availability-check  
Última actualización: 2026-10-25