# Agent Instructions — Nexa Mart

This document describes how AI agents can interact with Nexa Mart's online store at https://nexa-mart.storeza.ai/.

## Commerce Protocol (UCP)

This store supports agent-driven commerce via a cash-on-delivery profile of the Universal Commerce Protocol (UCP). Endpoints:

- **Discovery** — `GET https://nexa-mart.storeza.ai/.well-known/ucp` returns the store's UCP profile: capabilities, endpoints, and payment policy.
- **MCP endpoint** — `POST https://nexa-mart.storeza.ai/api/ucp/mcp` with `Content-Type: application/json`. Use the MCP `tools/list` method to discover tools and schemas, and `tools/call` to invoke them.

### Payment: Cash on Delivery only

This store does **not** take card or agent payments. Orders are paid in cash on delivery. Placing a checkout creates a COD order; the buyer pays the courier in person.

### Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities.
2. **Search** — `search_catalog` to find products matching the buyer's intent.
3. **Cart** — `create_cart` to price the desired items (server recomputes totals).
4. **Checkout** — `create_checkout` to preview the order and total.
5. **Complete** — `complete_checkout` to place the cash-on-delivery order (buyer must approve).
6. **Track** — `get_order_status` with the order number + buyer phone or email.

### Important Rules

- **Checkout requires human approval.** Do not call `complete_checkout` without the buyer's explicit consent. You must collect the buyer's name, phone, and delivery address, confirm the items and total, then set `buyer_approved: true`.
- **No payment is handled.** This is cash on delivery; never request card details.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on `429` responses with exponential delay.
- **Use buyer context.** Pass the delivery `city`/`address` for accurate fulfillment.

### Available MCP Tools

- `search_catalog` — Search this store's public products by free-text query and/or category. Returns matching products with price, currency, availability, URL and image.
- `get_product` — Get full details for one product by id or slug, including size/color options.
- `create_cart` — Build a priced cart from items. Validates availability and recomputes totals server-side. Returns line items, subtotal, delivery fee and total. Stateless — pass the returned cart to create_checkout.
- `create_checkout` — Preview a cash-on-delivery checkout: validates items + buyer details and returns an order summary and total to confirm. Does NOT place the order. No payment is taken.
- `complete_checkout` — Place a cash-on-delivery order. The buyer must have explicitly approved this purchase. Requires buyer name, phone and delivery address. Returns the order number and status. Payment is cash on delivery — the buyer pays the courier; no card or agent payment is involved.
- `get_order_status` — Look up the status of an order by order number. Requires the buyer's phone OR email on the order for verification.

## Read-Only Browsing

For agents that only need to read store data without transacting:

- Store homepage: `GET https://nexa-mart.storeza.ai/`
- Product page: `GET https://nexa-mart.storeza.ai/product/{slug}`
- Product feed (JSON): `GET https://nexa-mart.storeza.ai/feed.json`
- Sitemap: `GET https://nexa-mart.storeza.ai/sitemap.xml`
- AI summary: `GET https://nexa-mart.storeza.ai/llms.txt`

## Categories

- POWER BANKS: https://nexa-mart.storeza.ai/?category=f0b58352-a7ac-412a-9cf3-dd40501c92ca
- PHONE COOLER: https://nexa-mart.storeza.ai/?category=23e802c6-c1b2-4efd-8fd9-f43dae4d3609
- CAMERAS: https://nexa-mart.storeza.ai/?category=4d331e61-72da-4046-a0cf-2daf469eb300
- SMART WATCH: https://nexa-mart.storeza.ai/?category=3b039d96-6614-4be7-9724-c697009e919b
- LIGHT: https://nexa-mart.storeza.ai/?category=34d64cee-b1fe-4a24-ac84-a268ebd61582
- Self Defence: https://nexa-mart.storeza.ai/?category=5c916682-30e6-4641-a9c6-e9efbe70910b
- STICKERS: https://nexa-mart.storeza.ai/?category=074f9315-a0c8-4516-abe4-ffc315af7cce
- MOUSE: https://nexa-mart.storeza.ai/?category=4e6bb719-b973-45cb-9a24-51ee2ce63cec

