How to integrate Wix MCP with Claude Agent SDK

Connect Claude Agent SDK to Wix MCP. List all orders placed this week, create a new product on wix store, and more using natural language, with authentication handled for you.

Wix logoWix
Oauth2Api Key

Wix is a cloud-based web development platform for building websites and stores. It's loved for its drag-and-drop tools and easy site management.

139 Tools

Introduction

This guide walks you through connecting Wix to the Claude Agent SDK using the Composio tool router. By the end, you'll have a working Wix agent that can list all orders placed this week, create a new product on wix store, update homepage banner image on wix through natural language commands.

This guide will help you understand how to give your Claude Agent SDK agent real control over a Wix account through Composio's Wix MCP server.

Before we dive in, let's take a quick look at the key ideas and tools involved.

Also integrate Wix with

TL;DR

Here's what you'll learn:
  • Get and set up your Claude/Anthropic and Composio API keys
  • Install the necessary dependencies
  • Initialize Composio and create a Tool Router session for Wix
  • Configure an AI agent that can use Wix as a tool
  • Run a live chat session where you can ask the agent to perform Wix operations

What is Claude Agent SDK?

The Claude Agent SDK is Anthropic's official framework for building AI agents powered by Claude. It provides a streamlined interface for creating agents with MCP tool support and conversation management.

Key features include:

  • Native MCP Support: Built-in support for Model Context Protocol servers
  • Permission Modes: Control tool execution permissions
  • Streaming Responses: Real-time response streaming for interactive applications
  • Context Manager: Clean async context management for sessions

What is the Wix MCP server, and what's possible with it?

The Wix MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Wix account. It provides structured and secure access to your store, contacts, members, forms, bookings, and site details, so your agent can search products, review orders, check inventory, retrieve contacts, and cancel orders on your behalf.

  • Product and inventory lookup: Have your agent search your Wix product catalog and check inventory items using text, filters, and sorting.
  • Order management: Direct your agent to find e-commerce orders that match your criteria or cancel an existing order.
  • Contact and member retrieval: Let the agent find Wix contacts, retrieve member details, and check member privacy settings.
  • Forms, bookings, and locations: Instruct your agent to retrieve form submissions, browse booking categories, and find business locations.
  • Store and site information: Have your agent review site properties, available coupons, loyalty discounts, tax groups, and manual tax mappings.

What is the Composio tool router, and how does it fit here?

What is Composio SDK?

Composio's Composio SDK helps agents find the right tools for a task at runtime. You can plug in multiple toolkits (like Gmail, HubSpot, and GitHub), and the agent will identify the relevant app and action to complete multi-step workflows. This can reduce token usage and improve the reliability of tool calls. Read more here: Getting started with Composio SDK

The tool router generates a secure MCP URL that your agents can access to perform actions.

How the Composio SDK works

The Composio SDK follows a three-phase workflow:

  1. Discovery: Searches for tools matching your task and returns relevant toolkits with their details.
  2. Authentication: Checks for active connections. If missing, creates an auth config and returns a connection URL via Auth Link.
  3. Execution: Executes the action using the authenticated connection.

Step-by-step Guide

Step by step09 STEPS
1

Prerequisites

Before starting, make sure you have:
  • Composio API Key and Claude/Anthropic API Key
  • Primary know-how of Claude Agents SDK
  • A Wix account
  • Some knowledge of Python
2

Getting API Keys for Claude/Anthropic and Composio

Claude/Anthropic API Key
  • Go to the Anthropic Console and create an API key. You'll need credits to use the models.
  • Keep the API key safe.
Composio API Key
  • Log in to the Composio dashboard.
  • Navigate to your API settings and generate a new API key.
  • Store this key securely as you'll need it for authentication.
3

Install dependencies

npm install @anthropic-ai/claude-agent-sdk @composio/core dotenv

Install the Composio SDK and the Claude Agents SDK.

What's happening:

  • @composio/core provides Composio integration for Anthropic
  • @anthropic-ai/claude-agent-sdk is the core agent framework
  • dotenv/config loads environment variables
4

Set up environment variables

bash
COMPOSIO_API_KEY=your_composio_api_key_here
USER_ID=your_user_id_here
ANTHROPIC_API_KEY=your_anthropic_api_key_here

Create a .env file in your project root.

