# Agent Instructions — Chesapeake Crab Connection Inc.

You can browse products and shop at Chesapeake Crab Connection Inc.'s online store, https://ordercrabs.com, on your user's behalf. This guide covers the Shop skill and UCP integration.

## Shop skill — recommended

Use the [Shop skill](https://shop.com/SKILL.md) 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](https://ucp.dev) for product discovery, carts, and checkout.

### Direct integration (MCP)

1. **Discover the store** — `GET https://ordercrabs.com/.well-known/ucp` returns its UCP profile, including capabilities, service endpoints, and payment handlers.
2. **Discover available tools** — Connect to the MCP endpoint advertised in the profile (`https://ordercrabs.com/api/ucp/mcp`) 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](https://shopify.dev/docs/agents).

### Checkout in a browser (WebMCP)

The checkout page exposes UCP tools over WebMCP. These tools act on the checkout in the current browser session. Use them to review and update the checkout and complete a buyer-authorized purchase. 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.

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. For details, see [Checkout WebMCP](https://shopify.dev/docs/agents/carts-and-checkout/checkout-webmcp).

## 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](https://shopify.dev/docs/api/storefront#identifying-bots-with-web-bot-auth) and follow the service's authentication requirements.
- **Rate limits** — Back off on `429` responses and respect `Retry-After` when 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 pages for additional context, provided your requests follow the agent-identification guidance above.

- Discover public URLs through `/sitemap.xml`, and read the store overview at `/llms.txt`.
- Read product pages at `/products/{handle}`, or as Markdown with `.md` appended or an `Accept: text/markdown` header.
- 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://ordercrabs.com/policies/privacy-policy
- **Refund policy**: https://ordercrabs.com/policies/refund-policy
- **Shipping policy**: https://ordercrabs.com/policies/shipping-policy
- **Terms of service**: https://ordercrabs.com/policies/terms-of-service

## Platform

This store runs on [Shopify](https://www.shopify.com), which supports UCP natively. The [Shop skill](https://shop.app/SKILL.md) works across every Shopify store.

- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.
