# Shopify Ask MCP Migration Audit for Indian D2C Brands

> By Rajkumar Tahalani · Published 2026-11-16 · Source: https://www.howlmedialabs.com/blog/shopify-ask-mcp-migration-audit-india-2026

**TL;DR:** Shopify is retiring Storefront MCP's policy-and-FAQ search in favour of UCP Ask MCP. Indian D2C teams should migrate to the new endpoint before 15 January 2027, declare the Ask capability, parse the structured answer, and test policy, product and regional questions against published store facts—without treating a conversational answer as a binding price, promise or completed action.

Shopify is retiring Storefront MCP's policy-and-FAQ search in favour of UCP Ask MCP. Indian D2C teams should migrate to the new endpoint before 15 January 2027, declare the Ask capability, parse the structured answer, and test policy, product and regional questions against published store facts—without treating a conversational answer as a binding price, promise or completed action.

On 11 November 2026, Shopify marked the old Storefront MCP policy tool as deprecated and action required. The replacement is not a simple rename: the endpoint, capability negotiation, request shape and response path all change.

## What exactly is Shopify deprecating?

Shopify's [deprecation notice](https://shopify.dev/changelog/posts/storefront-mcp-policies-and-faqs-tool-is-being-deprecated-in-favor-of-ucp-mcp-ask-tool) says **search_shop_policies_and_faqs** on the Storefront MCP endpoint is being replaced by the UCP MCP **ask_business** tool.

The old tool is maintained until **15 January 2027**. Shopify directs integrations to:

1. change the endpoint from **/api/mcp** to **/api/ucp/mcp**;
2. declare **dev.ucp.common.ask** in the agent profile;
3. carry the profile URL in the request metadata;
4. send the question inside **ask.query** with optional context and resource IDs; and
5. read the answer from **result.structuredContent.answer.plain**.

That makes this a migration and content-governance project. A technically valid response can still be commercially harmful if a return window, shipping destination or product claim is stale.

## How is Ask different from the old policy search?

Shopify's current [Ask MCP documentation](https://shopify.dev/docs/agents/ask) describes one natural-language tool for questions about products, policies and services. It can use the store's knowledge base, policies and product information, and it can accept buyer context such as country, region, language, currency and intent.

| Area | Old integration assumption | Ask MCP requirement |
| --- | --- | --- |
| Endpoint | Storefront MCP at **/api/mcp** | UCP MCP at **/api/ucp/mcp** |
| Tool | **search_shop_policies_and_faqs** | **ask_business** |
| Discovery | Tool expected by the integration | Check the UCP profile and **tools/list** |
| Grounding | Broad store-policy search | Optional supported product, variant, collection or cart IDs |
| Context | Often implicit | Explicit, minimal buyer context |
| Output | Existing parser-specific result | Plain answer under structured content plus optional links |

Do not hard-code availability. Shopify says the store profile at **/.well-known/ucp** should advertise the capability and its MCP endpoint, while **tools/list** confirms whether **ask_business** is offered for the requesting agent profile.

## Which questions should an Indian D2C audit include?

Use a fixed question bank that reflects purchase friction rather than generic prompts.

| Question group | Example | Source of truth |
| --- | --- | --- |
| Returns | “Can I return a sale item bought from Bengaluru?” | Published refund policy and exclusions |
| Shipping | “Do you deliver to this PIN code and how long might it take?” | Shipping policy plus checkout estimate |
| Product | “Is this variant suitable for a 15-inch laptop?” | Product and variant data |
| Service | “Can this be gift wrapped?” | Published knowledge-base fact |
| Warranty | “Who handles a defect after 30 days?” | Warranty or service policy |
| Payment | “Is COD available for this order?” | Checkout or payment configuration |

The response should be scored on correctness, completeness, source alignment, localization, uncertainty and link quality. A fluent answer that invents a COD promise should score zero for correctness even if its language is polished.

## How should product grounding and buyer context be used?

Shopify says supported store resource IDs can ground a question in a product, variant, collection or cart. Explicit product and variant IDs take priority, and Ask uses up to ten supported IDs.

Use IDs when the answer depends on the item. A broad “What is your return policy?” question can be store-level; “Can I return this final-sale variant?” should include the relevant Shopify resource ID.

Buyer context is provisional, not authoritative. Send only what helps answer the question:

- **address_country: IN** for India-specific policy or availability;
- region or postal code only when delivery or service coverage requires it;
- a supported language preference;
- currency when a comparison needs it; and
- intent when it materially changes relevance.

