# Tiv Taam MCP Server

A local [Model Context Protocol](https://modelcontextprotocol.io) server that lets you shop at [Tiv Taam](https://www.tivtaam.co.il) through Claude — including recipe-driven cart population.

## Features

- **Login** with your Tiv Taam credentials (email + password)
- **Search** products in Hebrew or English
- **Parse recipes** — free text or URL — into ingredient lists
- **Match ingredients** to the best available products
- **Add to cart** — individual items or an entire recipe in one shot

## Setup

### Prerequisites

- [uv](https://docs.astral.sh/uv/) package manager

### Install

```bash
cd tiv
uv sync
```

## Configuration

Copy `.env.example` to `.env` and adjust if needed:

```bash
cp .env.example .env
```

Key settings:

| Variable | Default | Description |
|---|---|---|
| `TIVTAAM_RETAILER_ID` | `1062` | Tiv Taam retailer ID |
| `TIVTAAM_BRANCH_ID` | `943` | Branch ID (943 = Netanya) |
| `TIVTAAM_MAX_SEARCH_RESULTS` | `8` | Max results per search |

## Claude Desktop Integration

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "tivtaam": {
      "command": "uv",
      "args": ["--directory", "/path/to/tiv", "run", "tivtaam-mcp"]
    }
  }
}
```

## Available Tools

| Tool | Description |
|---|---|
| `login_status` | Check if you're logged in |
| `login` | Log in with email & password |
| `set_shopping_preferences` | Set organic/budget/brand prefs |
| `search_products` | Search for products by keyword |
| `plan_recipe_ingredients` | Parse a recipe into ingredients |
| `match_recipe_to_products` | Find best product matches for a recipe |
| `view_cart` | See your current cart |
| `add_items_to_cart` | Add specific products by ID |
| `add_recipe_to_cart` | Parse recipe & add to cart in one step |

## Example Prompts

- *"Search for hummus"*
- *"What's in my cart?"*
- *"Add recipe to cart: 400g pasta, 3 garlic cloves, 100ml olive oil"*
- *"Plan the ingredients for this recipe: [URL]"*

## Running Tests

```bash
uv run pytest tests/
```