Israel Grocery MCP

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

Tool	Description
login_status()	Show login status for all stores
login_tivtaam(email, password)	Log in to Tiv Taam
login_shufersal()	Open browser for Shufersal login
check_login(store_id?)	Live session validation
set_preferences(...)	Shopping preferences
search_products(query, stores?)	Search across stores
compare_prices(query)	Price comparison for an item
show_cart(store_id?)	View cart(s)
add_to_cart(store_id, product_id, qty)	Add to a specific cart
plan_recipe_ingredients(recipe_text)	Parse recipe ingredients
compare_recipe(recipe_text)	Full recipe cost comparison
add_recipe_to_cart(recipe_text, ...)	Automated recipe shopping
diagnose(store_id?)	Debug API connections

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

Strategy	Behaviour
cheapest (default)	Each item is bought from whichever store has the lower price
preferred_store	Always use your set preferred store unless it has no match
quality	Prefer the highest-confidence product match regardless of price

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