Storefront MCP search_shop_catalog returning "Tool not found" — renamed to search_catalog?

Agentic Commerce
1

We have a production app that uses the Storefront MCP server (https://{store}.myshopify.com/api/mcp) for product search. As of recently, calls to search_shop_catalog are returning:

"Tool not found: search_shop_catalog"

When we call tools/list on our store’s MCP endpoint, the response returns a different set of tools than what’s documented:

Documented (shopify.dev):

  • search_shop_catalog

  • search_shop_policies_and_faqs

  • get_cart

  • update_cart

What tools/list actually returns:

  • search_catalog (renamed, new UCP input/output schema)

  • search_shop_policies_and_faqs

  • get_cart

  • update_cart

  • get_product_details (new)

The new search_catalog tool uses a completely different input schema — arguments must be wrapped in a catalog object with nested context, filters, and pagination. The response format has also changed to UCP (prices in minor units, GID-based IDs, structured media arrays, etc.).

Example — old (documented) format:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_shop_catalog",
    "arguments": { "query": "tea", "context": "Customer searching" }
  }
}

Example — new (working) format:

{
  "jsonrpc": "2.0",
  "method": "tools/call",
  "id": 1,
  "params": {
    "name": "search_catalog",
    "arguments": {
      "catalog": {
        "query": "tea",
        "context": { "intent": "Customer searching" },
        "pagination": { "limit": 10 }
      }
    }
  }
}

Questions:

  1. Was search_shop_catalog intentionally renamed to search_catalog? The docs haven’t been updated.

  2. Is this being rolled out gradually, or should all stores have the new tools now?

  3. Should we expect the update_cart input schema to change as well?

  4. Is there a changelog or migration guide for the UCP format changes?

Shopify’s own docs assistant seems to be down rn
can see older comments about search_shop_catalog not working but it’s not listed as a tool now - totally screwed our plans for testing this week

I had a synthetic test hitting multiple stores last week and was getting results

2

That’s weird. I dont have a production app using the MCP, but I do have a demo one one a dev store.

Happy to test on my end tomorrow. Worked with search_shop_catalog yesterday.
Kinda scary if it’s a gradual rollout that’s breaking like that.

3

there’s another thread here I missed before starting this one

4

Weird. Timeline also doesnt match so looks like a gradual thing?

5

it was deffo working 10 days ago before easter weekend
we ran some synthetic tests last week and it worked then
today it doesn’t
I’m using the new tool now

1 Like
6

It was working Thursday April 9th and broke Friday April 10th (morning). We’re actively working on a demo using the MCP endpoints so I can be sure of the timing of this breaking change.