# Promlly — Agent Commerce Guide

This document tells shopping agents how to discover, browse, and transact with the store at https://promlly.com.

## Scope and source of truth

- Use this guide for store discovery and safe customer assistance.
- The live product page, cart, checkout response, and policy pages are authoritative. Do not rely on cached information when making a purchase decision.
- Prices, inventory, promotions, shipping options, taxes, duties, and delivery estimates may change. Verify them in the live purchase flow immediately before requesting buyer approval.

## Store overview

This store specializes in women's special-occasion dresses:

- Homecoming dresses: /collections/homecoming
- Evening gowns: /collections/evening-gowns
- Prom dresses: /collections/prom-dresses
- Wedding guest dresses: /collections/wedding-guest

## Commerce Protocol (UCP)

The store implements the Universal Commerce Protocol for agent-driven commerce:

- Discovery: `GET https://promlly.com/.well-known/ucp`
- MCP endpoint: `POST https://promlly.com/api/ucp/mcp`

### Supported UCP versions

- 2026-08-25 (latest stable)

- 2026-04-08

- 2026-01-23


Use the discovery document and MCP tool descriptions as the source of truth for supported capabilities, authentication, required parameters, and error responses. Do not assume that an endpoint supports searching, cart updates, checkout, payments, order lookup, or cancellations unless it advertises that capability.

## Browsing the catalog

- All products: `GET /collections/all`
- Product JSON: `GET /products/{handle}.json`
- Browse by category: use the collection links above.
- Sitemap: https://promlly.com/sitemap.xml

Prices and availability are presented in USD. Verify the selected variant's current price and availability before presenting it as purchasable.

## Variants, sizing, and customization

- Read each product's live options to identify available color, size, and other variant combinations. Never infer that an unlisted combination is available.
- Refer buyers to the size chart on the relevant product page. Do not guarantee fit.
- Most styles are available in standard sizes and some support custom sizing. Confirm whether custom sizing is available for the exact product before offering it.
- Collect measurements or other customization details only with the buyer's explicit consent. Before submission, present the selected item, variant, customization details, price, and stated production time for confirmation.
- Custom or altered orders can require additional production time. Use the lead time on the product page as authoritative; general planning guidance is to order 4–8 weeks ahead for weddings or proms.
- Custom-sized, cut, or altered garments may not qualify for standard no-reason returns. Clearly disclose this and link to the return policy; do not guarantee return eligibility.

## Purchase and consent rules

- Never place an order, start payment, submit measurements, or add a paid service without the buyer's explicit approval of the final cart and total.
- Before buyer approval, confirm the item and variant, quantity, customization, merchandise price, discounts, shipping method, taxes/duties where shown, total, and delivery estimate.
- Do not make guarantees about inventory, promotion eligibility, return eligibility, fit, or delivery dates unless the current store response explicitly provides them.
- Keep payment information within the supported checkout flow. Do not request, store, or expose payment credentials outside that flow.
- If a transaction errors, times out, or returns an ambiguous result, do not submit it again automatically. Check the supported order/cart status first, then ask the buyer how to proceed if the outcome remains unclear.

## Policies

- Refund policy: /pages/return
- Privacy policy: /policies/privacy-policy
- Terms of service: /pages/terms-of-service
- Shipping policy: /pages/shipping-policies

When a question is not resolved by the live store data or these policies, direct the buyer to the store's official support channel rather than inventing an answer.