SmartMarket MCP server

Install

No sign up and no API key for the MCP side. Pick your client.

claude mcp add --transport http smartmarket https://marketz.mcp.smartzees.com/mcp

{
  "mcpServers": {
    "smartmarket": {
      "url": "https://marketz.mcp.smartzees.com/mcp"
    }
  }
}

{
  "servers": {
    "smartmarket": {
      "type": "http",
      "url": "https://marketz.mcp.smartzees.com/mcp"
    }
  }
}

curl -X POST https://marketz.mcp.smartzees.com/mcp \
  -H 'Content-Type: application/json' \
  -H 'Accept: application/json, text/event-stream' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

Verify it works

Ask for something only the live catalogue could answer.

Compare the price of eggs across the stores you can see

You should get three or more named Miami stores at different prices, cheapest first. A generic answer with no store names means the connector is not attached to that conversation.

Tools

Three read the catalogue and one writes a basket. The readers carry readOnlyHint, which clients use to decide what may run without asking a person first.

{"query": "lactose free milk", "limit": 2}

{
  "products": [
    { "id": 238327, "name": "fairlife Whole Ultra-Filtered Milk, Lactose Free",
      "price": 6.99, "store": "Sabor Tropical Supermarket Kendall",
      "category": "Beverages", "in_stock": true },
    { "id": 267229, "name": "fairlife Fat Free Ultra-Filtered Milk, Lactose Free",
      "price": 5.89, "store": "BJ's Wholesale Kendall",
      "category": "Beverages", "in_stock": true }
  ],
  "count": 2
}

{"product": "eggs"}

{
  "product": "eggs",
  "stores": [
    { "store": "Sabor Tropical Supermarket Kendall", "price": 3.99,
      "name": "SunUps Eggs, Farm Fresh, Large" },
    { "store": "Restaurant Depot", "price": 4.99,
      "name": "James Farm - Liquid Eggs, Just Whites - 2 lbs" },
    { "store": "BJ's Wholesale Kendall", "price": 8.39,
      "name": "Eggland's Best Eggs, Medium, Hard-Cooked" }
  ],
  "cheapest": { "store": "Sabor Tropical Supermarket Kendall",
                "price": 3.99, "name": "SunUps Eggs, Farm Fresh, Large" }
}

{"items": [{"product_id": 267229, "quantity": 2},
           {"product_id": 256108, "quantity": 1}]}

{
  "basket": [
    { "name": "fairlife Fat Free Ultra-Filtered Milk, Lactose Free",
      "quantity": 2, "unit_price": 5.89, "subtotal": 11.78 },
    { "name": "James Farms - Large Loose Eggs - 7.5 Dz",
      "quantity": 1, "unit_price": 8.99, "subtotal": 8.99 }
  ],
  "count": 3,
  "subtotal": 20.77,
  "tax": 1.66,
  "total": 22.43,
  "checkout_url": "https://marketz.smartzees.com/chat?cart=7b54037a9ba9...",
  "note": "Nothing has been ordered and no payment has been taken."
}

What it will not do

build_basket does not carry readOnlyHint, so a well behaved client asks before running it. That is intended: it puts a real basket in a real shop.

REST API

For code rather than assistants. Every endpoint takes an API key in the X-API-Key header. Ask SmartZees for one.

Search

curl -H "X-API-Key: $SMARTMARKET_KEY" \
  "https://marketz.mcp.smartzees.com/v1/products/search?q=lactose+free+milk&limit=5"

Build a basket

Two calls and a link. Mint a session id, add products to it, then send the shopper to the shop.

SESSION=$(openssl rand -hex 16)

curl -H "X-API-Key: $SMARTMARKET_KEY" -H "Content-Type: application/json" \
  -d "{\"session_id\":\"$SESSION\",\"item_id\":267229,\"quantity\":2}" \
  https://marketz.mcp.smartzees.com/v1/cart/items

echo "https://marketz.smartzees.com/chat?cart=$SESSION"

OpenAPI spec

Machine readable at /openapi.json. Try it out is switched off here on purpose: the basket endpoints write to a live catalogue, so call them from your own code with your own key.

Limits

• Stock is a yes or no. The catalogue's raw stock figure is a placeholder often enough that reporting it as fact would mislead. Whether there is any is accurate.
• Prices are live and they change. Nothing is cached between a search and a basket, so a quote and a checkout page agree.
• Rate limits return 429 with a JSON body. A missing or unknown key returns 401.

Troubleshooting

Health check: /health reports the server and which catalogue it is pointed at.