Skip to main content

Wix Content MCP Server

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

About Wix Content API​

Wix Content provides comprehensive content management capabilities for Wix sites. The Content API enables programmatic access to:

  • CMS Data Collections: Manage database schemas and structures
  • Data Items: CRUD operations on CMS content records
  • Blog Posts: Create, publish, and manage blog content
  • Blog Categories: Organize blog content with categories
  • Rich Content: Handle complex content structures
  • Media Management: Upload and organize media files

Key Features​

  • CMS Collections: Custom database schemas with field types
  • Data Item Operations: Full CRUD with bulk support
  • Query & Search: Advanced filtering and full-text search
  • Blog Management: Draft, publish, and schedule posts
  • Rich Content Editor: Structured content with paragraphs, headings, images
  • Category System: Organize blog posts by topic
  • Permissions: Configurable read/write access levels
  • Bulk Operations: Mass insert up to 1000 items

What You Can Do with Wix Content MCP Server​

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

CMS Data Collections​

  • Collection Discovery

    • "List all CMS data collections"
    • "Get schema for the Products collection"
    • "View field definitions and types"
    • "Check collection permissions"

  • Collection Analysis

    • "Show collection field types"
    • "View display field configuration"
    • "Check read/write permissions"
    • "Analyze collection structure"

Data Items Management​

  • Data Creation

    • "Insert a new item into Products collection"
    • "Add a record with title and price fields"
    • "Create content item with custom fields"
    • "Bulk insert 100 product records"

  • Data Queries

    • "List all items from MyCollection"
    • "Filter products by category equals Electronics"
    • "Search items containing 'phone' in title"
    • "Get distinct values for category field"

  • Data Updates

    • "Update item title in Products collection"
    • "Modify product price and description"
    • "Replace item data with new values"
    • "Bulk update multiple records"

  • Data Operations

    • "Get specific item by ID"
    • "Delete item from collection"
    • "Search with free-text query"
    • "Query with pagination and sorting"

Blog Post Management​

  • Post Creation

    • "Create a draft blog post"
    • "Write a post with rich content"
    • "Add post with cover image"
    • "Create featured blog article"

  • Post Queries

    • "List all published blog posts"
    • "Find posts in Technology category"
    • "Show featured posts only"
    • "Get posts by hashtag"

  • Post Operations

    • "Get blog post by ID with content"
    • "Update draft post title"
    • "Publish draft to make it live"
    • "Delete draft post permanently"

  • Post Publishing

    • "Publish the draft blog post"
    • "Update published post content"
    • "Move post to trash"
    • "Schedule post for later"

Blog Categories​

  • Category Management

    • "List all blog categories"
    • "Create Technology category"
    • "Get category details and post count"
    • "View category URL and slug"

  • Content Organization

    • "Assign post to categories"
    • "Create content taxonomy"
    • "Organize posts by topic"
    • "Build category navigation"

Content Search​

  • Full-text Search

    • "Search data items for 'keyword'"
    • "Find content matching query"
    • "Search with field filters"
    • "Combined search and filter"

  • Advanced Queries

    • "Filter with comparison operators"
    • "Sort results by date"
    • "Paginate through large datasets"
    • "Get total count of results"

Bulk Operations​

  • Mass Data Handling
    • "Bulk insert products from list"
    • "Import content in batches"
    • "Process up to 1000 items at once"
    • "Track bulk operation results"

Prerequisites​

  • Access to Cequence AI Gateway
  • Wix account with CMS and/or Blog app
  • 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 Content MCP"
    • Description: "MCP server for Wix Content 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 Content 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 Content API​

  1. Browse the Third-party category
  2. Look for Wix Content
  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:
    • Data Collections (list, get)
    • Data Items (insert, query, search, get, update, delete, bulk insert, distinct values)
    • Blog Posts (create draft, query, get, update, delete, publish)
    • Blog Categories (list, create)
  3. Click Next

Step 6: MCP Server Basic Setup​

  1. MCP Server Name: "Wix Content Manager"
  2. Description: "CMS data collections and blog content 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: Content operations
  • Authentication: OAuth 2.0 (Configured)
  • API Protection: Enabled/Disabled

Click Create & Deploy to finalize.

Using Your Wix Content MCP Server​

Setup Instructions:

Common Use Cases​

CMS Data Management​

  • Product catalogs
  • Custom databases
  • Directory listings
  • Dynamic content

Blog Publishing​

  • Content creation workflows
  • Editorial calendars
  • Post scheduling
  • Category management

Content Migration​

  • Data import/export
  • Bulk content updates
  • Cross-platform migration
  • Archive management

Content Search​

  • Site search functionality
  • Filtered content discovery
  • Content recommendations
  • Related content

Security Best Practices​

  1. OAuth Security:

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

  2. Data Protection:

    • Content access controls
    • Collection permissions
    • Secure transmission
    • Audit logging

  3. Content Security:

    • Input validation
    • Rich content sanitization
    • Media file scanning
    • Access level enforcement

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 collection ID exists (case-sensitive)
    • Check data item IDs are valid
    • Confirm blog instanceId exists
    • Install Blog app if querying posts

  3. 400 Bad Request

    • Check dataCollectionId is provided
    • Verify data matches collection schema
    • Validate query filter syntax
    • Ensure required fields are included

  4. Blog Not Found Error

    • "No blog instanceId found" means Blog app not installed
    • Install Wix Blog on the site first
    • Verify site has blog functionality enabled
    • Check app installation status

Getting Help​