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.

1 Like

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