Updated ETGet the DI Daily by Email

AI news for e-commerce professionals, with our take on why it matters.

Shopify deprecates Storefront MCP policies tool in favor of UCP ask_business

Shopify deprecates Storefront MCP policies tool in favor of UCP ask_business
Image: Shopify Developer Changelog

The old search_shop_policies_and_faqs tool will be maintained until January 15, 2027, and agents must now declare a UCP agent profile.

Source: Shopify Developer Changelog

Shopify said in its developer changelog that the search_shop_policies_and_faqs tool on its Storefront MCP server is deprecated in favor of the ask_business tool on UCP MCP, which implements the UCP ask capability (dev.ucp.common.ask). Shopify describes ask_business as answering a buyer's question about a store's policies and services using the store's knowledge base and policies. It is exposed at a new endpoint, https://{shop-domain}/api/ucp/mcp.

The deprecated tool will be maintained until January 15, 2027, Shopify said, but all documentation will refer to Ask MCP. Developers are told to migrate calls to ask_business and update endpoints.

Every request must carry a meta object with ucp-agent.profile, and the agent profile must declare dev.ucp.common.ask. The question goes in ask.query, with optional buyer context such as country or preferred language in ask.context. Shopify notes that ask_business returns a written answer in result.structuredContent.answer.plain rather than raw knowledge base facts or full policy text, so code that parses the old response needs updating. Developers can call tools/list to check whether a store offers ask_business for their agent profile.

Read the full article at Shopify Developer Changelog

Our take

Any agent or app that answers shopper questions about policies on Shopify stores has a hard deadline, and it will now receive Shopify's written answer instead of the policy text itself.

  • Inventory integrations that call the old tool and schedule the migration well before January 15, 2027.
  • Merchants should review their knowledge base and policies, since agents' answers are generated from them.
  • Check with tools/list per store, because availability depends on the agent profile.

Was our take useful?

Key takeaways

  1. Shopify's old Storefront MCP policies tool is maintained only until January 15, 2027
  2. Replacement ask_business runs on a new /api/ucp/mcp endpoint
  3. ask_business returns a written answer, not raw knowledge base facts or full policy text