Vtex MCP Server

VTEX uses app key and app token headers for API authentication. VTEX provides sandbox access via partner accounts. Contact VTEX for developer access. Its 33 documented tools cover order, product, sku, price.

People connecting e-commerce tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

One of 127 MCP servers published from codespar/mcp-dev-latam. Stars and repository activity are shared across all of them. See all 127 →

VERIFIED ACTIVE

LAST COMMIT 2026-08-12 · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Vtex

before you install - you'll need

Set VTEX_ACCOUNT_NAME, VTEX_APP_KEY, VTEX_APP_TOKEN before connecting.

Claude Code

claude mcp add codespar-mcp-dev-latam-packages-ecommerc -- npx -y @codespar/mcp-vtex

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "codespar-mcp-dev-latam-packages-ecommerc": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-vtex"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package @codespar/mcp-vtex - published under the repo owner's npm scope (@codespar)

registry namespace io.github.codespar is GitHub-verified and matches the repo owner

03 · What Vtex can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list products from VTEX catalog, get product details by ID, create a new product in the VTEX catalog, and update an existing product in the VTEX catalog.

Capability map

Tools grouped from the project's README - what Vtex lets an agent do.

read & search

11 tools - e.g. List products from VTEX catalog; List SKUs for a product; List all categories with pagination

list_products · list_skus · list_categories · get_catalog · list_orders · list_customer_orders…

create & write

5 tools - e.g. Create a new category in the catalog; Register a new warehouse (fulfillment center); Create a promotion/discount in VTEX

create_category · create_warehouse · create_promotion · create_coupon · create_subscription

Order

5 tools - e.g. Get full OMS order details by ID; Transition an order to the handling state (start fulfillment); Issue a fiscal invoice (nota fiscal) for an order

get_order · update_order_status · invoice_order · track_order_invoice · cancel_order

Product

3 tools - e.g. Get product details by ID; Create a new product in the VTEX catalog; Update an existing product in the VTEX catalog

get_product · create_product · update_product

Sku

3 tools - e.g. Create a new SKU for a product; Get pricing details for an SKU (base price, list price, markup, cost, fixed prices per trade policy); Update base/list/cost price for an SKU

create_sku · get_sku_price · update_sku_price

Inventory

2 tools - e.g. Get inventory/stock for a SKU across warehouses; Update inventory quantity for a SKU at a specific warehouse

get_inventory · update_inventory

Masterdata

2 tools - e.g. Get a document (customer profile, custom entity) from VTEX Master Data v2; Search documents in a Master Data entity

get_masterdata_document · search_masterdata

Giftcard

2 tools - e.g. Create a gift card for a customer (GiftCard Hub); Get gift card details by ID

create_giftcard · get_giftcard

04 · Who maintains Vtex

mcp-vtex is maintained by codespar. We track 127 MCP servers from codespar - 127 actively maintained, 269 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from codespar.

05 · Facts

repository: github.com/codespar/mcp-dev-latam
category: e-commerce - actively maintained as of 2026-08-25.
registry: io.github.codespar/mcp-vtex (active, first published 2026-04-12 · 3 versions)
packages: npm:@codespar/mcp-vtex

06 · Vtex FAQ

Is Vtex still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-12. We re-verify nightly.

What can Vtex do?

With this server connected, an agent can list products from VTEX catalog, get product details by ID, create a new product in the VTEX catalog, and update an existing product in the VTEX catalog.

How do I install Vtex?

Run `npx -y @codespar/mcp-vtex`. The README documents 3 environment variables (VTEX_ACCOUNT_NAME, VTEX_APP_KEY, VTEX_APP_TOKEN) to set first. Set VTEX_ACCOUNT_NAME, VTEX_APP_KEY, VTEX_APP_TOKEN before connecting. You can also paste the ready-made client config above.

Does Vtex run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Vtex

Alternatives to Vtex

Maintained e-commerce servers if Vtex isn't the fit.

More e-commerce MCP servers · Clishop · Ozon MCP Server · Homebox MCP · Goodbarber Public MCP

More JavaScript MCP servers · Bling · Omie · Quickbooks · Tiny · Xero · see all