Skip to main content
V

VTEX

@codespar/mcp-vtex · v0.2.2

🇧🇷 BrazilE-CommerceAuth · OAuth2live33 tools4 env vars

Enterprise e-commerce platform: orders, catalog, inventory, pricing, and fulfillment. Your agent manages the full storefront lifecycle.

Get started · freeView docs

MIT · runs locally with your own credentials

Limitations

  • The package manifest does not declare 3 of the 4 variables the code reads.
Package
@codespar/mcp-vtex
Version
0.2.2
npm dist-tag
latest
Category
E-Commerce
Auth
OAuth2
Country
🇧🇷 Brazil
License
MIT
Transport
stdio · streamable-http

Quickstart

Install, set the credentials, make the first call.

Pick your client. The server runs locally over stdio, with your own credentials.

Add the server to your clientOne config entry. No build step, no SDK required.
Set the environment variables4 variables read by this server's code, listed below.
Restart and make the first callThe agent can call any of the 33 tools. Try list_products first.
terminal
# Claude Code claude mcp add vtex -e VTEX_ACCOUNT_NAME=… -e VTEX_APP_KEY=… -e VTEX_APP_TOKEN=… -e VTEX_ENVIRONMENT=… -- npx -y @codespar/mcp-vtex@0.2.2 # then: /mcp to confirm the server is connected
Environment variables4 variables
VTEX_ACCOUNT_NAMERead by the code; the package manifest does not declare it.
VTEX_APP_KEYRead by the code; the package manifest does not declare it.
VTEX_APP_TOKENAPI key for vtexrequiredsecret
VTEX_ENVIRONMENTRead by the code; the package manifest does not declare it.

Names read from the package code (@codespar/mcp-vtex@0.2.2). Descriptions and flags come from its manifest. Self-hosted, you hold the credentials.

First call demolist_products

"List products from VTEX catalog"

tools/calllist_productsresult returned

Tools

What your agent can call.

33 tools, as the package's tools/list returns them.

list_products

List products from VTEX catalog

get_product

Get product details by ID

create_product

Create a new product in the VTEX catalog

update_product

Update an existing product in the VTEX catalog

list_skus

List SKUs for a product

create_sku

Create a new SKU for a product

list_categories

List all categories with pagination

create_category

Create a new category in the catalog

get_catalog

Get the catalog category tree

list_orders

List orders with optional filters

get_order

Get full OMS order details by ID

update_order_status

Transition an order to the handling state (start fulfillment)

Names and descriptions come from the package's tools/list (@codespar/mcp-vtex@0.2.2). A kind (read, write, delete) is shown only when the package annotates its tools or each tool was verified one by one; neither exists for this server yet.

Compatibility

MCP is a protocol. Any client that speaks it can mount this server.

The CodeSpar runtime does not route this server. Mount it in your client over stdio · streamable-http.

Protocol

Any MCP client

stdio · streamable-http

Questions

Before you install.

How do I install the VTEX MCP server?

Run npx -y @codespar/mcp-vtex@0.2.2 and add the config block above to your MCP client: Claude Code, Cursor, Claude Desktop, VS Code, or any MCP-compatible client. No build step, no SDK required.

What can my agent do with VTEX?

VTEX exposes 33 tools for e-commerce. Your agent calls them directly; the full list is above.

How does VTEX authenticate, and how are credentials stored?

VTEX uses OAuth2. Self-hosted, you hold the credentials: the server reads them from its environment variables.

How does VTEX handle upstream API changes?

Every server is versioned independently on npm. The command on this page pins 0.2.2, the version whose tools are listed here; your agent keeps running it until you change the version.

Is VTEX open source? How do I report a bug?

Yes. VTEX is MIT-licensed and published on npm as @codespar/mcp-vtex, source on GitHub (link in the Details panel). Report issues on the package repository; security issues go to security@codespar.dev, and we respond within 24 hours.

Start in seconds.

Add the config above, set the variables, and your agent calls the tools.

Start in seconds demo
Add the server to your client with the config above.
Set the environment variables listed above.
Ask your agent for the first call.
VTEX — MCP server · 33 tools | CodeSpar