Storefront MCP server
Connect your AI agent to a specific Shopify store's catalog, shopping cart, and policies. The Storefront MCP server helps customers browse and buy with their selected merchant.
Anchor to How it worksHow it works
The Storefront MCP server lets your AI agent handle shopping tasks for the selected store:
- A shopper asks about products while browsing a store.
- Your agent searches the store's catalog and manages carts.
- The shopper adds items and completes checkout.
Anchor to Connect to the serverConnect to the server
Each Shopify store has its own MCP endpoint that exposes the storefront features. All MCP calls for product search, cart operations, and policy questions go to this single endpoint:
This endpoint is unique to each store and gives access to all storefront commerce capabilities. Your app needs to configure this endpoint based on which store the customer is shopping with.
By using the Shopify MCP servers, you agree to the Shopify API License and Terms of Use.
Anchor to Create an API request to the Storefront MCP serverCreate an API request to the Storefront MCP server
Storefront MCP servers don't require authentication:
- Replace
storedomain
with the store's actual domain. - Send requests to the store's MCP endpoint.
- Include the Content-Type header.
Here's how to set up a request:
Note: Some stores may restrict access. Always test with your specific store.
Anchor to Available toolsAvailable tools
The Storefront MCP server provides a set of tools to help customers browse and buy from a specific store. Use the tools/list
command to discover available tools and their capabilities. Each tool is documented with a complete schema that defines its parameters, requirements, and response format.
Searches the store's product catalog to find items that match your customer's needs.
Key parameters:
-
query
: The search query to find related products (required) -
context
: Additional information to help tailor results (optional)Response includes:
-
Product name, price, and currency
-
Variant ID
-
Product URL and image URL
-
Product description
Example use:
Tip: Create Markdown links for product titles using the URL property to help customers navigate to product pages.
Answers questions about the store's policies, products, and services to build customer trust.
Key parameters:
-
query
: The question about policies or FAQs (required) -
context
: Additional context like current product (optional)Example use:
Tip: Use only the provided answer to form your response. Don't include external information that might be inaccurate. For better store policy management, consider using the Knowledge Base app to configure store policies.
Anchor to get_cartget_ cart
Retrieves the current contents of a cart, including item details and checkout URL.
Key parameters:
-
cart_id
: ID of an existing cartExample use:
Anchor to update_cartupdate_ cart
Updates quantities of items in an existing cart or adds new items. Creates a new cart if no cart ID is provided. Set quantity to 0 to remove an item.
Key parameters:
-
cart_id
: ID of the cart to update. Creates a new cart if not provided. -
lines
: Array of items to update or add (required, each withquantity
and optionalline_item_id
for existing items)Example use: