Connect your AI Agents to Wix in minutes
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 list_blog_posts 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.
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}
11Open 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}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 }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}FAQs on using Merge's Wix MCP server
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.
Ready to try it out?
Whether you're an engineer experimenting with agents or a product manager looking to add tools, you can get started for free now
