Connect your AI Agents to Shopify in minutes

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

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, first_name, or last_name 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 list_locations to find valid location IDs. Use page_info cursor for next page

adjust_inventory_quantities

Adjust inventory quantities at specific locations. Use list_inventory_levels 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

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
Copied!

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

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

activecampaign
ActiveCampaign
airtable
Airtable
amadeus
Amadeus
amazon_s3
Amazon S3
anaplan
Anaplan
apollo
Apollo
arize
Arize
articulate
Articulate Reach 360
asana
Asana
attio
Attio
aviationstack
Aviationstack
bamboohr
BambooHR
basecamp
Basecamp
bitbucket
Bitbucket
bitly
Bitly
box
Box
cms_coverage
CMS Coverage
calendly
Calendly
canva
Canva
clickup
ClickUp
clinicaltrials
ClinicalTrials.gov
cloudflare
Cloudflare
coda
Coda
confluence
Confluence
contentful
Contentful
crustdata
Crustdata
databricks
Databricks
datadog
Datadog
docusign
DocuSign
doordash
DoorDash
dropbox
Dropbox
duffel
Duffel
dynamics365
Dynamics 365 Sales
exa
Exa
expensify
Expensify
factset
FactSet
figma
Figma
firehydrant
FireHydrant
firecrawl
Firecrawl
fireflies
Fireflies
foursquare
Foursquare
freshbooks
FreshBooks
freshdesk
Freshdesk
freshservice
Freshservice
front
Front
gamma
Gamma
github
GitHub
gitlab
GitLab
gmail
Gmail
gong
Gong
google_bigquery
Google BigQuery
google_calendar
Google Calendar
google_docs
Google Docs
google_drive
Google Drive
google_maps
Google Maps
google_meet
Google Meet
google_sheets
Google Sheets
google_slides
Google Slides
greenhouse
Greenhouse
hibob
HiBob
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
kintone
Kintone
klaviyo
Klaviyo
linear
Linear
linkedin
LinkedIn
looker
Looker
make
Make
microsoft_teams
Microsoft Teams
microsoft_teams_gcc
Microsoft Teams GCC High
miro
Miro
monday
Monday.com
npi_registry
NPI Registry
notion
Notion
onedrive
OneDrive
onenote
OneNote
oracle_hcm
Oracle HCM
oura
Oura
outlook
Outlook
pagerduty
PagerDuty
paypal
PayPal
pipedrive
Pipedrive
pubmed
PubMed
pylon
Pylon
quartr
Quartr
quickbooks_online
QuickBooks Online
ramp
Ramp
rootly
Rootly
sapsf
SAP SuccessFactors
sabre
Sabre
salesforce
Salesforce
sendgrid
SendGrid
sentry
Sentry
servicenow
ServiceNow
sharepoint
SharePoint
slack
Slack
snowflake
Snowflake
spotify
Spotify

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