How to get /.well-known/ucp on Shopify Plus with a Custom Headless Storefront

we re running a custom headless storefront (not hosted by shopify) but still want to offer features like https://eu.boden.com/.well-known/ucp how can we achieve this? is there a way to proxy this?

EDIT: We found its being published on our checkout domain: https://checkout.coffeecircle.com/.well-known/ucp does it make sense to proxy this or better redirect it?

Is the MCP not running by default? I couldnt connect to http://checkout.coffeecircle.com/api/ucp/mcp via MCP inspector.

Hey @cmberlin - could you let me know what the /.well-known/ucp response looks like if possible? Can definitely take a look into this.

Hi @Alan_G , This endpoint will be used for ucp integration. Please see sample response in Under the Hood: Universal Commerce Protocol (UCP) - Google Developers Blog

Also, how to host this custom endpoint on developer store(eg: xxxxx.myshopify.com> for demo puposes.

Hey @Hari_Om_Misra,

Thanks for jumping in!

For hosting UCP on a dev store (xxxxx.myshopify.com), you can’t manually host a custom /.well-known/ucp endpoint on a myshopify.com domain since Shopify controls that path. UCP manifests are auto-generated by Shopify when you enable Agentic Storefronts.

First thing I’d try is checking if Agentic Storefronts is available on your dev store—go to Settings → Apps and sales channels in your Shopify Admin and look for an “Agentic storefronts” section. If it’s there, enabling the toggles in that menu should auto-publish the UCP manifest. That said, dev store access during early rollout can be inconsistent, so if you don’t see it, you might want to reach out to Support directly to ask about eligibility.

If you just need to demonstrate how UCP works conceptually for a demo, you could spin up a mock UCP endpoint on your own domain (not myshopify.com) that returns a sample manifest. The Google UCP Developer Guide, the UCP Specification at ucp.dev, and our engineering writeup on building UCP all have the spec and sample profile structures you’d need. Hope this helps!

Hey @Hari_Om_Misra - just checking to see if the above helped, let me know :slight_smile:

@Alan_G It helped a lot. Thank you.

No worries, I’ll mark this thread as solved, but let me know if I can help out further.

Hi @Alan_G!
if i have a headless shopify store, can i have my custom /.well-known/ucp and mcp server endpoints?

Hey @Alvi_Palloshi - just confirming, you shouldn’t need to host your own UCP profile or MCP server. Shopify generates the business profile for the shop and provides its managed UCP/MCP endpoint. That said, there isn’t currently a supported way to edit or replace that profile, or add custom tools and endpoints to Shopify’s MCP server.

You can host a profile yourself, but that’s an agent/platform profile used by a client calling Shopify, rather than a custom merchant profile.

Since UCP is an open protocol, you could build a completely separate implementation on infrastructure you control, but that would be independent of Shopify’s managed implementation and shouldn’t replace or redirect Shopify’s generated /.well-known/ucp profile.

These docs have a bit more info:

If you can share what custom behaviour you’re hoping to add, I’m happy to help work out whether there’s a supported Shopify surface for it. Hope this helps a bit!