# mcp-vtex

Connects your VTEX e-commerce store to AI assistants. It manages catalog items, inventory levels, and orders directly from chat.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 274
- Author: codespar
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/codespar/mcp-dev-latam/tree/HEAD/packages/ecommerce/vtex
- Updated: 2026-09-27
- HTML: https://affpapa.org/en/nevibecode/mcp/mcp-vtex

## What it does

This MCP server exposes 33 tools for the VTEX e-commerce platform. It handles catalog operations, including creating products, retrieving SKU details, and updating categories. Order management capabilities cover status transitions, invoicing, invoice tracking, and cancellation.

Beyond basic catalog lookups, it supports stock updates across warehouses and shipping rate simulations. Tools for price tables and gift cards are included too. You can also search Master Data v2 records or manage recurring customer subscriptions.

Authentication depends on `VTEX_ACCOUNT_NAME`, `VTEX_APP_KEY`, and `VTEX_APP_TOKEN` environment variables. Without valid credentials from the VTEX License Manager, all API requests fail immediately.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `VTEX_APP_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtex
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add vtex --env VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtex
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "vtex": {
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-vtex"
            ],
            "env": {
                "VTEX_APP_TOKEN": "<VTEX_APP_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "vtex": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@codespar/mcp-vtex"
            ],
            "env": {
                "VTEX_APP_TOKEN": "<VTEX_APP_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> vtex npx -y @codespar/mcp-vtex
```
Replace <…> with your own values

## When to use it
- update SKU prices across configured price tables
- inspect inventory levels for a specific warehouse
- issue a fiscal invoice for an incoming order
- generate new promotional coupon codes

## Example prompts
- Check stock levels for SKU 458 across all warehouses.
- Generate a fiscal invoice for order 123456789.
- Create a new discount coupon in the VTEX catalog.

## Similar
- [MCP Toolbox for Databases](https://affpapa.org/en/nevibecode/mcp/googleapis-mcp-toolbox-for-databases.md) — MCP server · ★ 16717
- [PostHog MCP Server](https://affpapa.org/en/nevibecode/mcp/posthog-mcp-server.md) — MCP server · ★ 40409
- [OpenWork MCP Gateway](https://affpapa.org/en/nevibecode/mcp/openwork-mcp-gateway.md) — MCP server · ★ 24242
- [Keploy](https://affpapa.org/en/nevibecode/mcp/keploy.md) — MCP server · ★ 18727
- [Nhost](https://affpapa.org/en/nevibecode/mcp/nhost.md) — MCP server · ★ 9366
- [basebalance.cloud — x402 RPC & MCP gateway](https://affpapa.org/en/nevibecode/mcp/basebalancecloud-x402-rpc-mcp-gateway.md) — MCP server · ★ 7506

From the same set: [codespar/mcp-dev-latam](https://affpapa.org/en/nevibecode/by/codespar/mcp-dev-latam.md) — 124 cards

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md