SuperMCP documentation

The server speaks Streamable HTTP at this address:

https://supermcp.co.il/mcp

No account, API key or sign-in is needed. Requests are rate limited per client address.

1. Open Customize > Connectors in Claude.
2. Choose Add custom connector.
3. Name it supermarket-mcp, paste the address above, and leave authentication empty.
4. In a new conversation, ask for a price comparison. Claude calls the tools on its own.

In Claude Code:

claude mcp add --transport http supermarket-mcp https://supermcp.co.il/mcp

Any MCP client that supports remote servers can use the same address. A JSON config:

{
  "mcpServers": {
    "supermarket-mcp": {
      "url": "https://supermcp.co.il/mcp"
    }
  }
}

• What would it cost to have 2 milk 3%, a loaf of bread, a dozen eggs and a kilo of bananas delivered to Dizengoff 100, Tel Aviv?
• מה יעלה לי להזמין 2 חלב 3%, לחם אחיד, ביצים L וקילו בננות לדיזנגוף 100, תל אביב?
• Which supermarkets deliver to Haifa, and what are their delivery fees and minimums?
• Is it cheaper to split this list between two shops?

Expect a ranked list of storefronts with a delivered total for each, the cheapest one named, and any item a storefront does not stock reported as missing. When an answer ends with a basket link, it opens the chosen storefront's basket as one page.

All eight tools are read-only. None places an order, takes payment or changes anything.

optimize_delivery

Prices a whole shopping list at every online storefront that delivers to an address or city, and ranks them on the delivered total: items plus delivery fee plus service fee.

split_order

Checks whether splitting one list across two or three storefronts costs less after both delivery fees.

list_delivery_options

Lists who delivers to an address, with fees and order minimums, without pricing a basket.

get_delivery_terms

Returns one storefront's fee schedule, minimum order and delivery slots.

search_products

Finds catalogue products by Hebrew or English name, brand, category or barcode.

get_product

Returns one product by id or barcode, with its per-chain listings.

suggest_similar_products

Offers other catalogue products when a priced line was the wrong pick.

get_promotions

Returns the current promotions behind a price.

Prices come from the price-transparency files Israeli chains are required by law to publish, plus the chains' own online storefronts. They are online prices, not shelf prices at a named branch, and every price carries the date it was last seen.

The catalogue is Hebrew. Assistants translate item names before calling, so you can ask in any language.

Each item needs one quantity: a pack count, or an amount and unit for weighed goods. When a line is ambiguous, the server asks a clarifying question instead of guessing a product.

Delivery fees are quoted only when they were checked against the retailer's own terms or a cited source. Otherwise the fee is reported as unknown. The binding price is always the one at the retailer's checkout.

curl -s -X POST https://supermcp.co.il/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"optimize_delivery","arguments":{"items":[{"query":"חלב 3%","pack_qty":2},{"query":"בננות","amount":1,"unit":"kg"}],"city":"תל אביב"}}}'

Your shopping list and address are used to answer the request and are not stored as a list. The full policy is on the privacy page (Hebrew), and the terms explain whose price is binding.

Questions, problems or deletion requests: nitaiaharoni1@gmail.com