What's happening:

  • COMPOSIO_API_KEY authenticates with Composio
  • USER_ID identifies the user for session management
  • ANTHROPIC_API_KEY authenticates with Anthropic/Claude
5

Import dependencies

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

dotenv.config();
What's happening:
  • We're importing all necessary libraries including the Claude Agent SDK and Composio
  • The dotenv.config() function loads environment variables from your .env file
  • This setup prepares the foundation for connecting Claude with Wix functionality
6

Create a Composio instance and Tool Router session

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });

  // Create Tool Router session for Wix
  const session = await composio.create(USER_ID, {
    toolkits: ['wix'],
  });
  const mcpUrl = session?.mcp.url;
What's happening:
  • The function checks for the required COMPOSIO_API_KEY environment variable
  • We're creating a Composio instance using our API key
  • The create method creates a Tool Router session for Wix
  • The returned url is the MCP server URL that your agent will use
7

Configure Claude Agent with MCP

const options: Options = {
  permissionMode: 'bypassPermissions',
  mcpServers: {
    composio: {
      type: 'http',
      url: mcpUrl,
      headers: { 'x-api-key': COMPOSIO_API_KEY }
    }
  },
  systemPrompt: 'You are a helpful assistant with access to Wix tools via Composio.',
  maxTurns: 10,
};
What's happening:
  • We're configuring the Claude Agent options with the MCP server URL
  • permissionMode: 'bypassPermissions' allows the agent to execute operations without asking for permission each time
  • The system prompt instructs the agent that it has access to Wix
  • maxTurns: 10 limits the conversation length to prevent excessive API usage
8

Create client and start chat loop

const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}
What's happening:
  • The readline interface is created to handle user input and output
  • The query function is used to send the user's input to the agent
  • The chat loop continues until the user types 'exit' or 'quit'
9

Run the application

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}
What's happening:
  • The chat function is the entry point for the application
  • The try-catch block is used to handle any errors that occur

Complete Code

Here's the complete code to get you started with Wix and Claude Agent SDK:

import 'dotenv/config';
import readline from 'node:readline';
import { Composio } from '@composio/core';
import { query, type Options } from "@anthropic-ai/claude-agent-sdk";

async function chat() {
  const { COMPOSIO_API_KEY, USER_ID } = process.env;
  if (!COMPOSIO_API_KEY || !USER_ID) {
    throw new Error('COMPOSIO_API_KEY and USER_ID required in .env');
  }

  const composio = new Composio({ apiKey: COMPOSIO_API_KEY });
  const session = await composio.create(USER_ID, {
    toolkits: ['wix']
  });
  const mcp_url = session?.mcp.url;

  const options: Options = {
    permissionMode: 'bypassPermissions',
    mcpServers: {
      composio: {
        type: 'http',
        url: mcp_url,
        headers: { 'x-api-key': COMPOSIO_API_KEY }
      }
    },
    systemPrompt: 'You are a helpful assistant with access to Wix tools via Composio.',
    maxTurns: 10,
  };

  const rl = readline.createInterface({
    input: process.stdin,
    output: process.stdout,
    prompt: 'You: '
  });

  console.log('\nChat started. Type "exit" to quit.\n');

  let isProcessing = false;

  async function ask(prompt: string) {
    isProcessing = true;
    rl.pause();

    process.stdout.write('Claude is thinking...');
    const stream = query({ prompt, options });

    let firstChunk = true;
    for await (const msg of stream) {
      const content = (msg as any).message?.content || (msg as any).content;
      if (Array.isArray(content)) {
        for (const block of content) {
          if (block.type === 'text' && block.text) {
            if (firstChunk) {
              process.stdout.write('\r\x1b[K');
              process.stdout.write('Claude: ');
              firstChunk = false;
            }
            process.stdout.write(block.text);
          }
        }
      }
    }
    process.stdout.write('\n\n');

    isProcessing = false;
    rl.resume();
    rl.prompt();
  }

  rl.on('line', async (line) => {
    if (isProcessing) return;

    const input = line.trim();
    if (input === 'exit') {
      rl.close();
      process.exit(0);
    }
    if (input) await ask(input);
    else rl.prompt();
  });

  await ask('What can you help me with?');
}

try {
  await chat();
} catch (error) {
  console.error(error);
  process.exit(1);
}

Conclusion

You've successfully built a Claude Agent SDK agent that can interact with Wix through Composio's Tool Router.