## Products (snapshot)

- Havit MS1034 RGB Programmable Gaming Mouse — 1120.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/havit-ms1034-rgb-programmable-gaming-mouse
- Havit MS1035 RGB Programmable USB Gaming Mouse — 980.00 USD — In stock — https://nexa-mart.storeza.ai/product/havit-ms1035-rgb-programmable-usb-gaming-mouse
- Havit HV-MS1027 USB Gaming Mouse — 720.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/havit-hv-ms1027-usb-gaming-mouse
- Wall Mount Deer Head Hanger — 330.00 USD — In stock — https://nexa-mart.storeza.ai/product/wall-mount-deer-head-hanger
- Mini printer roll Per Psc — 90.00 USD — In stock — https://nexa-mart.storeza.ai/product/mini-printer-roll-per-psc
- 3d Wall Stiker — 375.00 USD — In stock — https://nexa-mart.storeza.ai/product/3d-wall-stiker
- Self Defence Electric Shock And LED Flashlight With Extra Carry Bag — 1050.00 USD — Out of stock — https://nexa-mart.storeza.ai/product/self-defence-electric-shock-and-led-flashlight-with-extra-ca
- Self Defence Stun Gun-928 with Flashlight — 1750.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/self-defence-stun-gun-928-with-flashlight
- 5m Best Quality LED Strip Light With 5050 RGB With 24Keys Remote/Bluetooth App Control/3Keys USB Cable — 1220.00 USD — In stock — https://nexa-mart.storeza.ai/product/5m-best-quality-led-strip-light-with-5050-rgb-with-24keys-re
- Rose Fairy Light — 480.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/rose-fairy-light
- 16ft strip light — 750.00 USD — In stock — https://nexa-mart.storeza.ai/product/16ft-strip-light
- Star Shape Led String Light — 399.00 USD — In stock — https://nexa-mart.storeza.ai/product/star-shape-led-string-light
- USB Star Projector Light — 360.00 USD — In stock — https://nexa-mart.storeza.ai/product/usb-star-projector-light
- A59 plus Smart Watch Premium — 2380.00 USD — In stock — https://nexa-mart.storeza.ai/product/a59-plus-smart-watch-premium
- X8 Plus Smart watch, which combines a smart watch with a mini dual SIM phone — 3680.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/x8-plus-smart-watch-which-combines-a-smart-watch-with-a-mini
- Watch 4 pro Smart Watch — 2280.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/watch-4-pro-smart-watch
- T900 ultra 2 BIG smart watch C Grate — 720.00 USD — Out of stock — https://nexa-mart.storeza.ai/product/t900-ultra-2-big-smart-watch-c-grate
- Children’s Fun Instant Print Camera — 3550.00 USD — In stock — https://nexa-mart.storeza.ai/product/childrens-fun-instant-print-camera
- Mini Flip Digital Camera LK-027 — 2500.00 USD — In stock — https://nexa-mart.storeza.ai/product/mini-flip-digital-camera-lk-027
- Imou Ranger Dual Indoor Smart Security Camera C0470 — 7500.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/imou-ranger-dual-indoor-smart-security-camera-c0470
- Dinosaur Premium FunShot Mini Print Camera C0500 — 3250.00 USD — In stock — https://nexa-mart.storeza.ai/product/dinosaur-premium-funshot-mini-print-camera-c0500
- LOXROZ Kids Camera Rechargeable 2 inch LCD Digital Video Action Camcorder C0678 — 1550.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/loxroz-kids-camera-rechargeable-2-inch-lcd-digital-video-act
- kids Instant Digital Print Camera C0688 — 3499.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/kids-instant-digital-print-camera-c0688
- SSOMEX TL16 Mobile Phone Cooling Fan — 1200.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/ssomex-tl16-mobile-phone-cooling-fan
- MEMO CX12 Magnetic Phone Cooler – 10W Radiator with Digital Display & Rechargeable Battery for Phones & Gaming — 1750.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/memo-cx12-magnetic-phone-cooler-10w-radiator-with-digital-di
- FS06 Semiconductor Cooling Mobile Phone Cooler — 1450.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/fs06-semiconductor-cooling-mobile-phone-cooler
- Plextone UF1 RGB Magnetic Radiator Phone Cooler — 1550.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/plextone-uf1-rgb-magnetic-radiator-phone-cooler
- AL-12 Magnetic Mobile Phone Cooler — 1460.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/al-12-magnetic-mobile-phone-cooler
- Memo CX15 Mobile phone cooler — 1680.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/memo-cx15-mobile-phone-cooler
- Memo CX10 Mobile phone cooler — 1560.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/memo-cx10-mobile-phone-cooler
- Mobile Cooler K20 — 1220.00 USD — In stock — https://nexa-mart.storeza.ai/product/mobile-cooler-k20
- Joyroom JR-QP192 20000mAH — 2480.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/joyroom-jr-qp192-20000mah
- KUKE PC108 45W Super Fast Charging Power Bank – 20000mAh — 4850.00 USD — In stock — https://nexa-mart.storeza.ai/product/kuke-pc108-45w-super-fast-charging-power-bank-20000mah
- New Version WGP mini UPS 10400mAh – 5/9/12V – Black — 2250.00 USD — In stock — https://nexa-mart.storeza.ai/product/new-version-wgp-mini-ups-10400mah-5912v-black
- Remax RPP-166 20000mAh Lango Series Power Bank — 1780.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/remax-rpp-166-20000mah-lango-series-power-bank
- JOYROOM JR-W020 10000mah 20W Magnetic Wireless Mini Power Bank — 2280.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/joyroom-jr-w020-10000mah-20w-magnetic-wireless-mini-power-ba
- Joyroom JR-QP191 10000mAh 22.5W Fast Charging Power Bank — 1480.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/joyroom-jr-qp191-10000mah-225w-fast-charging-power-bank
- Transparent power bank 20000mah — 2480.00 USD — Out of stock — https://nexa-mart.storeza.ai/product/transparent-power-bank-20000mah
- Joyroom JR-L017 22.5W 20000Mah Power Bank with Dual Cables — 2380.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/joyroom-jr-l017-225w-20000mah-power-bank-with-dual-cables
- Transparent power bank 10000mah — 1580.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/transparent-power-bank-10000mah
- Baseus Adaman 20000 mAh Power Bank 22.5W Premium — 2550.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/baseus-adaman-20000-mah-power-bank-225w-premium
- 20W Magnetic Wireless Power Bank with Stand — 2280.00 USD — In stock — https://nexa-mart.storeza.ai/product/20w-magnetic-wireless-power-bank-with-stand
- Remax RPP-296 20000mAh power bank from the Landon series — 1850.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/remax-rpp-296-20000mah-power-bank-from-the-landon-series
- Baseus Bipow Digital Display 15W 10000mAh Power Bank — 1550.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/baseus-bipow-digital-display-15w-10000mah-power-bank
- QIF QY-54 Mini PD30W Power Bank – 10000mAh — 2750.00 USD — In stock — https://nexa-mart.storeza.ai/product/qif-qy-54-mini-pd30w-power-bank-10000mah
- ZOKD 45W Fast Charging Power Bank — 4550.00 USD — In stock — https://nexa-mart.storeza.ai/product/zokd-45w-fast-charging-power-bank
- Ven-Dens 20000mAh Power Bank 🔋⚡ — 1680.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/ven-dens-20000mah-power-bank
- VEN-DENS 10000mAh Power Bank 🔋⚡ — 999.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/ven-dens-10000mah-power-bank
- QIF QY-45 10000mAh Fast Charging Power Bank — 2550.00 USD — In stock — https://nexa-mart.storeza.ai/product/qif-qy-45-10000mah-fast-charging-power-bank
- Good Cool D301 10000mAh Power Bank 🔋⚡ — 1050.00 USD — Limited availability — https://nexa-mart.storeza.ai/product/good-cool-d301-10000mah-power-bank

## Platform

This store is built on Storeza (https://storeza.ai), an AI store builder for small businesses. Storeza stores are cash-on-delivery and expose a UCP profile per store for agent-driven commerce.