Tiv Taam MCP Server

A local Model Context Protocol server that lets you shop at Tiv Taam 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 package manager

Install

cd tiv
uv sync

Configuration

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

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:

{
  "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

uv run pytest tests/