Skip to main content

WebMCP tools

When an AI agent helps a shopper on your storefront, it needs a way to act on the page. Without tools, the agent has to read your page's code and simulate clicks on buttons and links, which is slow and error-prone. WebMCP is a proposed web standard that takes a more direct approach: your storefront registers tools with the browser, and the agent calls them with structured inputs and gets structured data back.

Shopify provides WebMCP tools on every Liquid storefront, and on storefronts built with the Hydrogen developer preview. You don't need to install or configure anything. An agent that supports WebMCP can use the tools to search your catalog, manage the shopper's cart, and navigate your store on the shopper's behalf. The tools are live today, but agent support for WebMCP is currently limited to Chromium-based browsers.

Note

These tools serve agents that shoppers bring to your store in their browser. If you're building your own agent that connects to Shopify's MCP servers, refer to Storefront MCP and Agentic commerce.


The tools act on the shopper's live session. Catalog tools read product, collection, and search data through the Storefront API. Cart tools call standard storefront actions, the same functions on Shopify.actions that apps use to update the cart, so an agent's cart changes behave like the shopper's own. If a theme has configured the standard action for cart updates, for example to open a cart drawer, then agents trigger the theme's behavior too.

Everything the agent does happens in the tab the shopper is looking at: cart updates change the cart the shopper sees, and navigation takes the shopper to the page.


The agent chooses which tool to call based on the shopper's request. Each tool ships with a description that tells the agent when to use it.

Catalog tools find products and present them to the shopper.

ToolDescription
search_catalogSearch the store's products, collections, articles, and pages. Returns matching products with prices and availability, plus a link to the full search results page.
browse_storeList the store's collections, or browse the products in a specific collection. The agent can also take the shopper to the collection page.
get_productGet full details for a product, including variants, prices, and which option combinations are in stock. The agent can also take the shopper to the product page.
show_variantTake the shopper to a product page with a specific variant selected. The agent can pass an exact variant, or a partial option selection such as a color, and the tool selects a matching available variant.

Cart tools show what's in the shopper's cart and make changes to it.

ToolDescription
get_cartGet the cart's contents, including line items with product and variant details, quantities, and totals.
update_cartAdd items to the cart, change quantities, or remove items. If a request is ambiguous, then the tool returns options to clarify without changing the cart.
cancel_cartRemove everything from the cart.

These tools take the shopper to checkout, or to their order history.

ToolDescription
proceed_to_checkoutTake the shopper to checkout with their current cart, after verifying the cart isn't empty.
manage_ordersTake the shopper to their order history page, where they can check order status and tracking. If the shopper isn't logged in, then they're asked to log in first.

The agent can look up facts about the store using the store's own content.

ToolDescription
search_shop_policies_and_faqsAnswer questions about the store's policies and services, such as returns, shipping, and hours of operation.

Was this page helpful?