@yoryoboy/bi-mcp 1.11.0 → 1.13.0

package/dist/index.js

@@ -45,7 +45,17 @@ import {
   associateSpecificationSchema,
   attachCatalogImageHandler,
   attachCatalogImageSchema,
+  addSkuEanHandler,
+  addSkuEanSchema,
   cancelOrderHandler,
+  getSkuImagesHandler,
+  getSkuImagesSchema,
+  replaceSkuEansHandler,
+  replaceSkuEansSchema,
+  updateCatalogImageHandler,
+  updateCatalogImageSchema,
+  updateProductBrandHandler,
+  updateProductBrandSchema,
   cancelOrderSchema,
   channelMixHandler,
   channelMixSchema,
@@ -55,20 +65,48 @@ import {
   createBrandSchema,
   createCategoryHandler,
   createCategorySchema,
+  deleteAllProductSpecificationsHandler,
+  deleteAllProductSpecificationsSchema,
+  deleteAllSkuSpecificationsHandler,
+  deleteAllSkuSpecificationsSchema,
+  deleteBrandHandler,
+  deleteBrandSchema,
+  deleteCatalogImageHandler,
+  deleteCatalogImageSchema,
+  deleteProductSpecificationHandler,
+  deleteProductSpecificationSchema,
+  deleteSkuSpecificationHandler,
+  deleteSkuSpecificationSchema,
+  getBrandHandler,
+  getBrandSchema,
+  listSpecificationGroupsHandler,
+  listSpecificationGroupsSchema,
+  moveCategoryHandler,
+  moveCategorySchema,
   createProductHandler,
   createProductSchema,
-  createProductWithSkuHandler,
-  createProductWithSkuSchema,
   createSkuHandler,
   createSkuSchema,
   createSpecificationHandler,
   createSpecificationSchema,
   createSpecificationValueHandler,
   createSpecificationValueSchema,
+  getCategoryHandler,
+  getCategorySchema,
+  getCategoryTreeHandler,
+  getCategoryTreeSchema,
+  getProductHandler,
+  getProductSchema,
+  getProductSpecificationsHandler,
+  getProductSpecificationsSchema,
+  getSkuHandler,
+  getSkuSchema,
   deactivateSkuHandler,
   deactivateSkuSchema,
   deleteFixedPriceHandler,
   deleteFixedPriceSchema,
+  deleteSkuPriceHandler,
+  deleteSkuPriceSchema,
   ecommerceTrackingHealthHandler,
   ecommerceTrackingHealthSchema,
   engagementOverviewHandler,
@@ -79,6 +117,16 @@ import {
   inventoryCheckSchema,
   listAccessiblePropertiesHandler,
   listAccessiblePropertiesSchema,
+  listBrandsHandler,
+  listBrandsSchema,
+  listCategoriesHandler,
+  listCategoriesSchema,
+  listProductsHandler,
+  listProductsByCategoryHandler,
+  listProductsByCategorySchema,
+  listProductsSchema,
+  listSkusByProductHandler,
+  listSkusByProductSchema,
   metaAccountOverviewHandler,
   metaAccountOverviewSchema,
   metaAdAccountInfoHandler,
@@ -149,6 +197,10 @@ import {
   updateInventorySchema,
   updateLeadTimeHandler,
   updateLeadTimeSchema,
+  updateCategoryHandler,
+  updateCategorySchema,
+  updateBrandHandler,
+  updateBrandSchema,
   updateProductBasicFieldsHandler,
   updateProductBasicFieldsSchema,
   updateSkuBasicFieldsHandler,
@@ -433,6 +485,19 @@ server.tool(
   },
   updateSkuPriceHandler
 );
+server.tool(
+  {
+    name: "vtex_delete_sku_price",
+    description: "Delete all base pricing and fixed prices for one SKU from VTEX Pricing. Before using this tool, the assistant must explain that this removes the SKU price record, mention that all fixed prices under that SKU are removed as well, and obtain explicit confirmation from the user. Only then should the tool be called with confirmed=true.",
+    schema: deleteSkuPriceSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteSkuPriceHandler
+);
 server.tool(
   {
     name: "vtex_upsert_fixed_price",
@@ -539,16 +604,16 @@ server.tool(
 );
 server.tool(
   {
-    name: "vtex_create_product_with_sku",
-    description: "Create one VTEX product and one SKU in a single operation. Use this when the product does not exist yet and you want the initial SKU created immediately after the product.",
-    schema: createProductWithSkuSchema,
+    name: "vtex_get_brand",
+    description: "Get one VTEX catalog brand by ID.",
+    schema: getBrandSchema,
     annotations: {
-      readOnlyHint: false,
-      destructiveHint: true,
+      readOnlyHint: true,
+      destructiveHint: false,
       openWorldHint: true
     }
   },
-  createProductWithSkuHandler
+  getBrandHandler
 );
 server.tool(
   {
@@ -563,6 +628,45 @@ server.tool(
   },
   createBrandHandler
 );
+server.tool(
+  {
+    name: "vtex_update_brand",
+    description: "Update selected fields on one VTEX catalog brand. Only the provided fields are changed; the tool keeps the current VTEX values for the rest.",
+    schema: updateBrandSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  updateBrandHandler
+);
+server.tool(
+  {
+    name: "vtex_list_specification_groups",
+    description: "List VTEX specification groups available for one category, optionally filtered by group name. Use this to discover a real field group before creating mock-only specifications.",
+    schema: listSpecificationGroupsSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  listSpecificationGroupsHandler
+);
+server.tool(
+  {
+    name: "vtex_get_product_specifications",
+    description: "Get all specifications currently associated with one VTEX catalog product.",
+    schema: getProductSpecificationsSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  getProductSpecificationsHandler
+);
 server.tool(
   {
     name: "vtex_create_category",
@@ -576,6 +680,32 @@ server.tool(
   },
   createCategoryHandler
 );
+server.tool(
+  {
+    name: "vtex_update_category",
+    description: "Update selected visible fields on one VTEX category, including activation through isActive. Use this tool for visible fields only, not hierarchy changes.",
+    schema: updateCategorySchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  updateCategoryHandler
+);
+server.tool(
+  {
+    name: "vtex_move_category",
+    description: "Move one VTEX category under a different parent by changing only its hierarchy. Experimental/high-risk: VTEX officially warns that direct category-tree moves can be risky and may leave catalog inconsistencies. Supports preview/apply confirmation guardrails.",
+    schema: moveCategorySchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  moveCategoryHandler
+);
 server.tool(
   {
     name: "vtex_create_specification",
@@ -615,6 +745,84 @@ server.tool(
   },
   associateSpecificationHandler
 );
+server.tool(
+  {
+    name: "vtex_delete_product_specification",
+    description: "Delete one specification association from one VTEX catalog product using the productId and the association/spec record ID (`Id` from `vtex_get_product_specifications`), not the field ID.",
+    schema: deleteProductSpecificationSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteProductSpecificationHandler
+);
+server.tool(
+  {
+    name: "vtex_delete_all_product_specifications",
+    description: "Delete all specification associations from one VTEX catalog product. This is high-risk and requires explicit confirmation before execution.",
+    schema: deleteAllProductSpecificationsSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteAllProductSpecificationsHandler
+);
+server.tool(
+  {
+    name: "vtex_delete_brand",
+    description: "Delete one VTEX catalog brand by ID. The caller must already know the brandId because this tool performs no pre-delete lookup or readback.",
+    schema: deleteBrandSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteBrandHandler
+);
+server.tool(
+  {
+    name: "vtex_delete_catalog_image",
+    description: "Delete one catalog image from a VTEX SKU by imageId. The caller must already know the imageId, typically from vtex_get_sku_images, because this tool performs no pre-delete lookup or readback.",
+    schema: deleteCatalogImageSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteCatalogImageHandler
+);
+server.tool(
+  {
+    name: "vtex_delete_sku_specification",
+    description: "Delete one specification association from one VTEX catalog SKU using the skuId and specificationId. This tool performs no pre-delete lookup or readback.",
+    schema: deleteSkuSpecificationSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteSkuSpecificationHandler
+);
+server.tool(
+  {
+    name: "vtex_delete_all_sku_specifications",
+    description: "Delete all specification associations from one VTEX catalog SKU. This is high-risk, requires explicit confirmation, and performs no pre-delete lookup or readback.",
+    schema: deleteAllSkuSpecificationsSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  deleteAllSkuSpecificationsHandler
+);
 server.tool(
   {
     name: "vtex_attach_catalog_image",
@@ -628,6 +836,71 @@ server.tool(
   },
   attachCatalogImageHandler
 );
+server.tool(
+  {
+    name: "vtex_update_product_brand",
+    description: "Update the brand assignment of one VTEX Catalog product. Changes the brand identifier the product is associated with.",
+    schema: updateProductBrandSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  updateProductBrandHandler
+);
+server.tool(
+  {
+    name: "vtex_add_sku_ean",
+    description: "Append one EAN value to a VTEX SKU. This adds a new EAN to the existing set without replacing other EANs already assigned to the SKU.",
+    schema: addSkuEanSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  addSkuEanHandler
+);
+server.tool(
+  {
+    name: "vtex_replace_sku_eans",
+    description: "Replace the entire set of EAN values on a VTEX SKU with a new list. All previously assigned EANs for the SKU are removed and the provided values become the only ones.",
+    schema: replaceSkuEansSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  replaceSkuEansHandler
+);
+server.tool(
+  {
+    name: "vtex_get_sku_images",
+    description: "List all images currently attached to a VTEX SKU. Returns image identifiers, URLs, alt text, labels, and order position for each image.",
+    schema: getSkuImagesSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  getSkuImagesHandler
+);
+server.tool(
+  {
+    name: "vtex_update_catalog_image",
+    description: "Update an existing catalog image on a VTEX SKU identified by the image identifier. Use to change the URL, alt text, label, or display position of an image already attached to the SKU.",
+    schema: updateCatalogImageSchema,
+    annotations: {
+      readOnlyHint: false,
+      destructiveHint: true,
+      openWorldHint: true
+    }
+  },
+  updateCatalogImageHandler
+);
 server.tool(
   {
     name: "vtex_cancel_order",
@@ -719,6 +992,123 @@ server.tool(
   },
   skuOffersHandler
 );
+server.tool(
+  {
+    name: "vtex_get_category_tree",
+    description: "Get the VTEX catalog category tree for a profile with an optional depth limit.",
+    schema: getCategoryTreeSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  getCategoryTreeHandler
+);
+server.tool(
+  {
+    name: "vtex_list_categories",
+    description: "List VTEX catalog categories using compact rows and pagination metadata.",
+    schema: listCategoriesSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  listCategoriesHandler
+);
+server.tool(
+  {
+    name: "vtex_get_category",
+    description: "Get one VTEX catalog category by ID.",
+    schema: getCategorySchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  getCategoryHandler
+);
+server.tool(
+  {
+    name: "vtex_list_brands",
+    description: "List VTEX catalog brands using compact rows and pagination metadata.",
+    schema: listBrandsSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  listBrandsHandler
+);
+server.tool(
+  {
+    name: "vtex_get_product",
+    description: "Get one VTEX catalog product by ID.",
+    schema: getProductSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  getProductHandler
+);
+server.tool(
+  {
+    name: "vtex_get_sku",
+    description: "Get one VTEX catalog SKU by ID.",
+    schema: getSkuSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  getSkuHandler
+);
+server.tool(
+  {
+    name: "vtex_list_products",
+    description: "List VTEX catalog product IDs with compact rows, pagination metadata, and optional keyword search.",
+    schema: listProductsSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  listProductsHandler
+);
+server.tool(
+  {
+    name: "vtex_list_products_by_category",
+    description: "List VTEX catalog products for one category using compact rows and pagination metadata (VTEX caps this endpoint at 50 items per page).",
+    schema: listProductsByCategorySchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  listProductsByCategoryHandler
+);
+server.tool(
+  {
+    name: "vtex_list_skus_by_product",
+    description: "List VTEX SKUs belonging to one product using compact rows.",
+    schema: listSkusByProductSchema,
+    annotations: {
+      readOnlyHint: true,
+      destructiveHint: false,
+      openWorldHint: true
+    }
+  },
+  listSkusByProductHandler
+);
 server.tool(
   {
     name: "config_check_database_connection",