What is Salai MCP and who can use it?

Salai MCP is a beta service for Israeli grocery discovery, price comparison, and cart workflows. Access requires beta signup and approval, with an API key issued via Salai Profile.

How do I authenticate to the MCP endpoint?

Use the Salai API key in the Authorization header as Bearer or in X-API-Key: , and call the full /mcp endpoint https://mcp.salai.co.il/mcp.

What if a product isn't found in one store?

Continue the comparison with available alternatives across other stores; the skill is designed to fall back to alternatives and still provide pricing.

Salai MCP (Beta)

Verified

@IdoZiv

npx machina-cli add skill @IdoZiv/salai-mcp --openclaw

Files (1)

SKILL.md

2.8 KB

Salai MCP Skill

Use Salai's remote MCP server for Israeli grocery discovery, comparison, and cart workflows.

Access requirements

Salai MCP is currently in beta.
Users must register to the beta program and be approved.
Only approved beta users can generate an API key from Salai Profile and use MCP tools.
Registration: go to https://app.salai.co.il, create an account (Sign up), and wait for beta approval.
Beta access contact: beta@salai.co.il

Connection

Endpoint: https://mcp.salai.co.il/mcp
Auth: send a user API key from Salai Profile using either:
- Authorization: Bearer <SALAI_API_KEY>
- X-API-Key: <SALAI_API_KEY>

Use the full /mcp endpoint directly for best client compatibility.

Tools

Discovery:
- get_stores
- get_retailers
Search:
- autocomplete_products
- search_products
Pricing and comparison:
- get_product_prices
- compare_prices
- cart_of_israel
Cart management:
- get_cart
- get_my_cart
- update_cart_items
- add_cart_item
- remove_cart_item
- delete_cart
Recommendations:
- get_complementary_recommendations

Recommended workflow

Resolve products quickly with autocomplete_products (method: text first, then semantic if empty).
Use search_products for richer semantic results and recommendations.
Build/modify the active user cart with get_my_cart, add_cart_item, update_cart_items, and remove_cart_item.
Compare total cost across retailers with compare_prices.
Use cart_of_israel for one-shot comparison of the default Cart of Israel list.

Store scope conventions

When filtering by store, prefer retailerId + storeId.

subChainId may be accepted by some tools for backward compatibility, but is deprecated for store identity.

Error handling

If access is denied, instruct the user to complete beta signup and wait for approval.
If an auth error occurs, request a valid Salai API key and retry.
If a product is not found in one store, continue comparison with available alternatives.
For ambiguous product names, call autocomplete_products before cart mutations.

Security

Never log or expose API keys in output.
Treat all API keys as secrets.

Source

git clone https://clawhub.ai/IdoZiv/salai-mcpView on GitHub

Overview

Salai MCP lets you discover Israeli groceries, search and autocomplete products, compare prices across retailers, and manage carts via Salai's remote MCP endpoint. It enables store and retailer discovery and offers complementary product recommendations to streamline shopping.

How This Skill Works

Authenticate with a Salai API key and call the /mcp endpoint at https://mcp.salai.co.il/mcp. Use the discovery and search tools (get_stores, get_retailers, autocomplete_products, search_products) to identify products, then build or modify a cart with add_cart_item and update_cart_items, finally comparing prices with compare_prices and optionally using cart_of_israel for a one-shot check.

When to Use It

You need to quickly find a product across Israeli stores using autocomplete or search.
You want richer semantic results and recommendations for a given query.
You are assembling or modifying a shopping cart across multiple retailers.
You need a side-by-side price comparison to choose the best deal.
You want complementary product recommendations based on your cart.

Quick Start

Step 1: Obtain a Salai API key from your Salai Profile and call the /mcp endpoint (Authorization: Bearer <API_KEY> or X-API-Key: <API_KEY> at https://mcp.salai.co.il/mcp).
Step 2: Resolve products with autocomplete_products (text first, semantic if needed) and then use search_products for richer results and recommendations.
Step 3: Build your cart with get_my_cart and add_cart_item/update_cart_items, then use compare_prices (and cart_of_israel if desired) to evaluate deals.

Best Practices

Resolve products with autocomplete_products first (text), then semantic if needed.
Fetch or build your cart with get_my_cart before adding or updating items.
Compare total prices across retailers with compare_prices after cart changes.
When filtering stores, prefer retailerId + storeId for accuracy.
Always secure API keys and do not log or expose them in outputs.

Example Use Cases

Search for a specific item (e.g., bread) and compare prices across Israeli stores.
Add items to your cart from multiple retailers and adjust quantities.
Use complementary recommendations to find related products for a meal.
Run cart-based price checks with cart_of_israel for a quick retailer comparison.
If an item isn't found in one store, continue comparing alternatives.

Frequently Asked Questions

Add this skill to your agents