Merge Unified's Wix integration Merge Agent Handler's Wix MCP server

Connect your AI Agents to Wix in minutes

Merge lets you securely connect your agents to Wix and thousands of tools instantly

Start building for free

Read docs

Wix

Learn more about Merge Agent Handler

Available tools

list_blog_posts

List published blog posts with pagination. Optionally filter by featured or category.

get_blog_post

Get a blog post by ID. Use listblogposts to find valid IDs.

list_blog_categories

List blog categories with pagination.

create_draft_post

Create a draft blog post. Publish separately after review.

list_services

List booking services with pagination. Services define what can be booked.

get_service

Get a booking service by ID. Use list_services to find valid IDs.

list_bookings

List bookings with pagination.

get_booking

Get a booking by ID. Use list_bookings to find valid IDs.

cancel_booking

Cancel a booking. Requires revision from get_booking.

list_contacts

List contacts with pagination. Use offset+limit to page through results.

get_contact

Get a contact by ID.

create_contact

Create a new contact. At least one of email, phone, or name is required.

update_contact

Update a contact. Requires revision from get_contact to prevent conflicts.

delete_contact

Delete a contact. Cannot delete contacts who are site members.

query_contacts

Query contacts with filters. Supports $eq, $in, $startsWith operators.

query_inventory

Query inventory items with cursor pagination. Optionally filter by product ID.

get_inventory

Get an inventory item by ID. Use query_inventory to find IDs.

update_inventory

Update inventory item. Requires revision from get_inventory.

increment_inventory

Add stock to an inventory item. Item must have quantity tracking enabled.

decrement_inventory

Remove stock from an inventory item. Item must have quantity tracking enabled.

list_orders

List eCommerce orders with offset pagination. Returns orders sorted by creation date.

get_order

Get an order by ID. Use list_orders to find valid order IDs.

cancel_order

Cancel an order. Only approved orders can be canceled.

create_fulfillment

Create a fulfillment for an order. Specify line items and optional tracking info.

list_products

List products with offset pagination. Requires Wix Stores app on site.

get_product

Get a product by ID.

create_product

Create a new product in the Wix store.

update_product

Update a product. Requires revision from get_product.

delete_product

Delete a product from the store.

search_products

Search products by text with cursor pagination. Use cursor for next page.

validate_credential

Validate Wix credentials by fetching site properties.

View all tools by creating a free account See more tools

How to set up Merge Agent Handler

In an mcp.json file, add the configuration below, and restart Cursor.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "url": "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
5      "headers": {
6        "Authorization": "Bearer yMt*****"
7      }
8    }
9  }
10}
11

Copy Code

Open your Claude Desktop configuration file and add the server configuration below. You'll also need to restart the application for the changes to take effect.

Make sure Claude is using the Node v20+.

Learn more in the official documentation ↗

1{
2  "mcpServers": {
3    "agent-handler": {
4      "command": "npx",
5      "args": [
6        "-y",
7        "mcp-remote@latest",
8        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
9        "--header",
10        "Authorization: Bearer ${AUTH_TOKEN}"
11      ],
12      "env": {
13        "AUTH_TOKEN": "yMt*****"
14      }
15    }
16  }
17}

Copy Code

Open your Windsurf MCP configuration file and add the server configuration below.
Click on the refresh button in the top right of the Manage MCP server page or in the top right of the chat box in the box icon.

Learn more in the official documentation ↗

1{
2    "mcpServers": {
3      "agent-handler": {
4        "command": "npx",
5        "args": [
6          "-y",
7          "mcp-remote@latest",
8          "https://ah-api.merge.dev/api/v1/tool-packs/<tool-pack-id>/registered-users/<registered-user-id>/mcp",
9          "--header",
10          "Authorization: Bearer ${AUTH_TOKEN}"
11        ],
12        "env": {
13          "AUTH_TOKEN": "<ah-production-access-key>"
14        }
15      }
16    }
17  }

Copy Code

In Command Palette (Cmd+Shift+P on macOS, Ctrl+Shift+P on Windows), run "MCP: Open User Configuration".

You can then add the configuration below and press "start" right under servers. Enter the auth token when prompted.

Learn more in the official documentation ↗

