# @striderlabs/mcp-sephora

MCP connector for **Sephora** beauty retail. Search products, manage your basket, complete purchases, and check Beauty Insider rewards — all from an AI assistant.

## Tools

| Tool | Description |
|------|-------------|
| `sephora_search_products` | Search for beauty products by keyword, category, and sort order |
| `sephora_get_product` | Get full product details, variants (shades/sizes), and reviews |
| `sephora_add_to_basket` | Add a product to the shopping basket |
| `sephora_view_basket` | View basket contents, quantities, and totals |
| `sephora_checkout` | Complete purchase with shipping and payment details |
| `sephora_get_rewards` | View Beauty Insider points, tier, and available rewards |

## Setup

```bash
# Install Playwright browser (one-time)
npx playwright install chromium

# Run the MCP server
npx @striderlabs/mcp-sephora
```

## MCP Configuration

Add to your MCP client configuration:

```json
{
  "mcpServers": {
    "sephora": {
      "command": "npx",
      "args": ["@striderlabs/mcp-sephora"]
    }
  }
}
```

## Usage Examples

### Search for products
```
sephora_search_products({ query: "vitamin C serum", category: "skincare", max_results: 5 })
```

### Get product details
```
sephora_get_product({ product_url: "https://www.sephora.com/product/...", include_reviews: true })
```

### Add to basket
```
sephora_add_to_basket({ product_url: "https://www.sephora.com/product/...", quantity: 1 })
```

### Checkout (dry run)
```
sephora_checkout({ email: "...", first_name: "...", ..., dry_run: true })
```

### View rewards
```
sephora_get_rewards({ email: "you@email.com", password: "yourpassword" })
```

## Technical Details

- **TypeScript** with strict mode
- **Playwright** headless Chromium for browser automation
- **Session management** — single shared browser context with 30-minute timeout
- **MCP SDK** `@modelcontextprotocol/sdk` over stdio transport

## Author

Strider Labs <hello@striderlabs.ai>