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

airtable
Airtable
amazon_s3
Amazon S3
anaplan
Anaplan
apollo
Apollo
articulate
Articulate Reach 360
asana
Asana
bamboohr
BambooHR
basecamp
Basecamp
bitbucket
Bitbucket
box
Box
cms_coverage
CMS Coverage
calendly
Calendly
clickup
ClickUp
cloudflare
Cloudflare
confluence
Confluence
contentful
Contentful
databricks
Databricks
datadog
Datadog
docusign
DocuSign
dropbox
Dropbox
dynamics365
Dynamics 365 Sales
figma
Figma
firecrawl
Firecrawl
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_meet
Google Meet
google_sheets
Google Sheets
greenhouse
Greenhouse
hubspot
HubSpot
intercom
Intercom
jira
Jira
jira_service_management
Jira Service Management
linear
Linear
linkedin
LinkedIn
make
Make
microsoft_teams
Microsoft Teams
miro
Miro
monday
Monday.com
npi_registry
NPI Registry
notion
Notion
onedrive
OneDrive
onenote
OneNote
outlook
Outlook
pipedrive
Pipedrive
pubmed
PubMed
pylon
Pylon
quickbooks_online
QuickBooks Online
ramp
Ramp
sapsf
SAP SuccessFactors
salesforce
Salesforce
sendgrid
SendGrid
sentry
Sentry
servicenow
ServiceNow
sharepoint
SharePoint
slack
Slack
snowflake
Snowflake
straker
Straker
stripe
Stripe
teamwork
Teamwork.com
trello
Trello
visualping
VisualPing
weather
Weather
wikipedia
Wikipedia
workday
Workday
x
X
zendesk
Zendesk
zendesk_sell
Zendesk Sell
zohocrm
Zoho CRM
zohodesk
Zoho Desk
zoom
Zoom
zoominfo
ZoomInfo

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