Key features:

  • Native MCP support through Claude's agent framework
  • Streaming responses for real-time interaction
  • Permission bypass for smooth automated workflows
You can extend this by adding more toolkits, implementing custom business logic, or building a web interface around the agent.
TOOLS

Supported Tools

Every Wix action and event your agent gets out of the box.

Add Special Permissions

Tool to add special permissions to a Wix data collection for a specific user or role.

Calculate First Available Time Slots Per Menu

Tool to calculate and retrieve the first available time slot of each fulfillment type for each specified menu.

Cancel Automation Event

Tool to cancel any remaining automation actions for a trigger and external entity.

Cancel Order

Cancels an existing e-commerce order by marking its status as CANCELED.

Cancel Background Task

Tool to cancel a background task in Wix CMS.

Check Content

Tool to check content text against Wix moderation rules.

Check Domain Availability

Tool to check if a domain name is available for purchase.

Count Extended Bookings

Tool to count extended bookings matching specified filter criteria.

Add Labels to Contact

Tool to add labels to a Wix contact using the Labels API.

Enable Points Expiration

Tool to enable points expiration for a Wix loyalty program.

Bulk Create Products With Inventory

Tool to bulk create products with inventory in Wix.

Create Tax Region

Tool to create a tax region in Wix using the Tax Regions API.

Bulk Delete Abandoned Checkouts

Tool to bulk delete abandoned checkouts from Wix e-commerce.

Delete Add-On Group

Tool to delete an add-on group from a Wix Bookings service.

Delete Back In Stock Notification

Tool to delete a back in stock notification request from Wix e-commerce.

Bulk Delete Benefit Items

Tool to bulk delete benefit items from Wix Benefit Programs.

Bulk Delete Billable Items

Tool to bulk delete billable items in Wix.

Delete Schedule Bookmark

Tool to remove a bookmark from a schedule item in Wix Events.

Bulk Delete Brands

Tool to delete multiple brands from the Wix Stores catalog.

Bulk Delete Translation Content

Tool to bulk delete translation content by IDs.

Bulk Delete Variants

Tool to bulk delete item variants from Wix Restaurants menus.

Delete FAQ Category

Tool to delete an FAQ category from the Wix site.

Unlabel Contact

Tool to remove labels from a contact in the Wix CRM system.

Delete Customization

Tool to delete a customization from the Wix Stores catalog.

Delete Data Collection Field

Tool to delete a field from a Wix data collection.

Bulk Delete Form Schemas

Tool to bulk delete form schemas from Wix Forms.

Delete Info Section

Tool to delete an info section from the Wix Stores catalog.

Bulk Delete Inventory Items

Tool to bulk delete inventory items from the Wix Stores catalog.

Bulk Delete Benefit Items By Filter

Tool to bulk delete benefit program items by filter criteria.

Delete Loyalty Coupon

Tool to delete a loyalty coupon from the Wix Loyalty Program.

Delete Menu

Tool to delete a menu from Wix Restaurants.

Bulk Delete Modifiers

Tool to bulk delete item modifiers from Wix Restaurants Menus.

Bulk Delete Pool Definitions

Tool to bulk delete pool definitions from Wix Benefit Programs.

Delete Product Options

Tool to delete all options from a Wix product.

Bulk Delete Products

Tool to bulk delete products from the Wix Stores catalog.

Delete Program Definition

Tool to delete a program definition from Wix Benefit Programs.

Delete Project

Tool to delete a project from Wix Portfolio.

Delete Project Item

Tool to delete a project item from the Wix Portfolio.

Delete Question Entry

Tool to delete a question entry from Wix FAQ app.

Delete Receipt Preset

Tool to permanently delete a receipt preset from Wix.

Bulk Delete Notification Recipients

Tool to bulk delete notification recipients for Wix Restaurants online orders.

Bulk Delete Reports By Filter

Tool to bulk delete reports from the dashboard by filter criteria.

Bulk Delete RSVPs By Filter

Tool to bulk delete event RSVPs by filter criteria.

Delete Service Fee Rule

Tool to delete a service fee rule from Wix Restaurants Online Orders.

Delete Schedule Item

Tool to delete schedule items from a Wix event.

Delete Secret

Tool to delete a secret from Wix Secrets Vault.

Delete Sender Details

Tool to delete sender details from Wix email marketing.

Delete Sender Email

