*MCP › Referencia › Plataforma › Campos personalizados*

# Listar definiciones de campos personalizados

> Devuelve las DEFINICIONES de los campos personalizados de la cuenta: qué identificador tiene cada uno, qué tipo admite y, si es un desplegable, qué valores acepta.

Te permite identificar un campo personalizado y los valores que acepta. La v1 solo lee campos personalizados: ningún cuerpo de creación o actualización los admite, así que se establecen en la aplicación de Filmo. No devuelve el valor asignado a ninguna entidad: los valores viajan dentro de cada recurso.

HERRAMIENTA `filmo_custom_fields_list` · `custom-fields:read` · 120/min · Puede requerir un add-on · Anotación del servidor: Solo lectura · Anotación del servidor: Idempotente

## Argumentos

| Nombre | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `applyAt` | string | No | Filtra por la entidad a la que se aplica el campo: devuelve solo las definiciones utilizables en ese tipo de recurso. `order`, `item`, `space`, `contact`, `project`, `kit`, `orderTemplate`, `repairTicket`, `serializedItem`, `vehicle`, `staff`, `service`, `purchaseOrder`, `incident`, `opportunity`, `document`, `all` |

## 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 de la definición. Es el que se usa al escribir un valor. |
| `name` | string | Nombre visible del campo. |
| `dataType` | string | Tipo de dato que acepta el campo. `text`, `multitext`, `dropdown`, `checkbox`, `radio`, `date`, `contact`, `item`, `space`, `staff_member`, `vehicle` |
| `description` | string | Descripción del campo; null si no tiene. |
| `options` | string[] | Valores permitidos cuando el campo es un desplegable. Vacío para los demás tipos. |
| `applyAt` | string[] | Entidades en las que se puede usar el campo. `order`, `item`, `space`, `contact`, `project`, `kit`, `orderTemplate`, `repairTicket`, `serializedItem`, `vehicle`, `staff`, `service`, `purchaseOrder`, `incident`, `opportunity`, `document`, `all` |
| `showOn` | string[] | Documentos en los que se imprime el campo. `quote`, `proforma`, `invoice`, `contract`, `packing_slip`, `purchase_order`, `repair_ticket`, `all` |
| `isActive` | boolean | true si la definición está activa y se puede usar. |
| `createdAt` | string<date-time> | Fecha de creación en ISO 8601 UTC; null si no consta. |
| `updatedAt` | string<date-time> | Fecha de la última modificación en ISO 8601 UTC; null si no está registrada. |

*Llamada · filmo_custom_fields_list*

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

*Resultado (generado desde el esquema)*

```json
{
  "structuredContent": {
    "data": [
      {
        "id": "id_8f2a1c",
        "name": "Example",
        "dataType": "text",
        "description": "<description>",
        "options": [
          "<options>"
        ],
        "applyAt": [
          "order"
        ],
        "showOn": [
          "quote"
        ],
        "isActive": true,
        "createdAt": "2026-09-01T08:00:00Z",
        "updatedAt": "2026-09-01T08:00:00Z"
      }
    ],
    "meta": {
      "rateLimit": {
        "limit": 120,
        "remaining": 119,
        "reset": 42
      }
    }
  }
}
```

## La misma operación por REST

Esta herramienta ejecuta [`GET /api/v1/custom-fields`](https://docs.filmo.io/es/rest-api/endpoint-reference/custom-fields/list-custom-field-definitions).

---

URL canónica: https://docs.filmo.io/es/mcp/tools/custom-fields/filmo-custom-fields-list  
Última actualización: 2026-10-25