---
title: WebMCP tools
description: >-
  Learn about the WebMCP tools that Shopify provides on every storefront for AI
  agents.
source_url:
  html: 'https://shopify.dev/docs/api/web-mcp'
  md: 'https://shopify.dev/docs/api/web-mcp.md'
---

# Web​MCP 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](https://developer.chrome.com/docs/ai/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](https://shopify.dev/docs/storefronts/headless/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](https://shopify.dev/docs/apps/build/storefront-mcp) and [Agentic commerce](https://shopify.dev/docs/agents).

***

## How it works

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](https://shopify.dev/docs/api/storefront-events-and-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.

***

## Tools

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

Catalog tools find products and present them to the shopper.

| Tool | Description |
| - | - |
| `search_catalog` | Search 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_store` | List the store's collections, or browse the products in a specific collection. The agent can also take the shopper to the collection page. |
| `get_product` | Get 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_variant` | Take 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

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

| Tool | Description |
| - | - |
| `get_cart` | Get the cart's contents, including line items with product and variant details, quantities, and totals. |
| `update_cart` | Add 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_cart` | Remove everything from the cart. |

### Checkout and orders

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

| Tool | Description |
| - | - |
| `proceed_to_checkout` | Take the shopper to checkout with their current cart, after verifying the cart isn't empty. |
| `manage_orders` | Take 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. |

### Store information

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

| Tool | Description |
| - | - |
| `search_shop_policies_and_faqs` | Answer questions about the store's policies and services, such as returns, shipping, and hours of operation. |

***