mcp-vtex — Claude Code MCP server: what it does, how to install
Connects your VTEX e-commerce store to AI assistants. It manages catalog items, inventory levels, and orders directly from chat.
claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtexWhat mcp-vtex 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.
What it helps with
- 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 for the agent
- 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.
How to install mcp-vtex
Platform CLI
claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtexReplace <…> with your own values
Platform CLI
codex mcp add vtex --env VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtexReplace <…> with your own values
Config file
{
"mcpServers": {
"vtex": {
"command": "npx",
"args": [
"-y",
"@codespar/mcp-vtex"
],
"env": {
"VTEX_APP_TOKEN": "<VTEX_APP_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"vtex": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@codespar/mcp-vtex"
],
"env": {
"VTEX_APP_TOKEN": "<VTEX_APP_TOKEN>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> vtex npx -y @codespar/mcp-vtexReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-vtex
How do I install mcp-vtex in Claude Code?
Run claude mcp add mcp-vtex -e VTEX_APP_TOKEN=<VTEX_APP_TOKEN> -- npx -y @codespar/mcp-vtex.
What features does mcp-vtex provide?
It provides 33 tools to manage VTEX orders, catalog products, SKUs, inventory quantities, shipping simulations, and promotions.
What credentials are required to run mcp-vtex?
You need VTEX_ACCOUNT_NAME, VTEX_APP_KEY, and VTEX_APP_TOKEN generated in the License Manager section of your VTEX admin panel.
