agents.md
Agent Instructions — BLENDi
You can browse products and shop at BLENDi's online store. This guide covers the Shop skill and UCP integration.
Shop skill — recommended
Use the Shop skill to help your user shop with this store. Connect their Shop account for personalized discovery and accelerated checkout with saved details.
- Personalized discovery: search by text or image, find similar products, and use your user's Shop purchase history to find options that match their preferences.
- Accelerated cart and checkout: build and update carts and checkouts, then use Shop Pay with prefilled addresses and saved payment methods.
- Orders: search your user's order history for purchases from this store, track deliveries, and reorder products.
Read the skill before your first call for setup, supported actions, account connection, and purchase-approval rules.
UCP integration
This store implements the Universal Commerce Protocol for product discovery, carts, and checkout. Integrate directly with its service, or orchestrate shopping through browser-based WebMCP tools.
Direct integration (MCP)
- Discover the store —
GET https://blendiblender.com/.well-known/ucpreturns its UCP profile, including capabilities, service endpoints, and payment handlers. - Discover available tools — Connect to the MCP endpoint advertised in the profile (
https://blendiblender.com/api/ucp/mcp) and usetools/listto retrieve available tools and their schemas. - Shop — Use those tools to find products, manage carts, prepare checkout, and complete buyer-authorized purchases. Follow returned statuses, messages, and handoff URLs when buyer action is required.
Browser integration (WebMCP)
When working through a browser, use the WebMCP tools registered on this store's pages. The checkout page exposes UCP tools over WebMCP.
- Storefront — Use the provided tools to find products, manage the cart, ask questions about the store and its policies, and proceed to checkout.
- Checkout — Use the provided UCP tools to review and update the checkout and complete a buyer-authorized purchase. Follow required buyer-review steps.
Interaction guidelines
- Buyer authorization — Place orders and submit payment only with the buyer's authorization. Follow required review and approval steps.
- Agent traffic — Agents must identify their requests as agent-initiated. Server-to-server requests must use Web Bot Auth and follow the service's authentication requirements.
- Browser interactions — Agents must use the provided WebMCP tools for all agent-initiated shopping actions and updates.
- Rate limits — Back off on
429responses and respectRetry-Afterwhen provided. - Buyer context — Use the buyer's country and currency for accurate pricing and availability.
Read-only browsing
Discover public URLs through /sitemap.xml. Read product pages at /products/{handle}. Browse collections at /collections/all or /collections/{handle}.
Store Policies
- Privacy policy: https://blendiblender.com/policies/privacy-policy
- Terms of service: https://blendiblender.com/policies/terms-of-service
- Refund policy: https://blendiblender.com/policies/refund-policy
- Shipping policy: https://blendiblender.com/policies/shipping-policy
Platform
This store is built on Shopify. Shopify stores support UCP natively, enabling seamless agent-driven commerce. The Shop skill works across every Shopify store.
Start your own store: https://www.shopify.com/start
Build and test against sample data: https://mock.shop
Shopify developer platform: https://shopify.dev
Shop developer platform: https://shop.dev
Agent discovery: this document is the canonical agent-facing description of the store.