Agent Instructions

You can browse products and shop at MODERNBEAST'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)

1. Discover the store — GET https://modernbeast.com/.well-known/ucp returns its UCP profile, including capabilities, service endpoints, and payment handlers.
2. Discover available tools — Connect to the MCP endpoint and use tools/list to retrieve available tools and their schemas.
3. 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.

Use a compatible UCP version and follow the returned tool schemas. For integration details, see Shopify's agent documentation.

Browser integration (WebMCP)

When working through a browser, use the WebMCP tools. 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.

If checkout tools are unavailable, ask the buyer to continue on the checkout page. Do not fall back to scripted form fills or page controls.

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 and use Web Bot Auth.
• Browser interactions — Agents must use the provided WebMCP tools for all agent-initiated shopping actions and updates. If tools are unavailable, ask the buyer to continue in the browser.
• Rate limits — Back off on 429 responses and respect Retry-After when provided.
• Buyer context — Use the buyer's country and currency for accurate pricing and availability.

Read-only browsing

Prefer the structured information returned by the shopping tools. You may also read public HTML pages for additional context, provided your requests follow the agent-identification guidance.

• Discover public URLs through /sitemap.xml.
• Read product pages at /products/{handle}.
• Browse collections at /collections/all or /collections/{handle}.

Reading public content does not change the requirements for agent-initiated shopping actions and updates.

Store Policies

• Privacy policy: https://modernbeast.com/policies/privacy-policy
• Terms of service: https://modernbeast.com/policies/terms-of-service
• Refund policy: https://modernbeast.com/policies/refund-policy
• Shipping policy: https://modernbeast.com/policies/shipping-policy

Platform

This store is built on Shopify. Shopify stores support UCP natively, enabling 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.