Feat/vtex mcp

[viniciusventura29]

Summary by cubic

Adds a new VTEX Commerce MCP that integrates Catalog, Collections, Pricing, Orders, Inventory, and Warehouses, exposing tools to manage products, SKUs, collections, orders, stock, and prices. Includes HTTP MCP config schema, typed client, OpenAPI scripts, and local dev improvements (hot reload and better schema download error handling).

• New Features

  • New vtex workspace with HTTP MCP (app.json) and state schema (accountName, appKey, appToken).
  • Typed VTEX client and models for Catalog, Orders, Logistics, Pricing; detailed order output schemas and expanded filters.
  • Catalog tools: brands, categories, products, SKUs (get/list/create/update).
  • Collections tools: list/search/get/create/update/delete; add/remove one or many SKUs; get collection products.
  • Pricing tools: base price, fixed prices, computed price, list tables, delete price.
  • Orders tools: get/list with rich filters; cancel; start-handling.
  • Inventory/Warehouse tools: inventory by SKU (get/update); warehouses (list/get).
  • Dev scripts: download-schemas and generate-client; hot-reload dev server; CF Workers types added; workspace registered in root package.json.

• Migration

  • Configure the VTEX MCP connection with accountName, appKey, and appToken (see vtex/app.json and vtex/.env.example).
  • Optional: run bun run download-schemas then bun run openapi to refresh generated clients.
  • Build/deploy using vtex package scripts (bun run build / npm run deploy).

^{Written for commit b55f45a. Summary will update on new commits.}

[github-actions]

🚀 Preview Deployments Ready!

Your changes have been deployed to preview environments:

📦 vtex

🔗 View Preview

These previews will be automatically updated with new commits to this PR.

---

_{Deployed from commit: fef7f0d}

[cubic-dev-ai]

3 issues found across 66 files

Prompt for AI agents (all issues)

Check if these issues are valid — if so, understand the root cause of each and fix them.


<file name="vtex/server/tools/collection/add-sku.ts">

<violation number="1" location="vtex/server/tools/collection/add-sku.ts:13">
P2: Use the same `skuId` input shape as other collection tools to avoid callers failing validation with the wrong field casing.</violation>
</file>

<file name="vtex/scripts/download-schemas.ts">

<violation number="1" location="vtex/scripts/download-schemas.ts:48">
P2: Ensure the script exits with a non-zero code on failure; currently the error is only logged, so automation can’t detect a failed download.</violation>
</file>

<file name="object-storage/package.json">

<violation number="1" location="object-storage/package.json:8">
P1: The dev script is now empty (`bun run` without a target), so running `bun run dev` won’t start the server and will exit with an error. Restore the intended dev command.</violation>
</file>

_{Reply with feedback, questions, or to request a fix. Tag @cubic-dev-ai to re-run a review.}