Tool to delete a sender email from Wix Marketing.

Delete Service

Tool to delete a service from Wix Bookings.

Bulk Delete Services By Filter

Tool to bulk delete booking services by filter criteria.

Bulk Delete Services

Tool to bulk delete services from Wix Bookings.

Delete Ticket Check-In

Tool to delete ticket check-in records for Wix Events.

Bulk Delete Ticket Definitions

Tool to bulk delete ticket definitions by filter criteria for Wix Events.

Delete Ticket Reservation

Tool to delete a ticket reservation from Wix Events.

Delete User Defined Fields

Tool to delete user defined fields from a data extension schema in Wix.

Delete User Favorite

Tool to remove a dashboard page from the current user's list of favorite pages.

Discard Draft Schedule

Tool to discard all changes to a draft schedule for a Wix event.

Generate Files Download URL

Tool to generate download URLs for files in Wix Media Manager.

Generate File Upload URL

Tool to generate an upload URL for uploading files to Wix Media Manager.

Get App Instance

Retrieve the current Wix app instance and associated site information.

Get Collection By Slug

Tool to retrieve a Wix Stores collection by its slug.

Get Current Member Coupons

Tool to retrieve loyalty coupons for the currently authenticated member.

Get Folder By Site

Tool to retrieve folder information for a specific site by site ID.

Get Member

Tool to retrieve a member by ID from Wix Members.

Get Member Privacy Settings

Tool to retrieve member privacy settings for a Wix site.

Get Members Custom Field Applications

Tool to retrieve custom field applications for specified members.

Bulk Get Or Create Brands

Tool to bulk retrieve or create brands in Wix Stores catalog.

Get Purchase History

Tool to retrieve purchase history for your app on a site.

Get Roles Custom Field Applications

Tool to retrieve custom field applications for specified roles.

Get Roles Info

Tool to retrieve all available roles in the requesting Wix account, including predefined and custom roles.

Get Site Plugins Placement Status

Tool to get the placement status of your app's site plugins on the user's site.

Get Site Properties

Tool to retrieve current snapshot of a site's properties including business profile, contact information, and business schedule.

Import File to Media Manager

Tool to import a file to Wix Media Manager using an external URL.

List App Permissions

Tool to retrieve all permissions for a specified Wix app.

List App Plans By App ID

Tool to retrieve app plans by application ID, including pricing, tax settings, and currency details.

List Email Marketing Campaigns

Tool to retrieve a list of email marketing campaigns, ordered by date_updated in descending order.

List Contacts Facets

Tool to list facets from the site's Contact List.

List Currencies

Tool to retrieve the list of available currencies from Wix Currency Converter.

List Custom Fields

Tool to retrieve a list of custom fields and fields provided by the Members Area.

List Default Tax Groups

Tool to retrieve the list of default tax groups for a Wix site.

List Default Tax Groups By App IDs

Tool to retrieve default tax groups for specific Wix apps by their app IDs.

List Group Requests

Tool to list group requests across a Wix site.

List Invoices by Order IDs

Tool to retrieve invoice IDs and external app IDs for multiple orders.

List Manual Tax Mappings

Tool to retrieve up to 1,000 manual tax mappings from Wix.

List Member Following

Tool to retrieve the list of members followed by a given member in Wix Members.

List My Member Followers

Tool to retrieve the list of members who are following the current authenticated member in Wix Members.

List V4 Contacts

Tool to retrieve a list of up to 1,000 contacts per request from Wix.

Logout

Tool to terminate a member's session and clear authentication cookies.

Publish Draft Schedule

Tool to publish a draft schedule for a Wix event.

Query Bookings Categories

Tool to retrieve bookings service categories with optional filtering, sorting, and pagination.

Query Contacts

Tool to retrieve up to 1,000 Wix contacts with advanced filtering, sorting, and pagination.

Query Coupons

Tool to retrieve a list of up to 100 coupons with optional paging, filtering, and sorting.

Query Deleted Forms

Tool to retrieve deleted form schemas from the trash bin for a specified namespace.

Query E-Commerce Orders

Tool to retrieve e-commerce orders with advanced filtering, sorting, and pagination.

Query Extended Bookings

Tool to retrieve up to 100 extended bookings with advanced filtering, sorting, and pagination.

Query Contact Facets

Tool to retrieve facets from the site's contact list by filter.

Query Site Folders

