Recursos

Referencia de herramientas MCP de WareRushAI

Las herramientas de lectura y escritura del servidor MCP de WareRushAI, sus ámbitos (scopes) y qué devuelven o modifican.

Revised:

1. get_account_info (ámbito account.read)

Devuelve la empresa del usuario autenticado, su rol, el plan de suscripción y los módulos activados. Los asistentes la llaman primero para saber de quién son los datos que están consultando.

2. list_warehouses (ámbito inventory.read)

Enumera los almacenes y ubicaciones de la empresa y cuáles de ellos están vinculados a una ubicación de Shopify.

3. search_products (ámbito catalog.read)

Busca productos por nombre, SKU, código de barras, marca o modelo y devuelve una fila resumida por producto con precio, categoría y stock. Los resultados están paginados; use get_product para obtener el registro completo.

4. get_product (ámbito catalog.read)

Devuelve los datos de un producto, su stock por ubicación y el estado de su publicación en marketplaces.

5. get_inventory_summary (ámbito inventory.read)

Devuelve la cantidad total de stock por ubicación, permitiendo al asistente responder cuánto stock tiene la empresa en cada almacén.

6. find_missing_product_data (ámbito catalog.read)

Encuentra productos que carecen de los datos necesarios para la venta (imagen, precio, categoría, descripción, código de barras y similares) e indica qué falta. Los resultados están paginados.

7. find_listing_problems (ámbito catalog.read)

Encuentra productos que no se publicaron en un marketplace o canal y explica el error con una solución en lenguaje sencillo, por ejemplo, un EAN faltante requerido por la categoría de Allegro.

8. find_unfulfilled_orders (ámbito orders.read)

Enumera los pedidos abiertos de tiendas online, marketplaces y B2B que aún no se han enviado, con su origen, partner y estado.

9. search_categories (ámbito catalog.read)

Busca en el árbol de categorías de producto por nombre y devuelve identificadores y rutas de categoría; update_product usa el identificador para asignar una categoría.

10. Cómo funcionan las herramientas de escritura

Las herramientas de escritura necesitan el ámbito catalog.write o inventory.write y el rol de propietario o administrador. Cada una funciona en dos pasos: con confirm=false solo devuelve una vista previa de los valores antiguos y nuevos; con confirm=true y expected_version (la versión del producto de la vista previa o de get_product) guarda. Si el producto cambió mientras tanto, se rechaza el guardado. Una llamada cambia un producto, cada cambio queda registrado con origen mcp y no se puede eliminar nada.

11. update_product (ámbito catalog.write)

Cambia el nombre, la descripción, la marca, el tipo, la categoría, el código de barras, el SKU, el precio de venta o el estado (activo o borrador) de un producto. Un precio fijado aquí cuenta como precio manual que la IA en segundo plano nunca sobrescribe. El SKU se cambia en una llamada aparte.

12. adjust_stock (ámbito inventory.write)

Establece, añade o resta stock de un producto en una ubicación mediante el movimiento de stock habitual, de modo que también se actualizan el registro de movimientos y la sincronización de stock con Shopify.

13. set_channel_listing (ámbito catalog.write)

Activa, desactiva o devuelve a la regla del canal un producto en un marketplace o canal. Los productos usados, reacondicionados o dañados nunca se pueden activar en canales que solo aceptan productos nuevos (eMAG, Árukereső, Árgép, Pepita).

14. create_product (ámbito catalog.write)

Crea un producto nuevo a partir de un código de barras o un nombre, opcionalmente con stock inicial en una ubicación. La IA en segundo plano lo identifica y completa el resto dentro del límite habitual de como máximo 5 llamadas de IA por producto; un código de barras existente nunca se duplica.