@salai/mcp

SalAi MCP server — instant npx bridge to the SalAi grocery intelligence API.

Connects any MCP client (Cursor, Claude Desktop, etc.) to the SalAi MCP HTTP endpoint via a local stdio bridge. No installation required — just npx.

Quick Start

1. Get your API key

Open the SalAi app → Profile → API Key → Generate (or copy your existing key).

2. Configure your MCP client

Cursor (~/.cursor/mcp.json):

{
  "mcpServers": {
    "salai": {
      "command": "npx",
      "args": ["-y", "@salai/mcp"],
      "env": {
        "SALAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Desktop (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "salai": {
      "command": "npx",
      "args": ["-y", "@salai/mcp"],
      "env": {
        "SALAI_API_KEY": "your-api-key-here"
      }
    }
  }
}

That's it. Restart your MCP client and the SalAi tools will appear.

Alternative: Remote HTTP (no npx needed)

If your client supports remote HTTP MCP endpoints directly (e.g. Cursor), you can skip npx entirely:

{
  "mcpServers": {
    "salai": {
      "url": "https://mcp.salai.co.il/mcp",
      "headers": {
        "Authorization": "Bearer your-api-key-here"
      }
    }
  }
}

CLI Options

npx @salai/mcp [options]

Options:
  --api-key, -k <key>   SalAi API key (or set SALAI_API_KEY env var)
  --url, -u <url>       MCP endpoint URL (default: https://mcp.salai.co.il/mcp)
  --version, -v         Print version
  --help, -h            Show help

Environment Variables

| Variable | Description | |---|---| | SALAI_API_KEY | Your SalAi API key from Profile | | SALAI_MCP_URL | Override the MCP endpoint URL |

Available Tools

| Domain | Tools | |---|---| | Search | autocomplete_products, search_products | | Prices | get_product_prices, compare_prices, cart_of_israel | | Stores | get_stores, get_retailers, get_my_store_context, set_my_selected_store | | Carts | get_my_cart, get_cart, add_cart_item, update_cart_items, remove_cart_item, delete_cart, compare_my_cart | | Recommendations | get_complementary_recommendations |

User-scoped tools (get_my_cart, store context, etc.) require a valid API key.

How It Works

@salai/mcp is a lightweight stdio↔HTTP bridge:

Cursor / Claude Desktop
        │  stdio (MCP)
        ▼
  @salai/mcp (npx)
        │  HTTPS (Streamable HTTP MCP)
        ▼
  https://mcp.salai.co.il/mcp

It connects to the SalAi MCP HTTP endpoint, discovers all available tools, and re-exposes them locally over stdio so any MCP client can use them.