io.github.codespar/mcp-vtex — MCP server for VTEX

MCP server for VTEX, an e-commerce platform. It is described as covering catalog, orders, inventory, and promotions, with scope implied by the server’s description. The package is published on npm as @codespar/mcp-vtex and is licensed under MIT.

🛠️ Key Features

VTEX integration focused on e-commerce
Support for catalog, orders, inventory, and promotions
Distributed as npm package: @codespar/mcp-vtex
MIT license

🚀 Use Cases

Accessing VTEX catalog data
Handling VTEX orders
Working with VTEX inventory
Querying or managing VTEX promotions

⚡ Developer Benefits

Uses Model Context Protocol (MCP) as indicated by the server title and topics
Fits developer workflows that involve LLM tools and AI agents
Tagged for Brazil and Latin America use

⚠️ Limitations

Provided description and excerpt do not list specific MCP tools, capabilities, or configuration options beyond the general VTEX scope and package metadata.

Quick Start

Claude Desktop

Add to ~/.config/claude/claude_desktop_config.json:

json

{
  "mcpServers": {
    "vtex": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-vtex"],
      "env": {
        "VTEX_ACCOUNT_NAME": "your-account",
        "VTEX_APP_KEY": "your-app-key",
        "VTEX_APP_TOKEN": "your-app-token"
      }
    }
  }
}

Claude Code

bash

claude mcp add vtex -- npx @codespar/mcp-vtex

Cursor / VS Code

Add to .cursor/mcp.json or .vscode/mcp.json:

json

{
  "servers": {
    "vtex": {
      "command": "npx",
      "args": ["-y", "@codespar/mcp-vtex"],
      "env": {
        "VTEX_ACCOUNT_NAME": "your-account",
        "VTEX_APP_KEY": "your-app-key",
        "VTEX_APP_TOKEN": "your-app-token"
      }
    }
  }
}

Tools (33)

Tool

Purpose

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)

invoice_order

Issue a fiscal invoice (nota fiscal) for an order

track_order_invoice

Update tracking info for a previously issued invoice

cancel_order

Cancel an order

list_customer_orders

List order history for a customer (filtered by email)

get_sku_price

Get pricing details for an SKU (base price, list price, markup, cost, fixed prices per trade policy)

update_sku_price

Update base/list/cost price for an SKU

list_price_tables

List all configured price tables (trade policies)

get_inventory

Get inventory/stock for a SKU across warehouses

update_inventory

Update inventory quantity for a SKU at a specific warehouse

get_shipping_rates

Simulate shipping rates for items to a postal code

list_warehouses

List all warehouses configured in the account

create_warehouse

create_promotion

Create a promotion/discount in VTEX

list_coupons

List all promotion coupons

create_coupon

Create a promotion coupon code

list_subscriptions

List customer subscriptions

create_subscription

Create a recurring subscription for a customer (VTEX Subscriptions)

get_masterdata_document

Get a document (customer profile, custom entity) from VTEX Master Data v2

search_masterdata

Search documents in a Master Data entity

create_giftcard

Create a gift card for a customer (GiftCard Hub)

get_giftcard

Get gift card details by ID

Variable

Required

Description

VTEX_ACCOUNT_NAME

Yes

VTEX account name

VTEX_APP_KEY

Yes

API app key

VTEX_APP_TOKEN

Yes

API app token

VTEX_ENVIRONMENT

Environment host slug (default vtexcommercestable)

Install

Configuration

Environment variables

VTEX_APP_TOKENrequiredsecret

API key for vtex

Add to VS Code Add to Cursor

claude_desktop_config.json

json

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

io.github.codespar/mcp-vtex