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

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.