Skip to main content

Wix Stores MCP Server

Create a powerful Model Context Protocol (MCP) server for Wix Stores in minutes with our AI Gateway. This guide walks you through setting up seamless eCommerce integration with enterprise-grade security and instant OAuth authentication.

About Wix Stores API​

Wix Stores is a comprehensive eCommerce platform that enables businesses to create and manage online stores. The Stores API provides programmatic access to:

  • Product Catalog: Manage products with variants, options, and media
  • Order Management: Process orders and handle fulfillment workflows
  • Inventory Tracking: Track stock across multiple locations
  • Brand Management: Organize products by brand
  • Pricing: Configure product pricing and discounts
  • Collections: Organize products into categories

Key Features​

  • Catalog V3 API: Modern product management with full variant support
  • eCommerce V1 API: Advanced order processing and search
  • Inventory Management: Track quantities per variant per location
  • Multi-variant Products: Size, color, and custom option combinations
  • Digital Products: Support for downloadable items
  • Physical Products: Shipping and weight configuration
  • Brand Filtering: Customer-facing brand navigation
  • Bulk Operations: Efficient mass data imports

What You Can Do with Wix Stores MCP Server​

The MCP server transforms Wix Stores API into a natural language interface, enabling AI agents to:

Product Management​

  • Product Operations

    • "Create a new physical product called Classic T-Shirt at $29.99"
    • "List all visible products in the store"
    • "Update the product description for the Premium Hoodie"
    • "Hide the discontinued product from the storefront"

  • Variant Management

    • "Add size and color variants to the t-shirt"
    • "Update variant prices for the holiday sale"
    • "Set specific SKUs for each product variant"
    • "Configure variant-specific images"

  • Product Search

    • "Find all products containing 'shirt' in the name"
    • "List products by collection"
    • "Show products updated in the last week"
    • "Get product details by slug"

Order Processing​

  • Order Operations

    • "Create an order for 2 t-shirts for customer@example.com"
    • "Search for paid orders from this month"
    • "Update buyer email on order #10045"
    • "Archive completed orders from last quarter"

  • Order Queries

    • "List all unfulfilled orders"
    • "Find orders with pending payment"
    • "Show orders by customer email"
    • "Get order details including line items"

  • Order Management

    • "Track order status and shipments"
    • "View order price summaries"
    • "Access billing and shipping addresses"
    • "Check fulfillment progress"

Inventory Management​

  • Stock Tracking

    • "Create inventory item for product variant"
    • "Update stock quantity to 150 units"
    • "Enable quantity tracking for all variants"
    • "Set preorder limits for new products"

  • Inventory Queries

    • "Find items with low stock (less than 10)"
    • "List inventory by location"
    • "Search inventory by product name"
    • "Get current stock for specific variant"

  • Inventory Operations

    • "Delete inventory tracking for discontinued items"
    • "Enable preorder for out-of-stock products"
    • "Update inventory across all locations"
    • "Generate inventory status report"

Brand Management​

  • Brand Operations

    • "Create a new brand called Nike"
    • "List all brands in the store"
    • "Update brand name to Nike Sports"
    • "Delete unused brand entries"

  • Brand Queries

    • "Search brands containing 'Sports'"
    • "Get brand details with product count"
    • "Find brands created this month"
    • "List top brands by product count"

Catalog Organization​

  • Collection Management

    • "Organize products by category"
    • "Create seasonal collections"
    • "Assign products to multiple collections"
    • "Build navigation structure"

  • Product Discovery

    • "Configure search refinements"
    • "Set product visibility rules"
    • "Manage product ribbons and badges"
    • "Optimize product sorting"

Prerequisites​

  • Access to Cequence AI Gateway
  • Wix account with Stores app installed
  • App development access in Wix
  • API credentials (Client ID and Secret)

Step 1: Create Wix App​

Before setting up the MCP server, you need to create an app in Wix.

1.1 Access Wix Developers​

  1. Navigate to dev.wix.com
  2. Sign in with your Wix account
  3. Go to My Apps in the developer dashboard

1.2 Create New App​

  1. Click Create New App
  2. Select Build from scratch
  3. Fill in app details:
    • App Name: "AI Gateway Stores MCP"
    • Description: "MCP server for Wix Stores automation"

1.3 Configure OAuth​

  1. Navigate to OAuth settings
  2. Add Redirect URL: 
    https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback
  3. Select required permissions for Stores access

1.4 Get Credentials​

  1. Go to OAuth page
  2. Copy App ID
  3. Copy App Secret Key

Step 2: Access AI Gateway Apps​

  1. Log in to your Cequence AI Gateway dashboard
  2. Navigate to Apps in the left sidebar

Step 3: Find and Select Wix Stores API​

  1. Browse the Third-party category
  2. Look for Wix Stores
  3. Click on the API card to view details

Step 4: Create MCP Server​

Click Create MCP Server to start the wizard.

Step 5: Configure API Endpoints​

  1. Base URL: https://www.wixapis.com
  2. Select API endpoints to expose:
    • Products (create, query, get, update, delete)
    • Orders (create, search, query, get, update)
    • Inventory (create, query, get, update, delete, search)
    • Brands (create, query, get, update, delete)
  3. Click Next

Step 6: MCP Server Basic Setup​

  1. MCP Server Name: "Wix Stores Commerce"
  2. Description: "eCommerce product, order, and inventory management"
  3. Production Mode: Toggle as needed
  4. Click Next

Step 7: Configure Authentication​

  1. Authentication Type: OAuth 2.0

  2. Fill in OAuth settings:

    • Authorization URL: 
      https://www.wix.com/installer/install
    • Token URL: 
      https://www.wixapis.com/oauth2/token
    • Client ID: Paste from Wix app
    • Client Secret: Paste from Wix app
    • Redirect URI: 
      https://auth.aigateway.cequence.ai/v1/outbound/oauth/callback

  3. Required Headers:

    • Authorization: Bearer {access_token}
    • wix-site-id: {site_id}

Step 8: Configure Security​

  1. API Protection: Toggle ON to enable

    • Protects against bot attacks, DDoS, and threats
    • Monitors for suspicious activity
    • Rate limiting and anomaly detection

  2. Click Next

Step 9: Choose Deployment Method​

  • Fully managed deployment
  • Automatic scaling and monitoring
  • Built-in high availability

Option B: Deploy with Helm Chart​

  • Self-managed Kubernetes deployment
  • Full control over infrastructure

Click Next after selecting.

Step 10: Review and Deploy​

Review your configuration:

  • MCP Server Name: Your chosen name
  • Base URL: https://www.wixapis.com
  • Selected Endpoints: Store operations
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled

Click Create & Deploy to finalize.

Using Your Wix Stores MCP Server​

Setup Instructions:

Common Use Cases​

Product Catalog Management​

  • Product creation and updates
  • Variant and option configuration
  • Pricing and discount management
  • Media and image handling

Order Fulfillment​

  • Order processing workflows
  • Shipping and tracking
  • Customer communication
  • Returns and exchanges

Inventory Operations​

  • Stock level monitoring
  • Multi-location inventory
  • Low stock alerts
  • Preorder management

Store Analytics​

  • Sales reporting
  • Product performance
  • Inventory turnover
  • Revenue tracking

Security Best Practices​

  1. OAuth Security:

    • Secure credential storage
    • Regular token rotation
    • Minimal permission scopes
    • Monitor API usage

  2. Data Protection:

    • Customer data privacy
    • PCI compliance awareness
    • Secure transmission
    • Audit logging

  3. Access Control:

    • Role-based permissions
    • Site-specific tokens
    • Least privilege principle
    • Session management

Troubleshooting​

Common Issues​

  1. 401 Unauthorized

    • Verify access token validity
    • Check wix-site-id header
    • Ensure app is installed on site
    • Regenerate credentials if expired

  2. 404 Not Found

    • Verify product/order IDs exist
    • Check collection names (case-sensitive)
    • Confirm variant IDs are valid
    • Use query endpoints for lookups

  3. 400 Bad Request

    • Check productType (PHYSICAL/DIGITAL uppercase)
    • Verify variantsInfo.variants structure
    • Include required revision for updates
    • Validate price format (string amounts)

  4. 409 Conflict

    • Check revision number matches current
    • Handle concurrent update conflicts
    • Verify inventory item uniqueness
    • Refresh and retry operation

Getting Help​