1{
2  "inputs": [
3    {
4      "type": "promptString",
5      "id": "agent-handler-auth",
6      "description": "Agent Handler AUTH_TOKEN", // "yMt*****" when prompt
7      "password": true
8    }
9  ],
10  "servers": {
11    "agent-handler": {
12      "type": "stdio",
13      "command": "npx",
14      "args": [
15        "-y",
16        "mcp-remote@latest",
17        "https://ah-api-develop.merge.dev/api/v1/tool-packs/{TOOL_PACK_ID}/registered-users/{REGISTERED_USER_ID}/mcp",
18        "--header",
19        "Authorization: Bearer ${input:agent-handler-auth}"
20      ]
21    }
22  }
23}

Copy Code

FAQs on using Merge's Wix MCP server

What is a Wix MCP?

It's an MCP server that lets your agents access data and functionality from a Wix site via tools. Your agents can invoke these tools to manage contacts, create and update products, process orders, handle bookings, and more.

Wix offers an official MCP server, but you can also use one from a third-party platform, like Merge Agent Handler.

How can I use the Wix MCP server?

The use cases naturally depend on the agent you've built, but here are a few common ones:

Order fulfillment automation: An agent monitors incoming Wix orders and automatically creates a fulfillment record, decrements inventory, and sends a confirmation to the customer via email or SMS

Contact sync to CRM: An agent detects a new Wix contact created through a form submission and creates or updates the corresponding record in HubSpot or Salesforce, keeping sales teams current without manual exports

Inventory threshold alerts: An agent queries inventory levels across products on a schedule and sends a Slack alert to the operations team when any SKU drops below a configured threshold

Booking management: An agent listens for booking cancellations in Wix, updates availability in a calendar system, and notifies the service provider with the cancellation details

What are popular tools for Wix's MCP server?

Here are some of the most commonly used tools:

list_contacts: retrieves Wix contacts with optional filters by name, email, or label. Useful for agents that need to sync a site's contact list to a downstream CRM or identify new leads since the last run

create_contact: adds a new contact to the Wix site with specified fields including name, email, and phone. Call this when an agent captures a lead from an external source and needs to register it in Wix

list_orders: fetches e-commerce orders with filters for status, date range, or buyer. Good for workflows that need to process new orders, build fulfillment queues, or generate sales summaries

create_fulfillment: marks an order as fulfilled and attaches tracking information. Use this when an agent confirms a shipment in a logistics system and needs to update the corresponding Wix order automatically

list_products: returns the product catalog with pricing, inventory status, and variant details. Helpful when an agent needs to audit the catalog or check product availability before processing an order

update_inventory: sets or adjusts inventory quantities for a specific product variant. Call this when an agent needs to reflect stock changes from a warehouse or POS system back into Wix

What makes Merge Agent Handler's Wix MCP server better than alternative Wix MCP servers?

There are a few key reasons to choose Merge Agent Handler's Wix MCP server over building your own or using an alternative:

Enterprise-grade security and DLP: Merge Agent Handler includes built-in data loss prevention controls that let you block or redact sensitive fields before they reach an agent. For Wix, this means you can prevent customer contact details, order payment information, or private booking data from being exposed even when the agent has broad read access

Managed authentication and credentials: Merge stores and refreshes Wix credentials on your behalf. You never expose raw API keys or OAuth tokens to an agent or manage token rotation manually

Real-time observability and audit trail: Every tool call made against Wix is logged with timestamp, tool name, input parameters, and response metadata. You can audit exactly what an agent read or wrote without instrumenting anything yourself

Tool Packs and controlled access: Tool Packs let you bundle specific Wix tools with tools from other connectors into a single MCP endpoint, scoped to a specific use case. An agent gets exactly the tools it needs, nothing more

How can I start using Merge Agent Handler's Wix MCP server?

You can take the following steps:

1. Create or log into your Merge Agent Handler account.

2. Install the Merge CLI by running pipx install merge-api, then run merge configure to link the CLI to your Merge account and merge login to authenticate your session.

3. Register the Agent Handler MCP server with Claude Code by running claude mcp add --transport http agent-handler https://ah-api.merge.dev/mcp, then open Claude Code and run /mcp to confirm agent-handler appears with a connected status.

4. Select agent-handler from the MCP list. This opens a browser window where you select which integrations to authenticate. Choose Wix and complete the auth flow. Merge stores and manages the credentials going forward.

5. Open a Claude Code session and start querying Wix data directly. The first time you use a Wix tool, a Magic Link may appear to complete connector authentication.

If you want to connect Merge Agent Handler's Wix MCP with internal or customer-facing agentic products, you can follow the steps in our docs.