Israel Grocery

Unified Model Context Protocol (MCP) server for Israeli grocery shopping — Shufersal + Tiv Taam with cross-store price comparison, recipe-driven cart automation, and an extensible plugin architecture for future stores.

Features

• Cross-store search — search both Shufersal and Tiv Taam simultaneously
• Price comparison — see side-by-side pricing for any product or full recipe
• Smart recipe shopping — parse any recipe, find the best deals across stores, and add items to the cheapest cart automatically
• Split-cart recommendations — buy each ingredient from wherever it's cheapest and see your total savings
• Preference system — set a preferred store, shopping strategy (cheapest / preferred / quality), organic preference, brand blacklisting, and more
• Diagnostics tool — diagnose() surfaces HTTP errors, response shapes, and session state

Setup

1. Install uv

curl -Ls https://astral.sh/uv/install.sh | sh

2. Install dependencies

cd israelgrocery
uv sync

3. Install Playwright (required for Shufersal browser login)

uv run playwright install chromium

4. Configure environment (optional)

cp .env.example .env
# Edit .env as needed

Running the server

uv run israelgrocery-mcp

Claude Desktop configuration

{
  "mcpServers": {
    "israelgrocery": {
      "command": "uv",
      "args": ["--directory", "/path/to/israelgrocery", "run", "israelgrocery-mcp"]
    }
  }
}

Available MCP Tools

Example prompts for Claude

• "Compare prices for eggs and milk across both stores"
• "I want to make shakshuka — find all the ingredients and tell me where to buy them cheapest"
• "Add this pasta recipe to my Tiv Taam cart: [paste recipe]"
• "Buy each ingredient from wherever it's cheapest and show me the savings"
• "Search for chicken breast on both stores"

Shopping strategies

Adding a new store

1. Create src/stores/mystore.py implementing BaseStore
2. Register it in src/stores/__init__.py → build_registry()
3. Add config in src/config.py
4. Done — all existing tools automatically include the new store

Running tests

uv run pytest tests/ -v