VTEX

v0.2.0OAuth2

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

33 tools1 env vars🇧🇷 Brazilstable on npm

Install

terminal

$ npm install @codespar/mcp-vtex

Quickstart

Add this entry to your claude_desktop_config.json (or any MCP-compatible client config).

claude_desktop_config.json

{
  "mcpServers": {
    "vtex": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-vtex"
      ],
      "env": {
        "VTEX_APP_TOKEN": "<your_vtex_app_token>"
      }
    }
  }
}

After restart, your agent can call any of the 33 tools below — try list_products first.

Environment variables · 1

Required to authenticate the server. Stored encrypted when using CodeSpar managed hosting.

VTEX_APP_TOKEN

requiredsecret

API key for vtex

Available tools · 33

Each tool is independent — your agent loads only what it needs to reduce context and response time.

READlist_products

List products from VTEX catalog

READget_product

Get product details by ID

WRITEcreate_product

Create a new product in the VTEX catalog

WRITEupdate_product

Update an existing product in the VTEX catalog

READlist_skus

List SKUs for a product

WRITEcreate_sku

Create a new SKU for a product

READlist_categories

List all categories with pagination

WRITEcreate_category

Create a new category in the catalog

Compatible frameworks

MCP is a protocol — any framework that speaks it can mount this server.

Claude Agent SDKAnthropic

OpenAI AgentsOpenAI

Vercel AI SDKVercel

LangChainLangChain

LlamaIndexLlamaIndex

CrewAICrewAI

MastraMastra

Any MCP clientProtocol

Frequently asked questions

All credentials are encrypted at rest in an isolated vault scoped per organization. OAuth2 tokens are automatically refreshed before expiry. Your agent code never sees raw secrets — it receives scoped, short-lived session tokens.