Skip to content

Conversation

@leosepulveda
Copy link
Contributor

Description

This PR adds the MCP-VTEX Server to the community servers list.

About MCP-VTEX

MCP-VTEX is a community-built Model Context Protocol server that provides complete integration with the VTEX e-commerce platform APIs, enabling AI assistants to manage online stores through natural language.

Note: This is an independent, community-maintained project and is not officially affiliated with or endorsed by VTEX.

Key Features

  • 🎯 159 tools across 17 major VTEX APIs
  • 📦 Catalog Management: Products, SKUs, Categories, Brands, Specifications
  • 💰 Pricing & Promotions: Base prices, computed prices, promotions, coupons
  • 📊 Inventory & Logistics: Real-time stock, warehouses, docks
  • 🛒 Orders Management: Order operations, status, invoicing, tracking
  • 🏪 Marketplace Operations: Seller management, commissions, approvals
  • 🛍️ Checkout & Cart: Order form, shipping simulation, cart operations
  • 👥 Customer Data: Master Data integration, CRM functionality
  • 🔍 Product Search: Advanced search, filters, facets, autocomplete
  • Reviews & Ratings: Review management, approval workflow
  • 💳 Payment Configuration: Payment gateways, methods, transactions
  • 🎁 Gift Cards: Create, manage, and process gift card transactions
  • 🔄 Subscriptions: Recurring subscription management
  • 📧 Message Center: Email templates and automation
  • 🆔 VTEX ID: Authentication and access management

Links

  • 📦 npm Package: mcp-vtex
  • 💻 GitHub Repository: leosepulveda/mcp-vtex
  • 📚 Documentation: Comprehensive README with setup guides and examples
  • ⚖️ License: MIT

Installation

npm install -g mcp-vtex

Configuration Example (Claude Desktop)

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

Use Case

Perfect for e-commerce businesses using the VTEX platform who want to:

  • Automate catalog and inventory management
  • Process orders efficiently with AI assistance
  • Configure promotions and pricing strategies
  • Handle marketplace operations
  • Integrate VTEX operations with AI assistants (Claude Desktop, Cursor, etc.)

Technical Details

  • ✅ TypeScript with full type safety
  • ✅ 120+ type definitions
  • ✅ Comprehensive error handling
  • ✅ Environment-based secure configuration
  • ✅ ~5,800 lines of code
  • ✅ Actively maintained

Checklist

  • Added to README in alphabetical order
  • Package published on npm
  • Repository is public
  • Comprehensive documentation included
  • License specified (MIT)
  • Not officially affiliated with VTEX (community project)

Maintainer: Leonardo Sepúlveda (@leosepulveda)
Version: 1.4.0
Category: E-commerce, Retail, API Integration
Type: Community Server (Unofficial)

- Complete VTEX e-commerce API integration
- 159 tools covering 17 major VTEX APIs
- Catalog, pricing, inventory, orders, marketplace, checkout
- Customer data, search, reviews, payments and more
- Published on npm as mcp-vtex
- Repository: https://github.com/leosepulveda/mcp-vtex
@domdomegg
Copy link
Member

I'm closing this as we're no longer accepting updates to the servers README. Going forwards, we recommend submitting MCP servers to the MCP registry - keen to see your server there :)

@domdomegg domdomegg closed this Dec 11, 2025
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants