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.
