---
title: "Listar atributos de variante"
method: POST
path: "/tools/variant_getVariantAttributes"
tags: ["Items"]
---

# Listar atributos de variante

`POST /tools/variant_getVariantAttributes`

## Request

- Base URL: `https://mcp.alegra.com`
- URL: `https://mcp.alegra.com/tools/variant_getVariantAttributes`
- Auth: HTTP bearer

Herramienta MCP: `variant_getVariantAttributes`.

Devuelve la lista de atributos de variante (por ejemplo `Color`, `Talla`), con filtros opcionales y paginación.

Ejemplo de llamada JSON-RPC:

```json
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "variant_getVariantAttributes",
    "arguments": { "start": 0, "limit": 30 }
  }
}
```

Úsala para descubrir los atributos de variante disponibles, buscarlos por nombre o por valor de opción, u obtener sus IDs antes de cualquier consulta posterior. Si ya conoces el ID, prefiere `variant_getVariantAttribute`: hace la consulta en una sola llamada.

`fields` admite `editable,deletable`, útil para verificar permisos de gestión sobre un atributo. `order_field` acepta `name` como valor válido; `order_direction` acepta `ASC` o `DESC`.

Paginación con `start` (desplazamiento desde 0) y `limit` (cantidad de registros por página). El máximo es 30 y por defecto 30; enviar un valor mayor produce un error. Con `metadata: true` la respuesta se envuelve como `{ data: [...], metadata: { total } }`.

Solo lectura.

## Request body

- object
  - `limit` integer: Cantidad de registros a devolver. Por defecto 30 y máximo 30; enviar un valor mayor produce un error.
  - `start` integer: Desplazamiento de paginación (desde 0). Por ejemplo, para empezar en el registro 20 envía `start: 20`.
  - `metadata` boolean: Si es true, la respuesta se envuelve como { data: [...], metadata: { total } }, donde total es la cantidad completa de atributos de variante de la cuenta.
  - `name` string: Filtra los atributos de variante por nombre.
  - `options` string: Filtra los atributos de variante por valor de opción.
  - `fields` string: Campos extra a incluir. Valores válidos: `editable`, `deletable`.
  - `order_direction` 'ASC' | 'DESC': Dirección del orden: `ASC` o `DESC`.
  - `order_field` string: Campo por el que ordenar. Valor válido: `name`.

## Response `200`

Lista de atributos de variante

## Other responses

- `401`: No autorizado (token de Alegra inválido o expirado).

---

[API](https://skmtc.dev/alegra/apis/mcp-alegra.md) - [All operations](https://skmtc.dev/alegra/apis/mcp-alegra/llms.txt) - [OpenAPI document](https://skmtc.dev/alegra/apis/mcp-alegra/revisions/528447af020b?raw)