salai-mcp_skill

Overview

This skill uses Salai MCP to provide Israeli grocery discovery, price comparison, and cart workflows. It connects to Salai's remote MCP endpoint to search products, autocomplete queries, discover stores and retailers, manage carts, and compare prices across retailers. It's intended for approved beta users with an API key from Salai Profile.

How this skill works

The skill calls Salai MCP endpoints at https://mcp.salai.co.il/mcp using an authorized API key (Authorization: Bearer or X-API-Key). It exposes discovery tools (get_stores, get_retailers), search endpoints (autocomplete_products, search_products), pricing and comparison endpoints (get_product_prices, compare_prices, cart_of_israel), cart management (get_my_cart, add_cart_item, update_cart_items, remove_cart_item, delete_cart) and complementary recommendations. The workflow resolves products with autocomplete first, enriches results with semantic search, manipulates the user cart, and runs retailer comparisons to find the best prices or complete shopping lists.

When to use it

• When you need fast product search and autocomplete for Israeli grocery items.
• When comparing total cost across multiple Israeli retailers or stores.
• When building or modifying a user cart and syncing items with Salai MCP.
• When discovering nearby stores or retailer options for a product list.
• When you want complementary product recommendations to complete a shopping trip.

Best practices

• Register for Salai MCP beta and wait for approval before calling the API; include clear guidance to users about signup steps and beta status.
• Use autocomplete_products with method:text first, then fallback to method:semantic if results are empty for faster, reliable matches.
• Filter stores by retailerId + storeId for precise store identity; avoid relying on deprecated subChainId for new integrations.
• Never log or expose API keys; always treat Salai API keys as secrets and validate tokens on errors.
• On ambiguous queries call autocomplete before making cart mutations; continue comparisons if a product is missing in one store.

Example use cases

• A shopper types a partial product name — the skill autocompletes and adds the correct SKU to their active cart.
• A price-conscious user compares a full cart across nearby stores to choose the lowest total cost for pickup.
• A personal shopper builds a weekly grocery list, requests complementary recommendations, and then compares prices across preferred retailers.
• A developer integrates store discovery to let users pick a specific retailerId+storeId before running a price comparison.