# The Bag Kenya — MCP Server

Shop limited-edition fashion from Kenya via AI assistants.

## Tools

| Tool | Description |
|---|---|
| `browse_products` | Browse products by category, sorted by price/date/popularity |
| `search_products` | Search by name, description, or style with price filters |
| `get_product` | Full product details — sizes, colors, price, availability |
| `check_stock` | Check specific size/color availability |
| `generate_cart_link` | Create a shopping link with pre-selected products |
| `browse_bundles` | Browse curated product bundles |
| `browse_categories` | List categories with product counts |
| `get_styling_advice` | Get outfit recommendations by occasion, style, or budget |
| `read_blog` | Read fashion blog posts — guides, trends, roundups |
| `store_info` | Delivery, payment, returns, and contact info |

## Setup

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "thebag-ke": {
      "command": "npx",
      "args": ["thebag-ke-mcp"]
    }
  }
}
```

### Claude Code

```bash
claude mcp add thebag-ke -- npx thebag-ke-mcp
```

### From Source

```bash
git clone https://github.com/thebagkenya/mcp-server
cd mcp-server
npm install
npm run build
npm start
```

## Examples

**"Find me a crop tee under KES 2,000"**
→ Uses `search_products` with `query: "crop tee"` and `max_price: 2000`

**"What's in stock in size M?"**
→ Uses `check_stock` with `size: "M"`

**"I need an outfit for a weekend in Nairobi"**
→ Uses `get_styling_advice` with `occasion: "weekend"`

**"Add the black crop tee and linen pants to a cart"**
→ Uses `generate_cart_link` with both product slugs

## About

[The Bag](https://thebag.ke) is Kenya's home for limited-edition clothing drops. New styles weekly, nationwide delivery.