list-stores
List verified UCP stores, optionally filtered by category and minimum score.
Use when the user wants to shop by category — e.g., "find me a pet store"
or "what shoe stores are available?"
Returns stores sorted by score (highest first) with domain, category, score, and grade.
list-categories
List all available store categories with store counts.
Use to discover what kinds of stores are available before narrowing down.
Returns categories sorted by number of stores (most stores first).
check-domain
Check if a domain supports Universal Commerce Protocol (UCP).
Returns the UCP status, manifest version, capabilities, response latency,
and AI bot access policies (GPTBot, ClaudeBot, Google-Extended, etc.).
The domain is automatically normalized (removes protocol, www, paths).
Examples: "shopify.com", "https://www.example.com/path" → "example.com"
discover-store
Discover available shopping tools on a UCP-enabled store.
Connects to the store's MCP endpoint and lists all available
tools (search, cart, shipping, etc.). Use this to understand
what a store supports before shopping.
Example: domain: "allbirds.com"
search-catalog
Search for products on any UCP-enabled Shopify store.
Searches the store's live product catalog via UCP/MCP and returns
matching products with titles, prices, variants, and images.
Examples:
- domain: "allbirds.com", query: "tree topper"
- domain: "gymshark.com", query: "hoodie"
search-all
Search for products across all verified UCP stores at once.
Fans out the query to multiple stores concurrently and returns
aggregated results grouped by store. Fast stores respond first;
slow/failing stores are skipped gracefully.
Example: query: "running shoes", maxStores: 5
search-policies
Search store policies on any UCP-enabled Shopify store.
Query return policies, shipping policies, refund policies, privacy policies,
terms of service, or any other store policy. Returns the matching policy text.
Use this when a user asks about a store's policies before or after purchase —
e.g., "what is the return policy?", "do they offer free shipping?", "refund window?"
Example: domain: "allbirds.com", query: "return policy"
get-product-details
Get full product details including variant IDs from a UCP-enabled store.
Use this after search-catalog to resolve variant IDs needed for add-to-cart.
Pass the Product ID from search results to get all variants with their IDs.
Example: domain: "allbirds.com", productId: "gid://shopify/Product/123456"
add-to-cart
Add a product to cart on any UCP-enabled Shopify store and get a checkout URL.
Requires a variant ID from the search-catalog or get-product-details results.
Returns the cart contents, checkout URL, and a cart_id token.
To build multi-item carts: pass the returned cart_id back on subsequent calls.
The agent holds the cart_id — no server-side session needed.
Example: domain: "allbirds.com", variantId: "gid://shopify/ProductVariant/12345"
Multi-item: domain: "allbirds.com", variantId: "...", cartId: "gid://shopify/Cart/abc123"
build-bundle
Build a multi-store shopping cart in one call.
Pass an array of items (each with domain + variantId) and get back
per-store checkout URLs. Items on the same store share one cart.
Requires variant IDs — use get-product-details first to resolve sizes/colors.
Example: items: [
{ "domain": "allbirds.com", "variantId": "gid://shopify/ProductVariant/123" },
{ "domain": "gymshark.com", "variantId": "gid://shopify/ProductVariant/456", "quantity": 2 }
]