Tool to retrieve a list of site folders with optional paging, filtering, and sorting.

Query Form Submissions by Namespace

Tool to retrieve form submissions from a specified namespace with optional pagination.

Query Group Requests

Tool to query group creation requests with filtering, sorting, and pagination.

Query Inventory Items

Tool to retrieve a list of up to 1000 inventory items with optional paging, filtering, and sorting.

Query Locations

Tool to retrieve business locations with filtering, sorting, and pagination.

Query Loyalty Checkout Discounts

Tool to retrieve loyalty checkout discounts with filtering, sorting, and pagination.

Query Manual Tax Mappings

Tool to retrieve a list of up to 100 manual tax mappings with optional paging, filtering, and sorting.

Query Moderation Rules

Tool to retrieve moderation rules with optional filtering, sorting, and pagination.

Query Form Submissions by Namespace

Tool to retrieve form submissions from a specified namespace with advanced filtering, sorting, and pagination.

Query Tax Groups

Tool to retrieve a list of up to 100 tax groups with optional paging, filtering, and sorting.

Register V2

Tool to register a new member account on Wix site.

Remove Deleted Fields

Tool to permanently remove deleted fields from a Wix form schema.

Bulk Remove Info Sections By Filter

Tool to bulk remove info sections from products matching a filter expression.

Remove Tip From Order

Tool to remove a tip from an existing eCommerce order.

Reschedule Draft Schedule Items

Tool to reschedule all draft schedule items for an event at once.

Search Products

Tool to search products in the Wix store catalog using text search, filters, and sorting.

Send Recovery Email

Tool to send a password recovery email to a Wix member with a link to reset their password.

Set Customization Choices

Tool to set choices for a customization in Wix stores catalog.

Set Default Receipt Preset

Tool to set a receipt preset as the default in Wix.

Bulk Unassign Events from Categories

Tool to unassign an event from multiple categories in Wix Events.

Bulk Update Billable Items

Tool to bulk update billable items in Wix.

Bulk Update Customizations

Tool to bulk update multiple customizations in Wix Stores Catalog V3.

Bulk Update Storage Item Tags By Filter

Tool to bulk update tags on storage items matching filter criteria.

Update Business Contact

Tool to update a site's business contact information including email, phone, fax, and address.

Update Business Profile

Tool to update a site's business profile including display name, description, logo, and business name.

Update Business Schedule

Tool to update a site's business schedule including regular operating hours and special exceptions.

Bulk Update Contacts

Tool to bulk update multiple contacts with specified field values.

Bulk Update Translation Content By Key

Tool to bulk update translation content by composite key (schemaId, entityId, locale).

Bulk Update Inventory Items By Filter

Tool to bulk update inventory items by filter criteria.

Update inventory variants

Tool to update product inventory including quantity, stock status, and tracking settings per variant.

Update Question Entry Labels

Tool to set labels for a Wix FAQ question entry.

Update Locale Settings

Tool to update a Wix site's locale configuration settings including auto-redirect behavior.

Update Operation Group Tags By Filter

Tool to bulk update tags on operation groups using filter criteria.

Bulk Update Orders

Tool to bulk update properties of up to 100 e-commerce orders.

Bulk Update Order Tags

Tool to synchronously update tags on multiple orders by list of order IDs.

Bulk Update Products By Filter

Tool to bulk update multiple products matching filter criteria in Wix Stores.

Update Receipt Preset

Tool to update a receipt preset in Wix.

Update Referral Program

Tool to update a site's referral program configuration including name, rewards, and email settings.

Update Review Moderation Status

Tool to update the moderation status of a review.

Bulk Update Review Moderation Status

Tool to bulk update the moderation status of multiple reviews at once.

Update Moderation Rule

Tool to update a moderation rule in Wix Community Feedback Moderation.

Bulk Update Staff Member Tags By Filter

Tool to bulk update tags on Wix Bookings staff members by filter criteria.

Bulk Update Storage Item Tags

Tool to bulk update tags on multiple storage items in Wix automations.

FAQ

Frequently asked questions

With a standalone Wix MCP server, the agents and LLMs can only access a fixed set of Wix tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Wix and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Claude Agent SDK fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Wix tools.

Yes, absolutely. You can configure which Wix scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Wix data and credentials are handled as safely as possible.

Start with Wix.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Wix tool your agent needs.Free to start.

Start building