{"$schema":"https://static.modelcontextprotocol.io/schemas/2025-09-29/server.schema.json","name":"il.co.zap/mcp","title":"Zap price comparison (Israel)","description":"Zap (zap.co.il) is Israel's price-comparison site.","version":"1.6.0","websiteUrl":"https://www.zap.co.il/","icons":[{"src":"https://www.zap.co.il/favicon.ico","mimeType":"image/x-icon","sizes":["32x32"]}],"remotes":[{"type":"streamable-http","url":"https://mcp.zap.co.il/claude/mcp"}],"protocolVersion":"2026-07-28","supportedProtocolVersions":["2025-06-18","2025-11-25","2026-07-28"],"serverInfo":{"name":"zap","title":"Zap price comparison (Israel)","version":"1.6.0"},"transport":{"type":"streamable-http","endpoint":"https://mcp.zap.co.il/claude/mcp"},"capabilities":{"tools":{"listChanged":false}},"authentication":{"required":false,"schemes":[]},"instructions":"Zap (zap.co.il) is Israel's price-comparison site. All prices are in Israeli shekels (ILS) and come from Israeli stores; product, category and store names are in Hebrew. Queries may be in Hebrew or English; pass the user's words verbatim. Typical flow: zap_search_products to get a model_id (when status is too_broad, show the categories and ask the user which one they mean; refinement_options lists the attributes Zap shoppers filter by); then zap_get_offers for stores and prices, zap_get_specs for specifications and the WiseBuy expert review, zap_get_reviews for user opinions, zap_get_price_history to judge timing, zap_get_alternatives for similar models. Every result carries a 'url' to the relevant zap.co.il page: show it to the user as the place to see all stores and continue to a store. Facts to respect when summarising: price-history fields describe the last 12 months only (is_period_low is not an all-time low); zap_choice is an algorithmic badge, not a paid placement; sold_via_zap_store means the offer is fulfilled through Zap's own store; results contain no paid placements and no personal data. These tools are read-only; they never buy, reserve or track anything. Do not use them for products sold outside Israel or for general product knowledge.","tools":[{"name":"zap_search_products","title":"Search Zap products","description":"Use this to find products on Zap (zap.co.il, Israel's price-comparison site) by a free-text query in Hebrew or English, for example 'iPhone 16 128GB' or 'מקרר samsung 4 דלתות', and/or by a category code. Returns up to 10 catalog models per page, each with the lowest and highest price in ILS across Israeli stores, the number of stores, the user rating, up to 3 key specs and a canonical zap.co.il page URL to show the user. 'status' tells you whether the result is usable as is: 'ok', 'too_broad' (the query matched many categories: show the user the 'categories' list and ask which one they mean, then search again with 'category'), or 'zero_results'. When a category is given, 'refinement_options' lists the attributes Zap shoppers filter this category by (brand, price range, storage...) with product counts, so you can ask one precise clarifying question; 'category_price_floor' is the cheapest price bucket of the category. Use the returned model_id with zap_get_product, zap_get_offers, zap_get_specs, zap_get_price_history, zap_get_reviews and zap_get_alternatives. Do not use it for general product knowledge, for prices outside Israel, or to look up a store (use zap_get_store). Ranking is Zap's organic relevance; the result never contains paid placements. At least one of 'query' or 'category' is required.","inputSchema":{"type":"object","properties":{"query":{"type":"string","minLength":1,"maxLength":100,"description":"Free-text search, Hebrew or English. Pass the user's words verbatim; do not translate Hebrew to English."},"category":{"type":"string","pattern":"^[a-z0-9-]{2,60}$","description":"Zap category code ('sog'), e.g. 'e-cellphone', 'e-fridge'. Get it from zap_list_categories or from the 'categories' list of a previous search."},"page":{"type":"integer","minimum":1,"maximum":50,"default":1},"page_size":{"type":"integer","minimum":1,"maximum":10,"default":5}},"additionalProperties":false},"annotations":{"title":"Search Zap products","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_product","title":"Get Zap product details","description":"Use this to get the summary of one Zap catalog model by its model_id (from zap_search_products): Hebrew and brand name, category, lowest and highest price in ILS, number of stores, user rating, image and up to 10 key specifications. For the complete specification table and the WiseBuy expert review use zap_get_specs (include_specs=true here is kept for compatibility and returns the same groups). Does not return store offers (zap_get_offers), price history (zap_get_price_history), user reviews (zap_get_reviews) or similar models (zap_get_alternatives). Returns NOT_FOUND if the model_id does not exist.","inputSchema":{"type":"object","properties":{"model_id":{"type":"integer","minimum":1,"description":"Zap model id, e.g. 1234002"},"include_specs":{"type":"boolean","default":false}},"required":["model_id"],"additionalProperties":false},"annotations":{"title":"Get Zap product details","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_offers","title":"Get store offers for a Zap product","description":"Use this to list the Israeli stores selling one Zap catalog model (by model_id) with price, shipping cost, total price in ILS, store rating (0-5), delivery time, condition and import type, sorted by total price from lowest to highest by default (sort: store_rating, zap_choice_first, fastest_delivery). Filters: condition (new by default; refurbished/display items with 'refurbished', second-hand items with 'used', everything with 'all'), include_eilat (offers valid only in Eilat, the VAT-free zone), importer ('official' = authorised importer / official dealer, 'parallel' = personal or parallel import), free_shipping. Per offer you get is_cheapest, zap_choice (an algorithmic badge for reliable stores, not a paid placement), sold_via_zap_store (fulfilled through Zap's own store; such offers may add in_stock, installments_max and pickup_only, live from Zap Store). 'market_overview' summarises all offers before filtering (counts, min and max prices) and 'consumer_notes' lists short factual notes about what the filters hid. The result's 'url' is the zap.co.il model page where the user can see every store. An offer may carry 'store_url': a link to that offer's product page at the store, through Zap (or the Zap Store product page); it never opens a cart or checkout and is absent when not available. This tool never returns store websites directly. Use zap_get_store for details about one store.","inputSchema":{"type":"object","properties":{"model_id":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1,"maximum":20,"default":10},"condition":{"type":"string","enum":["new","refurbished","all","used"],"default":"new"},"include_eilat":{"type":"boolean","default":false,"description":"Include offers valid only in Eilat (VAT-free zone, pick-up in store)"},"importer":{"type":"string","enum":["any","official","parallel"],"default":"any","description":"official = authorised importer/dealer marked by Zap; parallel = personal or parallel import store"},"free_shipping":{"type":"boolean","default":false,"description":"true = only offers with free shipping"},"sort":{"type":"string","enum":["price_low_to_high","store_rating","zap_choice_first","fastest_delivery"],"default":"price_low_to_high"}},"required":["model_id"],"additionalProperties":false},"annotations":{"title":"Get store offers for a Zap product","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_price_history","title":"Get Zap price history","description":"Use this to get the trend of the lowest price of one Zap catalog model over the last 12 months (about 12 monthly points in ILS) with the minimum, maximum, average and latest point, plus computed facts: is_period_low (latest price equals the 12-month minimum; this is NOT an all-time low), position_in_range (0 = at the 12-month minimum, 1 = at the maximum), vs_min_pct and vs_avg_pct (how far the latest price is above the minimum/average, in percent) and trend (rising/falling/stable, from the last point versus the three before it). Useful for 'is it a good time to buy' or 'has the price dropped' questions. Requires a model_id. Returns an empty 'points' array when Zap has no history for the model.","inputSchema":{"type":"object","properties":{"model_id":{"type":"integer","minimum":1}},"required":["model_id"],"additionalProperties":false},"annotations":{"title":"Get Zap price history","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_reviews","title":"Get Zap user reviews","description":"Use this to read user reviews of one Zap catalog model (model_id) or of one store (store_id): a summary (average rating out of 5, number of ratings, rating distribution, date of the latest review, recent trend), the most mentioned pros and cons as written by the reviewers themselves (products), the store's sub-ratings for on-time delivery, service and ease of purchase (stores), and a sample of reviews (rating, date, text in Hebrew, pros/cons, the store's public reply if any). Sample rules: reviews shorter than 15 characters are skipped, texts are cut at 350 characters, and when a critical review (1-2 stars) exists it is always included so the sample is not one-sided. Reviews contain no reviewer identity. Use zap_get_product for just the aggregate rating; use this tool when the user wants actual opinions or quotes. Exactly one of model_id or store_id is required.","inputSchema":{"type":"object","properties":{"model_id":{"type":"integer","minimum":1,"description":"Product reviews. Exactly one of model_id / store_id"},"store_id":{"type":"integer","minimum":1,"description":"Store reviews (store_id from zap_get_offers). Exactly one of model_id / store_id"},"page":{"type":"integer","minimum":1,"maximum":20,"default":1},"limit":{"type":"integer","minimum":1,"maximum":10,"default":5},"sort":{"type":"string","enum":["newest","highest_rating","lowest_rating"],"default":"newest"}},"additionalProperties":false},"annotations":{"title":"Get Zap user reviews","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_specs","title":"Get Zap specifications and expert review","description":"Use this to get the complete specification table of one Zap catalog model (model_id), grouped the way Zap groups it (general, display, hardware, camera, battery...; names in Hebrew, values as on Zap, units separate), plus the WiseBuy expert review when one exists: verdict title, score on a 0-10 scale, short summary, pros and cons as written by the editorial team. 'expert_review.has_expert_review' is false for models without a review. Use it when the user asks for technical details, compatibility, dimensions, or an expert opinion; for prices and stores use zap_get_offers, for user opinions zap_get_reviews, for comparing with similar models zap_get_alternatives (then call this tool for each model you compare).","inputSchema":{"type":"object","properties":{"model_id":{"type":"integer","minimum":1},"include_expert_review":{"type":"boolean","default":true}},"required":["model_id"],"additionalProperties":false},"annotations":{"title":"Get Zap specifications and expert review","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_alternatives","title":"Get similar Zap products","description":"Use this to get up to 6 models that Zap lists as similar to a given model_id (strategy 'direct_competitor': Zap's own similar-products recommendation, same category, typically neighbouring variants and competing brands), each with its lowest price in ILS, store count, user rating, key specs and page URL, and a 'match_reason'. With include_price_context=true each alternative also carries its 12-month price context (latest price, 12-month minimum, is_period_low, position_in_range). The tool does not rank or judge the alternatives and does not list differences; to compare, call zap_get_specs for the models the user is interested in. Other strategies (cheaper, upgrade) are not available yet.","inputSchema":{"type":"object","properties":{"model_id":{"type":"integer","minimum":1},"limit":{"type":"integer","minimum":1,"maximum":6,"default":3},"strategy":{"type":"string","enum":["direct_competitor"],"default":"direct_competitor"},"include_price_context":{"type":"boolean","default":false,"description":"Adds the 12-month price context of each alternative (one extra cached lookup per alternative)"}},"required":["model_id"],"additionalProperties":false},"annotations":{"title":"Get similar Zap products","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_list_categories","title":"Browse Zap categories","description":"Use this to discover Zap category codes ('sog') for zap_search_products. Without arguments it returns the 9 main categories and their sub-categories (Hebrew names). With parent set to a main or sub-category name it returns the next level; leaf categories carry the sog code and a zap.co.il URL. With query it searches all ~700 leaf categories by Hebrew name or sog substring (e.g. query='מקרר' or query='fridge'). Do not use this to search for products.","inputSchema":{"type":"object","properties":{"parent":{"type":"string","maxLength":80,"description":"Exact Hebrew name of a main or sub-category, as returned by a previous call"},"query":{"type":"string","minLength":2,"maxLength":60,"description":"Substring to match against category names (Hebrew) or sog codes (English)"}},"additionalProperties":false},"annotations":{"title":"Browse Zap categories","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}},{"name":"zap_get_store","title":"Get Zap store profile","description":"Use this to get the public profile of one Israeli store listed on Zap by its store_id (from zap_get_offers): name, short description, city, Zap user rating and review count, whether it is currently active, and the main categories it sells. Returns the zap.co.il store page URL (reviews and details); it does not return the store's own website, phone or address. For the store's reviews and sub-ratings use zap_get_reviews with store_id. Do not use it to find products or prices.","inputSchema":{"type":"object","properties":{"store_id":{"type":"integer","minimum":1}},"required":["store_id"],"additionalProperties":false},"annotations":{"title":"Get Zap store profile","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false}}]}