The [UCP Ask specification](https://ucp.dev/draft/specification/common/ask/) says context should be non-identifying and disclosed progressively. Binding eligibility and policy enforcement still happen through the structured transaction data at checkout.

## Why must teams treat the answer as indicative?

Ask is designed to answer, not act. The UCP specification explicitly separates a conversational answer from structured catalog, cart, checkout and order representations.

If Ask says an item costs ₹2,499 but the catalog returns ₹2,699, the catalog is authoritative. If the answer says an item was added to the cart, that statement is not evidence that a cart changed. A mixed request such as “add two and tell me whether they qualify for free shipping” should clearly state that no cart operation occurred, then answer only the informational part it can support.

This boundary belongs in both code and quality assurance:

- never treat answer text as proof of a completed action;
- never use it as the binding disclosure for safety, allergens or regulated claims;
- prefer authoritative resource links behind policy and product answers; and
- display required warnings instead of burying them in prose.

## What does a practical 24-question audit look like?

Consider a fictional Indian home-and-lifestyle store preparing to migrate. The figures below are synthetic and are not an HML client result.

The team creates 24 questions: six store-policy questions, six India shipping and payment questions, six product-grounded questions and six adversarial or ambiguous questions. Each response is scored from 0 to 2 across six dimensions.

| Dimension | 0 | 1 | 2 |
| --- | --- | --- | --- |
| Correctness | Contradicts source | Partly correct | Matches source |
| Completeness | Omits key condition | Minor gap | Essential conditions present |
| Grounding | Wrong or absent source | General source | Correct policy or product grounding |
| Localization | Wrong market/language | Generic | Appropriate Indian context |
| Uncertainty | Invents certainty | Vague caveat | Clear limit or refusal |
| Link quality | Broken or misleading | Useful but broad | Direct authoritative destination |

**Method:** publish the approved knowledge-base and policy facts first; record the UCP profile and tool list; run every question with a clean session; repeat product questions with and without IDs; change only one context field at a time; capture structured output and links; compare against the written source of truth; and retest every failed item after correction.

A synthetic first pass might score 242 out of 288, with four failures: one sale-item exception omitted, one COD answer inferred from a general FAQ, one Hindi question answered in English and one product answer lacking the requested variant link. The score is not a benchmark. The value is the failure log and a reproducible retest.

## Who owns the content Ask uses?

Shopify's [Fall '26 merchant announcement](https://www.shopify.com/news/fall-26-edition-merchant) says the Knowledge base lets merchants review and publish facts that agents receive, including return windows, shipping destinations and gift services. Shopify may draft or suggest facts, but unpublished suggestions do not reach agents.

Assign owners before migration:

- ecommerce owns product and storefront truth;
- operations owns shipping, returns and service constraints;
- legal or compliance reviews regulated and high-risk wording;
- support supplies recurring questions and edge cases; and
- engineering owns capability discovery, parsing, logging and fallbacks.

Use HML's [AEO Readiness Checker](/tools/aeo-readiness-checker) to identify answerability gaps, then map implementation work through the [AI agents and automation service](/ai-agents-automation). The [agentic commerce glossary](/glossary/agentic-commerce) explains the broader operating model.

For adjacent preparation, read the [Shopify Catalog and Knowledge Base audit](/blog/shopify-catalog-eligibility-knowledge-base-audit-india-2026) and the [Shopify WebMCP storefront readiness audit](/blog/shopify-webmcp-storefront-readiness-audit-india-2026). HML's [SEO case study for an Indian luxury home-decor brand](/case-studies/seo-luxury-home-decor-brand-india) shows why discoverability work still needs validated commercial pages and measurement; its results are not evidence for the synthetic Ask audit above.

## What should the migration deliver?

A release-ready migration should include:

1. an inventory of old tool calls and parsers;
2. the hosted agent profile and declared Ask capability;
3. UCP profile and **tools/list** discovery checks;
4. updated request and response handling;
5. a merchant-approved policy and knowledge-base source map;
6. the fixed question bank and scoring rubric;
7. logs for answers, links, warnings and unresolved IDs; and
8. a rollback or human-support path for low-confidence answers.

If your Shopify store cannot trace an agent answer back to an approved fact, request an [agentic storefront answer audit](/contact). The deliverable should be a migration map, question suite, failure log and ownership workflow—not a promise that conversational commerce will automatically increase sales.

---

## Sources

1. [Storefront MCP policies and FAQs tool is being deprecated in favor of UCP MCP Ask tool](https://shopify.dev/changelog/posts/storefront-mcp-policies-and-faqs-tool-is-being-deprecated-in-favor-of-ucp-mcp-ask-tool) — Shopify developer changelog; published 11 November 2026; accessed 16 November 2026.
2. [Ask MCP](https://shopify.dev/docs/agents/ask) — Shopify developer documentation; accessed 16 November 2026.
3. [Ask Capability](https://ucp.dev/draft/specification/common/ask/) — Universal Commerce Protocol specification; accessed 16 November 2026.
4. [Exponential: Shopify's Fall '26 Edition](https://www.shopify.com/news/fall-26-edition-merchant) — Shopify; published 28 October 2026; accessed 16 November 2026.

## Frequently Asked Questions

### What is Shopify Ask MCP?

Ask MCP exposes the UCP ask_business tool so an AI agent can ask natural-language questions about a Shopify store's products, policies and services. It returns a written answer grounded in the store's knowledge base, policies and supported product information.

### When must stores migrate from the old Shopify policy tool?

Shopify says the deprecated search_shop_policies_and_faqs tool will be maintained until 15 January 2027. Integrations should migrate earlier so teams can validate capability discovery, request shape, response parsing and answer quality before the maintenance window ends.

### Can Ask MCP add products to a cart or start a return?

No. Ask is read-only. Shopify and the UCP specification say it answers questions but does not change carts, place orders or start returns. Those operations require the structured capability that owns the action and its separate authorization and consent flow.

### What should an Indian D2C brand test first?

Start with shipping destinations, return windows, warranty, COD or payment wording, product compatibility and regional questions. Test English plus any supported customer language, include India as buyer context, and compare every answer with the published policy or product source.
