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:

1. A shopper asks about products while browsing a store.
2. Your agent searches the store's catalog and manages carts.
3. The shopper adds items and completes checkout.

Anchor to Connect to the serverConnect to the server

Each Shopify store has its own MCP server endpoint that exposes storefront features. This endpoint handles all server calls for product search, cart operations, and policy questions:

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.

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:

1. Replace {shop}.myshopify.com with the store's actual domain.
2. Send requests to the store's MCP endpoint.
3. Include the Content-Type header.

Here's how to set up a request:

Anchor to Tool endpointsTool endpoints

Anchor to UCP catalog toolsUCP catalog tools

The UCP catalog tools (search_catalog, lookup_catalog, and get_product) are available on a separate endpoint from the standard Storefront MCP tools:

These tools implement the Universal Commerce Protocol (UCP) catalog capability and use a catalog wrapper object in their request arguments. Refer to the UCP catalog specification for the full reference.

Anchor to Standard toolsStandard tools

The standard Storefront MCP tools (get_cart, update_cart, and search_shop_policies_and_faqs) are available on a separate endpoint from the UCP-conforming tools:

Anchor to Available toolsAvailable tools

Anchor to search_catalogsearch_catalog

Searches the store's product catalog to find items that match your customer's needs.

Key parameters (inside catalog object):

• query: Free-text search query
• context: Buyer signals for relevance and localization (country, language, currency, intent)
• filters: Filter by categories or price range (in minor currency units)
• pagination: Cursor-based pagination (cursor, limit)

Example use:

Anchor to lookup_cataloglookup_catalog

Retrieves products or variants by identifier. Use this when you already have product or variant IDs from search results, saved lists, or deep links.

Key parameters (inside catalog object):

• ids: Array of product or variant identifiers (required, up to 10)
• context: Buyer signals for localization
• filters: Post-resolution filters (categories, price)

Example use:

Anchor to get_productget_product

Retrieves full details for a single product, with optional interactive variant selection. Use this when a customer has selected a product and needs detailed information for a purchase decision.

Key parameters (inside catalog object):

• id: Product or variant identifier (required)
• selected: Option selections for variant narrowing (e.g., [{"name": "Color", "label": "Blue"}])
• preferences: Option names in relaxation priority order
• context: Buyer signals for localization
• filters: Post-resolution filters (categories, price)

Example use:

Anchor to search_shop_policies_and_faqssearch_shop_policies_and_faqs

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:

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 cart

Example 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 optional line_item_id for existing items)

Example use: