Connect your AI Agents to Shopify in minutes

Available tools
list_customers
List all customers in the store with pagination and search
get_customer
Get information about a specific customer by ID
create_customer
Create a new customer with comprehensive validation and error handling
update_customer
Update an existing customer
delete_customer
Delete a customer
update_customer_email_marketing_consent
Update a customer's email marketing consent separately
list_inventory_levels
List inventory levels across locations
adjust_inventory_quantities
Adjust inventory quantities for products at specific locations
list_orders
List and filter orders with comprehensive search options including status, dates, financial status, fulfillment status, and pagination
get_order
Get information about a specific order by ID
create_order
Create a new order
update_order
Update an existing order

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 Shopify MCP server
FAQs on using Merge's Shopify MCP server
What is a Shopify MCP server?
It’s an MCP server that exposes data and functionality from Shopify via tools. Your agents can use these tools to do anything from updating inventory to creating sales orders.
How can I use the Shopify MCP server?
Here are just a few use cases:
- Inventory management automation: Your agent can monitor stock levels and automatically update inventory when suppliers confirm shipments
- Order fulfillment orchestration: Your agent can process incoming orders and coordinate the entire fulfillment workflow: verifying payment, checking inventory, creating shipping labels, notifying warehouses, and updating customers with tracking details
- Product catalog enrichment: Your agent can enhance new product listings by researching competitor pricing, generating SEO-optimized descriptions, and suggesting relevant tags and collections based on market analysis
- Customer experience automation: Your agent can handle return requests end-to-end by verifying eligibility, generating return labels, processing refunds or store credit in Shopify, and logging interactions in your customer service platform
What are popular tools for Shopify’s MCP server?
Here are just a few popular tools across data types:
Orders
- <code class="blog_inline-code">list_orders</code>
- <code class="blog_inline-code">get_order</code>
- <code class="blog_inline-code">cancel_order</code>
- <code class="blog_inline-code">mark_order_paid</code>
Products
- <code class="blog_inline-code">update_product</code>
- <code class="blog_inline-code">update_product_variant</code>
- <code class="blog_inline-code">delete_product</code>
- <code class="blog_inline-code">create_product_variants_bulk</code>
Customers
- <code class="blog_inline-code">list_customers</code>
- <code class="blog_inline-code">get_customer</code>
- <code class="blog_inline-code">create_customer</code>
- <code class="blog_inline-code">delete_customer</code>
What makes Merge Agent Handler’s Shopify MCP server better than alternative Shopify MCP servers?
Here are just a few reasons:
- Enterprise-grade security and DLP: Tool inputs and outputs are scanned for sensitive data, with configurable rules to block, redact, or mask data before it reaches third-party systems
- Authentication and credential management: Agent Handler handles user authorization flows and credential storage so agents never manage secrets directly
- Real-time observability and audit trails: Every tool call is logged, with fully searchable logs to audit, debug, and optimize agent behavior
- Evaluation Suite: Tools can be tested and validated against expected outcomes before production deployment
Can I set custom security rules for Shopify tool calls in Merge Agent Handler?
You can apply seemingly endless rules that align with your security policies and that of your customers. Here are just a few examples:
- Customer payment information: Block any tool calls that would expose full credit card numbers or payment method details from Shopify orders
- Customer PII: Redact email addresses and phone numbers when agents retrieve customer data, showing only masked versions (e.g., j***@example.com, (555)*** -1234)
- Shipping addresses: Prevent agents from accessing full street addresses for high-value orders or VIP customers, limiting visibility to city and state only
- Discount codes: Block agents from creating or retrieving admin-level discount codes that could be exploited if leaked to customers
- Financial data: Mask revenue totals and profit margins when agents query order or product analytics to prevent sensitive business metrics from appearing in logs
- Wholesale pricing: Restrict agents from accessing or modifying wholesale price lists and vendor cost data to protect competitive pricing strategies
How can I start using Merge Agent Handler’s Shopify MCP server?
You can take the following steps:
1. Create your Agent Handler account by signing up for free.
2. Create a new Tool Pack by navigating to "Tool Packs" in the dashboard sidebar and clicking "Create New Tool Pack." Give it a descriptive name (e.g., "Shopify Store Operations").
3. Add the Shopify connector by selecting Shopify from the list of available connectors and adding it to your Tool Pack.
4. Configure authentication type by choosing between individual authentication (each user provides their own Shopify credentials) or shared authentication (organization-level credentials for all users).
5. Select specific tools you want to make available to your agent, or enable all tools by default (such as managing orders, products, customers, and inventory).
6. Register a User identity by navigating to "Registered Users" in the sidebar and creating a new registered user. This represents the identity that will perform actions through your agent.
7. Save your Tool Pack once you've configured all settings.
8. Connect the Tool Pack to your agent using the MCP entry URL provided in your Tool Pack settings. Your agent will now have access to the Shopify tools you've configured.
Explore other MCP servers built and managed by Merge


































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
