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

Connect your AI Agents to Shopify in minutes

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

Start building for free

Read docs

Shopify

Learn more about Merge Agent Handler

Available tools

list_customers

List customers with pagination and search. Use page_info cursor for next page

get_customer

Get a customer by ID. Use list_customers to find valid customer IDs

create_customer

Create a customer. At least one of email, phone, firstname, or lastname required. Use list_customers to check for duplicates

update_customer

Update a customer by ID. Use get_customer to verify the customer exists first

delete_customer

Delete a customer. This action is irreversible. Use list_customers to find valid IDs

update_customer_email_marketing_consent

Update email marketing consent for a customer. Use get_customer to find the customer ID first

list_inventory_levels

List inventory levels across locations. Use listlocations to find valid location IDs. Use pageinfo cursor for next page

adjust_inventory_quantities

Adjust inventory quantities at specific locations. Use listinventorylevels to find inventory item IDs and list_locations for location IDs

list_orders

List and filter orders by status, dates, financial/fulfillment status. Use page_info cursor for next page

get_order

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

create_order

Create a new order. Use list_products to find valid variant IDs for line items

update_order

Update an order. Only email, note, tags, and shippingAddress can be updated. Use get_order to check state

cancel_order

Cancel an order with reason and refund/restock options. Use get_order to check order state first

mark_order_paid

Mark an order as paid. Order must have pending/authorized/partiallypaid status. Use getorder to verify

edit_order_line_items

Modify order line items using Shopify's 3-step edit flow. Set quantity to 0 to remove an item. Use getorder to find lineitem_id values first.

debug_order_fulfillment

Debug order fulfillment status and fulfillment orders. Use get_order first to check basic order info

list_products

List products with pagination and filtering. Use page_info.endCursor for next page

get_product

Get a product by ID. Use list_products to find valid product IDs

create_product

Create a new product. Title is required, status defaults to draft

update_product

Update an existing product. Use get_product to verify the product exists first

delete_product

Delete a product. Use list_products to find valid product IDs. This action is irreversible

set_product_bulk

Create multiple products in bulk. Each product must include a title. Repeating a call creates duplicates. Use list_products to verify results

create_product_variants_bulk

Create multiple variants for a product. Use get_product to check existing variants first

update_product_variants_bulk

Update multiple product variants. Use get_product to find variant IDs. Handles price, SKU, and inventory

update_product_variant

Update a single product variant by ID. Use get_product to find variant IDs

get_shop_info

Get shop information including name, email, domain, currency, timezone, and plan details

list_locations

List all locations for the shop. Use page_info.endCursor for next page

validate_credential

Validate Shopify credentials by checking shop access

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 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.