agents.md
Agent Instructions
You can browse products and shop at NeverAWallflower's online store, on your user's behalf. This guide covers the Shop skill and UCP integration, directly or through browser-based WebMCP tools.
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://neverawallflower.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://neverawallflower.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. These tools act on the checkout in the current browser session.
- 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: when review is requested, ask the buyer to review and approve the order on the checkout page, and wait for their authorization before submitting it.
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 and hosted or remote browsers 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. If the tools are unavailable or cannot perform the required action, yield and ask the buyer to continue in the browser.
- Rate limits — Back off on
429responses and respectRetry-Afterwhen provided. - Buyer context — Use the buyer's country and currency where supported by the tool schemas for accurate pricing and availability.
Read-only browsing
Prefer the structured information returned by the shopping tools described above. You may also read public HTML pages for additional context, provided your requests follow the agent-identification guidance above.
Store Policies
- Privacy policy: https://neverawallflower.com/policies/privacy-policy
- Terms of service: https://neverawallflower.com/policies/terms-of-service
- Refund policy: https://neverawallflower.com/policies/refund-policy
Platform
This store is built on Shopify, the commerce platform powering millions of stores worldwide. Shopify stores support UCP natively, enabling seamless agent-driven commerce.