*MCP › Referencia › Catálogo e inventario › Espacios* # Listar almacenes y espacios > Devuelve los almacenes y espacios alquilables de la cuenta, paginados por cursor. Un espacio con `isWarehouse: true` es un almacén que gestiona stock; con `false` es un espacio alquilable (un estudio, una sala). Filtra por `isWarehouse` para quedarte con un tipo u otro. No emite costes ni configuración de precios. HERRAMIENTA `filmo_spaces_list` · `spaces:read` · 120/min · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente ## Argumentos | Nombre | Tipo | Obligatorio | Descripción | | --- | --- | --- | --- | | `limit` | integer | No | Tamaño de página (1-500). Por defecto es 50. = `50` | | `cursor` | string | No | Cursor opaco de la página que se devuelve. Pasa el valor de `pagination.nextCursor` de la respuesta anterior; trátalo como opaco. | | `sort` | string | No | Orden: hasta 3 campos separados por comas, cada uno con un "-" inicial para descendente (p. ej. "-updatedAt,name"). Campos ordenables: createdAt, updatedAt, name, internalReference, isWarehouse, building, floor. Por defecto, "-createdAt". Los empates se resuelven por id, así que el orden es estable entre páginas, y un cursor queda ligado al orden con el que se emitió. | | `isWarehouse` | boolean | No | Filtra por naturaleza del espacio: "true" devuelve solo almacenes (los que gestionan stock), "false" solo espacios alquilables. Si se omite, se devuelven ambos. | | `collectionId` | string | No | Filtra por identificador de la colección a la que pertenece el espacio. | | `collectionIds` | string[] | No | Filtra por collectionId, como lista: repite el parámetro o separa los valores con comas. Acepta hasta 50 valores y devuelve lo que coincida con cualquiera de ellos. | | `includeTotal` | boolean | No | Ponlo en true para incluir `pagination.total`, el número de resultados que coinciden con los filtros en todas las páginas. Desactivado por defecto. = `false` | | `dateFilters` | object | No | Filtros de fecha por campo. Una fecha sin hora (YYYY-MM-DD) se lee en la zona horaria del negocio; un instante ISO 8601 con desplazamiento se aplica tal cual con gte, lte, gt y lt, mientras que on lo amplía al día completo del negocio que lo contiene. Campos: created, updated. | | `dateFilters.created` | object | No | | | `dateFilters.created.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.created.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.created.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.created.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.created.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | | `dateFilters.updated` | object | No | | | `dateFilters.updated.gte` | string | No | Desde este día o instante, inclusive. | | `dateFilters.updated.lte` | string | No | Hasta este día o instante, inclusive. | | `dateFilters.updated.gt` | string | No | Estrictamente posterior; una fecha sin hora significa después del final de ese día. | | `dateFilters.updated.lt` | string | No | Estrictamente anterior; una fecha sin hora significa antes del inicio de ese día. | | `dateFilters.updated.on` | string | No | Exactamente ese día; un instante significa toda la jornada del negocio que lo contiene. | ## Resultado En un éxito el resultado lleva `structuredContent` con `data` y `meta`. Estos son los atributos de `data`. | Nombre | Tipo | Descripción | | --- | --- | --- | | `id` | string | Identificador único del espacio. | | `name` | string | Nombre del espacio. | | `internalReference` | string | Referencia interna del espacio, útil para casarla con sistemas externos; null si no tiene. | | `isWarehouse` | boolean | true si el espacio es un almacén que gestiona stock y puede ser el almacén principal de un pedido; false si es un espacio alquilable. | | `collectionId` | string | Identificador de la colección a la que pertenece; null si no está en ninguna. | | `collectionName` | string | Ruta completa de la colección, por ejemplo "Estudios > Fotografía"; null si no aplica. | | `building` | string | Edificio en el que se encuentra; null si no aplica. | | `floor` | number | Planta en la que se encuentra; null si no aplica. | | `location` | object | Ubicación física del espacio. | | `location.address` | string | Dirección postal; null si no se ha registrado. | | `location.city` | string | Municipio; null si no está registrado. | | `location.postalCode` | string | Código postal; null si no se ha registrado. | | `location.country` | string | País; null si no consta. | | `location.lat` | number | Latitud en grados decimales; null si no está geolocalizado. | | `location.lng` | number | Longitud en grados decimales; null si no está geolocalizado. | | `createdAt` | string | Fecha de creación en ISO 8601 UTC. | | `updatedAt` | string | Fecha de la última modificación en ISO 8601 UTC. | *Llamada · filmo_spaces_list* ```json { "jsonrpc": "2.0", "id": 1, "method": "tools/call", "params": { "name": "filmo_spaces_list", "arguments": { "limit": 20 } } } ``` *Resultado (generado desde el esquema)* ```json { "structuredContent": { "data": [ { "id": "id_8f2a1c", "name": "Example", "internalReference": "", "isWarehouse": true, "collectionId": "coll_8f2a1c", "collectionName": "Example", "building": "", "floor": 1, "location": { "address": "
", "city": "", "postalCode": "", "country": "ES", "lat": 1, "lng": 1 }, "createdAt": "2026-09-01T08:00:00Z", "updatedAt": "2026-09-01T08:00:00Z" } ], "pagination": { "nextCursor": "eyJvIjo1MH0", "hasMore": true, "total": 1 }, "meta": { "rateLimit": { "limit": 120, "remaining": 119, "reset": 42 } } } } ``` ## La misma operación por REST Esta herramienta ejecuta [`GET /api/v1/spaces`](https://docs.filmo.io/es/rest-api/endpoint-reference/spaces/list-warehouses-and-spaces). --- URL canónica: https://docs.filmo.io/es/mcp/tools/spaces/filmo-spaces-list Última actualización: 2026-10-25