# Elegance

AI-powered commerce API for luxury skincare shopping. Enables AI agents to search products, browse collections, manage shopping carts, and generate checkout URLs for the Regenique Elegance Shopify st…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add regenique/elegance-commerce

# Browse available tools
npx -y @smithery/cli@latest tool list regenique/elegance-commerce

# Get full schema for a tool
npx -y @smithery/cli@latest tool get regenique/elegance-commerce search_products

# Call a tool
npx -y @smithery/cli@latest tool call regenique/elegance-commerce search_products '{}'
```

## Direct MCP Connection

Endpoint: `https://elegance-commerce--regenique.run.tools`

**Optional config:**
- `locale` (query) — Preferred locale for product data (e.g., en-US)
- `currency` (query) — Preferred currency for prices (e.g., USD)

## Tools (12)

- `search_products` — Search for products by keyword. Returns matching products with titles, descriptions, prices, and images. Use this to fi…
- `get_product` — Get detailed information about a specific product by its handle (URL slug) or ID. Returns full product details includin…
- `list_collections` — List all product collections/categories in the store. Returns collection names, descriptions, and handles for navigatio…
- `get_collection_products` — Get all products within a specific collection. Use the collection handle to retrieve products organized by category.
- `filter_products` — Filter products by various criteria including vendor/brand, product type, price range, and availability. Useful for nar…
- `create_cart` — Create a new shopping cart, optionally with initial items. Returns the cart ID needed for subsequent operations.
- `get_cart` — Get the current contents and total of a shopping cart.
- `add_to_cart` — Add a product variant to an existing cart. Use the variant ID from product details.
- `update_cart` — Update quantities of items already in the cart. Set quantity to 0 to remove an item.
- `remove_from_cart` — Remove one or more items from the cart by their line IDs.
- `update_buyer_info` — Add or update buyer information (email, phone, country) on the cart for checkout.
- `get_checkout_url` — Get the Shopify checkout URL. The user must be redirected to this URL to complete payment. This requires human escalati…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get regenique/elegance-commerce <tool-name>
```

## Resources

- `regenique://store/info` — Basic information about Regenique Elegance store including brand details and contact info
- `regenique://collections/list` — List of all product collections/categories available in the store
- `regenique://brands/list` — List of luxury skincare brands available at Regenique Elegance
- `regenique://shipping/info` — Shipping policies, rates, and international shipping details

## Prompts (4)

- `find_skincare_product` (skin_type, concerns, budget) — Help a customer find the perfect skincare product based on their skin type and concerns
- `build_skincare_routine` (skin_type, goals) — Create a complete skincare routine with morning and evening products
- `gift_recommendation` (occasion, recipient, budget) — Recommend luxury skincare gifts for special occasions
- `compare_products` (product_names) — Compare two or more skincare products to help customer decide