Skip to main content
The Shopify MCP Server provides AI agents with structured access to Shopify store data via GraphQL, enabling seamless management of products, customers, and orders within the Caylex ecosystem. Through this server, AI agents can search a store’s product catalog, retrieve and update shopping carts, fetch detailed product information, and look up store policies and FAQs — making it ideal for powering AI shopping assistants and conversational commerce experiences. The server connects to Shopify’s Storefront and Checkout APIs, supporting buyer-facing workflows such as product discovery and cart management. Agents interact with live store data, ensuring responses reflect current inventory, pricing, and store configurations.
Prerequisites:
  • A Shopify store with Storefront API access enabled; obtain client credentials (client ID and secret) from the Shopify Dev Dashboard under the Catalog section.
  • A valid API access token with appropriate Storefront API scopes configured for your store.
  • The target Shopify shop domain is required to route requests to the correct merchant store.
Important API details:
  • All data access is performed via Shopify’s GraphQL API; queries are subject to Shopify’s standard GraphQL cost-based rate limits (typically 1,000 cost points per second for Storefront API).
  • Authentication uses a Bearer token (JWT) with a 60-minute TTL; tokens must be refreshed before expiry to maintain uninterrupted agent access.
  • Cart operations (get_cart, update_cart) are scoped to individual buyer sessions and require a valid cart or session identifier to function correctly.
  • Store policies and FAQ search results are limited to content published and accessible via the Storefront API; unpublished or draft content will not be returned.

​
Server Details

​
Authentication

This server does not require authentication.

​
Server Configuration

The following parameters can be set in the server URL when adding this server to your Caylex project:

​
Getting Started

1

Add the server

Navigate to the Server Library and click on the New Server button. Find Shopify in the Caylex Catalog.
2

Server Onboarding flow

Go through the server onboarding flow.
3

Use in a project

Add the server to a project by configuring project connections. Its tools are now available to any agents connected to that project.

​
Available Tools

This server provides 5 tools:
Search for products from the online store, hosted on Shopify.This tool can be used to search for products using natural language queries, specific filter criteria, or both.Best practices:
  • Searches return available_filters which can be used for refined follow-up searches
  • When filtering, use ONLY the filters from available_filters in follow-up searches
  • For specific filter searches (category, variant option, product type, etc.), use simple terms without the filter name (e.g., “red” not “red color”)
  • For filter-specific searches (e.g., “find burton in snowboards” or “show me all available products in gray / green color”), use a two-step approach:
  1. Perform a normal search to discover available filters
  2. If relevant filters are returned, do a second search using the proper filter (productType, category, variantOption, etc.) with just the specific search term
  • Results are paginated, with initial results limited to improve experience
  • Use the after parameter with endCursor to fetch additional pages when users request more results
The response includes product details, available variants, filter options, and pagination info.
Used to get facts about the stores policies, products, or services. Some examples of questions you can ask are:
  • What is your return policy?
  • What is your shipping policy?
  • What is your phone number?
  • What are your hours of operation?”

​
Product

Look up a product by ID and optionally specify variant options to select a specific variant.

​
Cart

Get the cart including items, shipping options, discount info, and checkout url for a given cart id
Perform updates to a cart, including adding/removing/updating line items, buyer information, shipping details, discount codes, gift cards and notes in one consolidated call. Shipping options become available after adding items and delivery address. When creating a new cart, only addItems is required.

Klaviyo

Mailchimp

QuickBooks

​
References

https://shopify.dev/docs/apps/build/devmcp

https://github.com/Shopify/dev-mcp

https://shopify.dev/docs/agents/checkout/mcp