search_shop_policies_and_faqsLABSCO SUMMARY
One way to shop every Shopify store, from product search to checkout.
If you are building a shopping agent, each store answers with the same tools at its own domain, so you write the integration once. Carts can be built and shared with the buyer before any credentials come into play, and checkout sits on the same address for when the buyer is ready.
What it is
The tools a shopping agent needs to buy from one Shopify store: product search, carts and checkout. Every store has them at its own domain, so moving to another store means changing the domain, not the code.
What you get
- search_catalog, lookup_catalog and get_product — search the store's products and read full details, variants included
- create_cart, get_cart, update_cart and cancel_cart — a cart the buyer can open from a link
- create_checkout, get_checkout, update_checkout, complete_checkout and cancel_checkout — turn the cart into an order
- search_shop_policies_and_faqs — returns, shipping and payment questions answered from the store's own policy text
Requirements
The store's domain, and the web address of an agent profile: a small JSON file that declares what your agent does (catalog, cart, checkout). Every call must include that address, so pointing an ordinary chat client at the store is not enough. Shopify's examples use a profile it hosts; you can host your own copy at any public URL. Catalog and cart work without a token, at the lowest rate limits. Checkout needs a token from Shopify's Dev Dashboard or a signed request, and placing the order (complete_checkout) needs a token that Shopify has allowed to complete purchases.
Setup effort
Add the address, then send a profile URL
USE CASES
01
Finding a product in one store
Search the catalog, then read full details and variants.
02
Building a cart with the buyer
Send the whole cart on every update; each one replaces it.
03
Taking the buyer to payment
Convert the cart; place the order or hand off to the store's checkout.
04
Answering a returns question
From the store's own policy text, not a guess.
13 tools
Listed in project docs. Your client may show a different list.
search_cataloglookup_catalogget_productcreate_cartget_cartupdate_cartcancel_cartcreate_checkoutget_checkoutupdate_checkoutcomplete_checkoutcancel_checkoutBEFORE YOU INSTALL
What to know first
Tools you get
13 tools named in the project's documentation. On the main address, which tools your agent is offered depends on the capabilities its profile declares: catalog, cart or checkout.
Requires
- an MCP client that can reach a remote endpoint
- the store's domain in place of {shop-domain}
- a UCP agent profile (a JSON document declaring the cart and/or checkout capability) at a public URL; Shopify publishes example profiles
INSTALLATION
Connect your client
Server setup
ENDPOINT URL
https://<YOUR_SHOP_DOMAIN>/api/ucp/mcpRequirements
- Catalog and cart tools: no token needed, but every call must carry your agent's UCP profile URL (meta.ucp-agent.profile in the tool arguments). Calls without a token get the lowest rate limits.
- Checkout tools on the same address: a Bearer token from Dev Dashboard client credentials via https://api.shopify.com/auth/access_token. Shopify says the token lasts 60 minutes, so fetch a fresh one at runtime. A signed request can build a checkout but cannot place the order: complete_checkout needs a token that Shopify has granted permission to complete purchases.
- Policy/FAQ address (/api/mcp): no authentication.
MCP Clients
Catalog, cart and checkout
Add the store's address to your agent. <YOUR_SHOP_DOMAIN> is the store's own domain.
CATALOG, CART AND CHECKOUT · URL
https://<YOUR_SHOP_DOMAIN>/api/ucp/mcpPut your profile URL in meta.ucp-agent.profile in the arguments of every tool call. For checkout tools, also send your token in an Authorization: Bearer header.
Policy and FAQ address
Optional second address on the same store, for policy and FAQ questions only.
POLICY AND FAQ ADDRESS · URL
https://<YOUR_STOREDOMAIN>/api/mcpThis address needs no authentication.
