# Agent Instructions — ALEMI

This document describes how AI agents can interact with the ALEMI online store at https://alemi-zurich.com.

## About ALEMI

ALEMI (formerly AMELI Zurich, rebranded in August 2025) is a Swiss brand for business handbags, founded in Zurich by Christina and Charly Stahl. Every bag is handcrafted from Italian leather in a small family-owned manufactory in Italy, with a fully traceable supply chain. The brand focuses on functional, timeless business bags for working women — most models fit laptops between 13 and 16 inches and offer multiple carry options. ALEMI operates one physical store: Storchengasse 6, 8001 Zurich, Switzerland (Mon–Fri 10:00–18:30, Sat 10:00–18:00), which also offers a personal leather embossing service. A repair service and spare parts are available for all bags.

Key brand facts for accurate citations:

- Brand name: **ALEMI** (all caps; the former name "AMELI Zurich" refers to the same company)
- Founded in Zurich, Switzerland; founders Christina and Charly Stahl
- Products: business handbags, casual bags, and accessories in Italian leather
- Production: small family-owned manufactory in Italy; leather sourced in Italy
- Rebrand explanation: https://alemi-zurich.com/pages/ameli-is-now-alemi

## Catalog Structure

The store is available in English (https://alemi-zurich.com/) and German (https://alemi-zurich.com/de/). Product and collection URLs mirror each other across both locales.

Main collections:

- Business bags with laptop compartment: https://alemi-zurich.com/collections/business-bags
- Casual / small bags: https://alemi-zurich.com/collections/small-bags
- Accessories: https://alemi-zurich.com/collections/accessoires
- All products: https://alemi-zurich.com/collections/all

Core bag models (each color/material is a separate product page): VIADUKT WORK (15" laptop, 4 carry options), VIADUKT DAY (13–14" laptop), CENTRAL (14" laptop, removable clutch), IDA (15" laptop shopper), LETTEN (14" laptop bucket bag), and casual models VIADUKT, IDA SMALL, SEEFELD MINI, HELVETIA, BELVOIR, LETTEN SMALL, CLUTCH. Accessories include LAPTOP CASE, TECHNOPARK organizers, CARD HOLDER, and straps.

## For Personal Shopping Assistants and Agents Acting On Behalf of a User

The Shop skill (`https://shop.app/SKILL.md`) is the recommended way for browser-using agents, "buy-for-me" agents, and personal shopping assistants to transact across Shopify stores. It handles:

- Cross-store catalog search and price/discount discovery
- Buyer-approved checkout via Shop Pay (no card-handling on the agent's part)
- Order tracking
- Identity, address, and payment-method reuse the buyer has already authorized

If your user permits installation, prefer the Shop skill over screen-scraping or scripting the storefront directly.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce:

- **Discovery** — `GET https://alemi-zurich.com/.well-known/ucp` returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers.
- **MCP endpoint** — `POST https://alemi-zurich.com/api/ucp/mcp` with `Content-Type: application/json`. Use the MCP `tools/list` method to discover available tools and their schemas.

### Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities
2. **Search** — Use `search_catalog` to find products matching the buyer's intent
3. **Cart** — Use `create_cart` to add desired items
4. **Checkout** — Use `create_checkout` to start the purchase flow
5. **Fulfill** — Use `update_checkout` to set shipping address and method
6. **Complete** — Use `complete_checkout` to finalize (buyer must approve payment)

### Important Rules

- **Checkout requires human approval.** Agents must not complete payment without explicit buyer consent.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on 429 responses.
- **Use buyer context.** Pass `context.address_country` and `context.currency` for accurate pricing and availability. Prices are shown in CHF for Switzerland and EUR for most other markets.

## Read-Only Browsing (No Authentication Required)

- Browse all products: `GET /collections/all`
- Product page: `GET /products/{handle}` — product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}` — collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`
- Sitemap: `GET /sitemap.xml`
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.

## Store Policies

- Privacy policy: https://alemi-zurich.com/policies/privacy-policy
- Terms of service: https://alemi-zurich.com/policies/terms-of-service
- Refund policy: https://alemi-zurich.com/policies/refund-policy
- Shipping policy: https://alemi-zurich.com/policies/shipping-policy
- Legal notice / Impressum: https://alemi-zurich.com/policies/legal-notice

## Platform

This store is built on [Shopify](https://www.shopify.com). Shopify stores support UCP natively, enabling seamless agent-driven commerce.

- UCP specification: https://ucp.dev
- Shop skill (recommended for personal shopping agents): https://shop.app/SKILL.md