# Suita

> Suita is an online store of curated, high-quality everyday goods shipped worldwide from our partner factories. Delivery usually takes 7–15 business days.

AI agents can shop here for a person: search the catalog, price a basket for a destination country, and place an order. The buyer enters their email and shipping address and pays on a secure payment page (payment_url on suita.store); agents never handle card details. No API key is needed.

## Agent APIs

- [MCP server](https://suita.store/api/mcp): remote MCP (Streamable HTTP). Tools: search_products, get_product, get_quote, create_order, get_order_status.
- [OpenAPI spec](https://suita.store/api/agent/v1/openapi.json): the same operations as REST under https://suita.store/api/agent/v1.

## How to order

1. search_products (GET /products?query=...) and get_product (GET /products/{id}) to pick a variant_id.
2. get_quote (POST /quote) with items and the buyer's country: shows shipping, tax, total and problems.
3. Confirm the items, quantities, destination country and total with the buyer.
4. create_order (POST /orders) with the country and a random idempotency_key; give the buyer payment_url, where they enter their email and address and pay. Stock is held for 30 minutes.
5. get_order_status (GET /orders/{id}?token=order_token) to follow payment and shipping.

Items from different stores need one order per store. Quote product facts from get_product; do not invent them.

## Policies

- Returns and shipping policies are returned by get_product for each store.
- [Privacy policy](https://suita.store/privacy) · [Terms](https://suita.store/terms) · [Support](https://suita.store/support)
- Contact: contact@suita.store