Mcp Vtex

io.github.codesparPublished by GitHub account codesparv0.2.2Updated Oct 24, 2026

MCP server for VTEX — e-commerce, orders, products, inventory, shipping

VerifiedSTDIODesktop onlyProductivity & WorkflowBusiness & Commerce

Overview

AI-generated overview

Lets an assistant read and modify VTEX e-commerce data such as catalog, orders, pricing, inventory, shipping, promotions, and gift cards.

What you can do
Connects an assistant to a VTEX store account through roughly 33 tools covering the catalog (products, SKUs, categories), orders (list, detail, status, invoice, tracking, cancel), pricing and price tables, inventory and warehouses, shipping rate simulation, promotions and coupons, subscriptions, Master Data documents, and gift cards. Read tools fetch products, orders, stock, and rates; write tools create or update products, SKUs, categories, prices, inventory, warehouses, promotions, coupons, subscriptions, and gift cards, and can invoice, track, or cancel orders.
When to use it
Useful when an assistant needs to work with a VTEX storefront or back office: looking up catalog and order data, checking stock and shipping estimates, or performing routine catalog, pricing, inventory, and fulfillment updates through conversation.
Requirements
Runs locally via npx from the npm package @codespar/mcp-vtex, so Node.js and network access are needed. Requires a VTEX account name plus an app key and app token, supplied as the environment variables VTEX_ACCOUNT_NAME, VTEX_APP_KEY, and VTEX_APP_TOKEN; VTEX_ENVIRONMENT is optional. Credentials come from the VTEX License Manager.
Before you install
The app token (VTEX_APP_TOKEN) and app key are secrets granting API access to the store account; keep them out of shared configs. Many tools write or change live commerce data, including creating and updating products, prices, inventory, promotions, and coupons, and cancelling or invoicing orders, which can affect customers and revenue. Grant the narrowest VTEX permissions available.

Installation

In SourceWeft

  1. Open Mcp Vtex in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

@codespar/mcp-vtex

MCP server for VTEX — e-commerce platform with catalog, orders, inventory, and promotions

[npm] [License: MIT]

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json
{  "mcpServers": {    "vtex": {      "command": "npx",      "args": ["-y", "@codespar/mcp-vtex"],      "env": {        "VTEX_ACCOUNT_NAME": "your-account",        "VTEX_APP_KEY": "your-app-key",        "VTEX_APP_TOKEN": "your-app-token"      }    }  }}

Claude Code

bash
claude mcp add vtex -- npx @codespar/mcp-vtex

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json
{  "servers": {    "vtex": {      "command": "npx",      "args": ["-y", "@codespar/mcp-vtex"],      "env": {        "VTEX_ACCOUNT_NAME": "your-account",        "VTEX_APP_KEY": "your-app-key",        "VTEX_APP_TOKEN": "your-app-token"      }    }  }}

Tools (33)

ToolPurpose
list_productsList products from VTEX catalog
get_productGet product details by ID
create_productCreate a new product in the VTEX catalog
update_productUpdate an existing product in the VTEX catalog
list_skusList SKUs for a product
create_skuCreate a new SKU for a product
list_categoriesList all categories with pagination
create_categoryCreate a new category in the catalog
get_catalogGet the catalog category tree
list_ordersList orders with optional filters
get_orderGet full OMS order details by ID
update_order_statusTransition an order to the handling state (start fulfillment)
invoice_orderIssue a fiscal invoice (nota fiscal) for an order
track_order_invoiceUpdate tracking info for a previously issued invoice
cancel_orderCancel an order
list_customer_ordersList order history for a customer (filtered by email)
get_sku_priceGet pricing details for an SKU (base price, list price, markup, cost, fixed prices per trade policy)
update_sku_priceUpdate base/list/cost price for an SKU
list_price_tablesList all configured price tables (trade policies)
get_inventoryGet inventory/stock for a SKU across warehouses
update_inventoryUpdate inventory quantity for a SKU at a specific warehouse
get_shipping_ratesSimulate shipping rates for items to a postal code
list_warehousesList all warehouses configured in the account
create_warehouseRegister a new warehouse (fulfillment center)
create_promotionCreate a promotion/discount in VTEX
list_couponsList all promotion coupons
create_couponCreate a promotion coupon code
list_subscriptionsList customer subscriptions
create_subscriptionCreate a recurring subscription for a customer (VTEX Subscriptions)
get_masterdata_documentGet a document (customer profile, custom entity) from VTEX Master Data v2
search_masterdataSearch documents in a Master Data entity
create_giftcardCreate a gift card for a customer (GiftCard Hub)
get_giftcardGet gift card details by ID

Authentication

VTEX uses app key and app token headers for API authentication.

Sandbox / Testing

VTEX provides sandbox access via partner accounts. Contact VTEX for developer access.

Get your credentials

  1. Go to VTEX Developer Portal
  2. Access your VTEX admin or create a partner account
  3. Generate an app key and app token from License Manager
  4. Set the environment variables

Environment Variables

VariableRequiredDescription
VTEX_ACCOUNT_NAMEYesVTEX account name
VTEX_APP_KEYYesAPI app key
VTEX_APP_TOKENYesAPI app token
VTEX_ENVIRONMENTNoEnvironment host slug (default vtexcommercestable)

Roadmap

v0.3 (planned)

  • Checkout / cart session management
  • Marketplace seller and offer management
  • Carrier (shipping policy) registration

Want to contribute? Open a PR or request a tool.

Links

Enterprise

Need governance, budget limits, and audit trails for agent payments? CodeSpar Enterprise adds policy engine, payment routing, and compliance templates on top of these MCP servers.

License

MIT

Source: packages/ecommerce/vtex/README.md at commit d0a519a

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.2.2LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts