Skip to main content

Wix Sites MCP Server

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

About Wix Sites API​

Wix Sites provides comprehensive site management capabilities for the Wix platform. The Sites API enables programmatic access to:

  • Site Management: Query and manage sites across your account
  • Domain Configuration: Connect and manage custom domains
  • Business Locations: Configure multi-location business presence
  • Site Properties: Access and configure site settings
  • URL Management: Handle routing and site URLs
  • SSL Certificates: Automatic SSL for connected domains

Key Features​

  • Account-level API: Query all sites in your Wix account
  • Domain Management: Connect, verify, and manage custom domains
  • Multi-location Support: Configure business locations with addresses
  • Site Properties: Business info, SEO settings, and locale configuration
  • DNS Configuration: Required DNS records for domain connection
  • SSL Status: Automatic HTTPS certificate provisioning
  • Business Hours: Configure operating schedules per location
  • Timezone Support: IANA timezone configuration for locations

What You Can Do with Wix Sites MCP Server​

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

Site Management​

  • Site Queries

    • "List all sites in my Wix account"
    • "Find all published sites"
    • "Show sites with premium subscriptions"
    • "Get site details including edit and view URLs"

  • Site Information

    • "Get the site ID for mybusiness.com"
    • "Show site creation dates and owners"
    • "Find sites with specific apps installed"
    • "List sites by publish status"

Domain Management​

  • Domain Connection

    • "Connect www.newdomain.com to my site"
    • "Set up a custom domain for the store"
    • "Add a subdomain to the existing site"
    • "Configure primary domain for the site"

  • Domain Queries

    • "List all connected domains"
    • "Check domain connection status"
    • "Verify SSL certificate status"
    • "Get required DNS records for domain"

  • Domain Operations

    • "Get domain configuration details"
    • "Check if mybusiness.com is available"
    • "Disconnect domain from site"
    • "Verify domain ownership"

  • Domain Availability

    • "Check if example.com is available for purchase"
    • "Verify domain name availability"
    • "Check premium domain pricing"
    • "Search for alternative domain names"

Location Management​

  • Location Creation

    • "Create a new downtown office location"
    • "Add a business location with address"
    • "Set up a new store location"
    • "Configure location with business hours"

  • Location Queries

    • "List all business locations"
    • "Get details for the main office"
    • "Find the default location"
    • "Show locations by status"

  • Location Configuration

    • "Update location address and phone"
    • "Set business hours for Monday-Friday"
    • "Configure timezone for the location"
    • "Mark location as active or inactive"

  • Business Hours

    • "Set opening hours 9 AM to 5 PM weekdays"
    • "Configure special holiday hours"
    • "Update weekend operating schedule"
    • "Set different hours per location"

Site Properties​

  • Property Queries

    • "Get site business name and description"
    • "View site language and locale settings"
    • "Check business contact information"
    • "Show site categories"

  • Business Information

    • "Get site display name"
    • "Show business contact email and phone"
    • "View legal business name"
    • "Check multilingual settings"

  • SEO Settings

    • "Get site SEO configuration"
    • "View favicon and site images"
    • "Check site description for search"
    • "Show social media metadata"

Prerequisites​

  • Access to Cequence AI Gateway
  • Wix account with sites to manage
  • 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 Sites MCP"
    • Description: "MCP server for Wix Sites management"

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 Sites 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 Sites API​

  1. Browse the Third-party category
  2. Look for Wix Sites
  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:
    • Sites (query)
    • Domains (list, get, create, delete, check availability)
    • Locations (list, get, create, update)
    • Site Properties (get)
  3. Click Next

Step 6: MCP Server Basic Setup​

  1. MCP Server Name: "Wix Sites Manager"
  2. Description: "Site, domain, and location 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} (for site-specific operations)
    • wix-account-id: {account_id} (for account-level operations)

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: Sites operations
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled

Click Create & Deploy to finalize.

Using Your Wix Sites MCP Server​

Setup Instructions:

Common Use Cases​

Site Portfolio Management​

  • Multi-site administration
  • Site inventory tracking
  • Publish status monitoring
  • Account-wide site queries

Domain Administration​

  • Custom domain setup
  • SSL certificate management
  • DNS configuration guidance
  • Domain availability checking

Multi-location Business​

  • Location directory management
  • Business hours configuration
  • Contact information updates
  • Geographic presence setup

Site Configuration​

  • Business information management
  • SEO settings configuration
  • Locale and language setup
  • Property customization

Security Best Practices​

  1. OAuth Security:

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

  2. Domain Security:

    • Verify domain ownership
    • Monitor DNS changes
    • Track SSL status
    • Audit domain connections

  3. Access Control:

    • Account-level vs site-level tokens
    • Role-based permissions
    • Audit access logs
    • Secure header handling

Troubleshooting​

Common Issues​

  1. 401 Unauthorized

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

  2. 404 Not Found

    • Verify site/domain IDs exist
    • Check location IDs are valid
    • Confirm resources are accessible
    • Use query endpoints for lookups

  3. 400 Bad Request

    • Check domain name format (include TLD)
    • Verify timezone is valid IANA format
    • Ensure required location fields (timeZone)
    • Validate address structure

  4. Domain Connection Issues

    • Verify DNS records are configured
    • Wait for DNS propagation (up to 48 hours)
    • Check domain registrar settings
    • Confirm domain ownership verification

Getting Help​