---
title: >-
  Storefront MCP policies and FAQs tool is being deprecated in favor of UCP MCP
  Ask tool - Shopify developer changelog
description: >-
  Shopify’s developer changelog documents all changes to Shopify’s platform.
  Find the latest news and learn about new platform opportunities.
source_url:
  html: >-
    https://shopify.dev/changelog/posts/storefront-mcp-policies-and-faqs-tool-is-being-deprecated-in-favor-of-ucp-mcp-ask-tool
  md: >-
    https://shopify.dev/changelog/posts/storefront-mcp-policies-and-faqs-tool-is-being-deprecated-in-favor-of-ucp-mcp-ask-tool.md
metadata:
  effectiveApiVersion: ''
  affectedApi: []
  primaryTag:
    displayName: API
    handle: api
  secondaryTag:
    displayName: Deprecation announcement
    handle: deprecation-announcement
  indicatesActionRequired: true
  createdAt: '2026-11-10T15:07:00-05:00'
  postedAt: '2026-11-11T12:00:00-05:00'
  updatedAt: '2026-11-10T15:31:49-05:00'
  effectiveAt: '2026-11-11T12:00:00-05:00'
---

November 11, 2026

# Storefront MCP policies and FAQs tool is being deprecated in favor of UCP MCP Ask tool

DateNovember 11, 2026

Flags[Deprecation announcement](https://shopify.dev/changelog?filter=deprecation-announcement)[Action required](https://shopify.dev/changelog?action_required=true)

TagsAPI

Storefront MCP `search_shop_policies_and_faqs` is deprecated. Migrate to UCP MCP's `ask_business` tool by January 15, 2027.

### What's changing

The `search_shop_policies_and_faqs` tool on the Storefront MCP server (`https://{shop}.myshopify.com/api/mcp`) is deprecated in favor of the UCP Ask MCP tool.

UCP MCP implements the UCP ask capability (`dev.ucp.common.ask`) and exposes the following tool at the `https://{shop-domain}/api/ucp/mcp` endpoint:

* `ask_business`: Answer a buyer's question about the store's policies and services, using the store's knowledge base and policies.

The deprecated tool will be maintained until January 15, 2027, but all documentation will refer to Ask MCP.

### What you should do

If you're building with `search_shop_policies_and_faqs`:

* Migrate calls to `ask_business`, and update endpoints to use `https://{shop-domain}/api/ucp/mcp`.
* Include a `meta` object carrying `ucp-agent.profile` in every request. Your agent profile must declare `dev.ucp.common.ask`.
* Send the question in `ask.query`, and optional buyer context (such as country or preferred language) in `ask.context`.
* Note that `ask_business` returns a written answer in `result.structuredContent.answer.plain`, not raw knowledge base facts or full policy text. Update any code that parses the old response.
* Use `tools/list` to check whether a store offers `ask_business` for your agent profile.

See the documentation for Ask MCP (<https://shopify.dev/docs/agents/ask>) for more details.