Herramienta MCP: items_getItems.

Devuelve la lista de productos y servicios de la compañía, con filtros opcionales y paginación (máximo 30 por página, por defecto 30).

Ejemplo de llamada JSON-RPC:

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

Úsala para descubrir productos, buscar por nombre, referencia, categoría o bodega, u obtener el ID de un ítem antes de consultar su detalle. Si ya conoces el ID del ítem, prefiere items_getItem: es más rápido y devuelve datos más completos.

Las consultas de stock (cantidades disponibles, existencias por bodega) se responden con itemsStock_get_item_stock (un ítem) o itemsStock_get_item_stock_summary (varios ítems), no con esta herramienta.

Filtros: query busca por nombre o descripción; name filtra por nombre exacto; reference por código de referencia (SKU); idItemCategory e idWarehouse filtran por categoría y bodega; type y status filtran por tipo y estado del ítem. order_field y order_direction solo se envían cuando el usuario pide explícitamente un orden específico.

fields añade campos extra separados por comas; inclúyelo solo con los campos que el usuario pidió explícitamente: itemVariants (IDs de las variantes hijas, por ejemplo antes de actualizar una variante), inventory (datos de stock), images, o editable,deletable (verificaciones de gestión y permisos). idGlobal se incluye siempre automáticamente y no debe añadirse a fields.

metadata y mode los inyecta el servidor automáticamente (metadata: true; mode: "simple" cuando no se piden campos extra o mode: "advanced" cuando se piden). Los clientes normalmente no deben enviarlos.

Paginación con start (desplazamiento desde 0; úsalo junto con limit) y limit (cantidad de ítems por página). Nunca envíes un limit mayor de 30: es el máximo permitido.

Solo lectura.