Lezzoo
Order food, groceries & pharmacy delivery in Kurdistan & Iraq: search, menus, cart, checkout.
我該用這個嗎
品質與安全性
發現項目（2）
- LOWTool 'auth_status' description lacks action verb在 auth_status 中
- LOWTool 'logout' description lacks action verb在 logout 中
根據工具定義與協定合規性的自動化分析。
上下文成本
這是每次將伺服器的工具載入模型上下文時所消耗的約略 token 數量。數量越高，可用於其他工作的注意力就越少。
安裝
一鍵安裝
將以下內容加入你的 `claude_desktop_config.json` 檔案：
{
"mcpServers": {
"lezzoo": {
"url": "https://mcp.lezzoo.com/mcp"
}
}
}遠端端點
https://mcp.lezzoo.com/mcpstreamable-http它能做什麼
工具清單
工具（21）
🟢search(query, latitude, longitude, city, language, ...)
Search Lezzoo for restaurants/stores near a location. Results are ranked by relevance and proximity, so location matters: pass the user's latitude/longitude when known. If location is unknown, the user's area/address can be used to derive it; otherwise a configured default location applies. Returns restaurants as cards (when the host supports MCP Apps). Use a returned merchant's `merchant_id` with `search_merchant_products` to open its menu. Anonymous — no sign-in or account is required. Read-only.
輸入結構描述
{
"type": "object",
"properties": {
"query": {
"type": "string",
"minLength": 1,
"description": "Free-text search term, e.g. 'burger', 'pharmacy', 'pizza'."
},
"latitude": {
"type": "number",
"minimum": -90,
"maximum": 90,
"description": "User latitude (-90..90). Ask the user if unknown; falls back to the server default."
},
"longitude": {
"type": "number",
"minimum": -180,
"maximum": 180,
"description": "User longitude (-180..180). Falls back to the server default."
},
"city": {
"type": "string",
"enum": [
"Erbil",
"Duhok",
"Sulaymaniyah",
"Zakho",
"Kirkuk",
"Baghdad",
"Massif",
"Shaqlawa",
"Akre",
"Koye",
"Soran",
"Halabja",
"Said_Sadq",
"Khanaqin",
"Sharazwr",
"Kalar"
],
"description": "City to scope results. Defaults server-side."
},
"language": {
"type": "string",
"enum": [
"en",
"ar",
"kr",
"bd"
],
"description": "Result language: en, ar, kr, bd."
},
"departmentId": {
"type": "integer",
"description": "Optional department id to scope to one vertical (e.g. Food, Grocery, Pharmacy)."
},
"page": {
"type": "integer",
"minimum": 1,
"description": "1-based result page (default 1)."
}
},
"required": [
"query"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"summary": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "Result summary: merchant_count, tags, truncated, note."
},
"merchants": {
"type": "array",
"items": {},
"description": "Matched restaurants/stores as cards (each has merchant_id, name, …)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢search_merchant_products(merchantId, categoryId, query, city, language, ...)
Show the menu for a merchant/restaurant by merchant_id (from a `search` result). The result includes the menu's `categories` (sections); pass a `categoryId` to browse that section's items (paged via `page`, with `has_more`). Omit both to show the top items; provide `query` to search within the menu. Renders as cards with category tabs and Prev/Next when the host supports MCP Apps. Results are paginated — a single response is only part of the menu. To locate a specific item, call this with `query="<item name>"`, which searches the entire menu across pages and sections (more reliable than paging for finding a named item).
輸入結構描述
{
"type": "object",
"properties": {
"merchantId": {
"type": "integer",
"description": "Merchant id, e.g. from a `search` result's merchant_id."
},
"categoryId": {
"type": "integer",
"description": "Menu section id (from the result's `categories`) to browse."
},
"query": {
"type": "string",
"description": "Optional search term within this merchant; omit for the menu."
},
"city": {
"type": "string",
"enum": [
"Erbil",
"Duhok",
"Sulaymaniyah",
"Zakho",
"Kirkuk",
"Baghdad",
"Massif",
"Shaqlawa",
"Akre",
"Koye",
"Soran",
"Halabja",
"Said_Sadq",
"Khanaqin",
"Sharazwr",
"Kalar"
],
"description": "City scope. Defaults server-side."
},
"language": {
"type": "string",
"enum": [
"en",
"ar",
"kr",
"bd"
],
"description": "Result language: en, ar, kr, bd."
},
"page": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "1-based page within the category (default 1)."
}
},
"required": [
"merchantId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "The merchant (merchant_id, name)."
},
"product_count": {
"type": "number",
"description": "Number of products in this response."
},
"categories": {
"type": "array",
"items": {},
"description": "Menu sections (id, name)."
},
"category_id": {
"type": "number",
"description": "The section this page is showing."
},
"page": {
"type": "number",
"description": "1-based page within the category."
},
"has_more": {
"type": "boolean",
"description": "Whether more pages exist for this section."
},
"total_found": {
"type": "number"
},
"products_omitted": {
"type": "number"
},
"products": {
"type": "array",
"items": {},
"description": "Products on this page."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_full_menu(merchantId, language)
Fetch the entire menu of a merchant in one call — all categories and all items. Use this when the user wants to browse the full menu, or when you need to find an item across all sections without paging. Returns every category with its products. Capped at 250 items total; if truncated, use search_merchant_products with query= to find specific items.
輸入結構描述
{
"type": "object",
"properties": {
"merchantId": {
"type": "integer",
"description": "Merchant id (from a search result's merchant_id)."
},
"language": {
"type": "string",
"enum": [
"en",
"ar",
"kr",
"bd"
],
"description": "Result language: en, ar, kr, bd."
}
},
"required": [
"merchantId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "The merchant (merchant_id, name)."
},
"categories": {
"type": "array",
"items": {},
"description": "Every menu section, each with its products."
},
"product_count": {
"type": "number",
"description": "Total items across all sections."
},
"truncated": {
"type": "boolean",
"description": "True if the menu was capped at 250 items."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_product_details(productId, language)
Show full details for a single product/menu item by product_id (obtain it from a `search_merchant_products` result). Returns the image, description, price/discount, stock, and addon options (sizes, extras, toppings) with their prices — rendered as a card when the host supports MCP Apps. Call this when the user taps a product or asks about a specific item.
輸入結構描述
{
"type": "object",
"properties": {
"productId": {
"type": "integer",
"description": "Product id, e.g. from a `search_merchant_products` result's product_id."
},
"language": {
"type": "string",
"enum": [
"en",
"ar",
"kr",
"bd"
],
"description": "Result language: en, ar, kr, bd."
}
},
"required": [
"productId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"product": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "The product: name, price, stock, image, options/addons."
},
"merchant": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "The owning merchant (merchant_id, name, city)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_top_searches
Return the platform's currently trending / most-searched terms. Useful for suggesting what users can look for. Takes no arguments.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"top_searches": {
"type": "array",
"items": {
"type": "string"
},
"description": "Trending search terms."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢auth_status
Return whether the customer is signed in for this session, and who.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"signed_in": {
"type": "boolean"
},
"customer_id": {
"type": "number"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢logout
Sign the customer out of this session (clears the stored token).
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"signed_out": {
"type": "boolean"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_profile
Return the signed-in customer's profile (name, phone, email, language, loyalty tier, total orders, member-since). Requires the customer to be signed in for this session. Read-only.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"customer_id": {
"type": "number"
},
"name": {
"type": "string"
},
"phone": {
"type": "string"
},
"email": {
"type": "string"
},
"language": {
"type": "string"
},
"city_id": {
"type": "number"
},
"loyalty_tier": {},
"subscription_id": {
"type": "number"
},
"prime_expiry": {
"type": "string"
},
"total_orders": {
"type": "number"
},
"member_since": {
"type": "string"
},
"verified": {
"type": "boolean"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_addresses
Return the signed-in customer's saved delivery addresses (title, details, type, coordinates). Requires the customer to be signed in for this session. Read-only.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"addresses": {
"type": "array",
"items": {},
"description": "Saved delivery addresses (address_id, title, details, coords)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_order_history
Return the signed-in customer's orders — `current` (in-progress) and `history` (past), each with merchant, status, total, item count and date. Requires the customer to be signed in for this session. Read-only.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"current": {
"type": "array",
"items": {},
"description": "In-progress orders."
},
"history": {
"type": "array",
"items": {},
"description": "Past orders."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢track_order(orderId)
Track a Lezzoo order live — status, ETA, driver name/status/location, merchant, destination, and the ordered items (name, description, quantity, price, chosen options, image) — rendered as a status card with a progress stepper (and a map when the driver's live position is available). Pass an order_id, or omit it to track the customer's most recent active order. Requires sign-in. Read-only. Call again to refresh.
輸入結構描述
{
"type": "object",
"properties": {
"orderId": {
"type": "integer",
"description": "Order id to track. Omit to track the most recent active order."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"tracking": {
"anyOf": [
{},
{
"type": "null"
}
],
"description": "null when there is no active order to track."
},
"message": {
"type": "string"
},
"order_id": {
"type": "number"
},
"status": {
"type": "string"
},
"status_id": {
"type": "number"
},
"fulfillment": {
"type": "string"
},
"placed_at": {
"type": "string"
},
"eta_minutes": {
"type": "number"
},
"total": {
"type": "number"
},
"currency": {
"type": "string"
},
"verification_code": {
"type": "string"
},
"merchant": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"driver": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
],
"description": "Driver info, or null before assignment."
},
"destination": {
"anyOf": [
{
"type": "object",
"properties": {},
"additionalProperties": true
},
{
"type": "null"
}
]
},
"timeline": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {},
"additionalProperties": true
},
"description": "Ordered lines: product_id, name, description, quantity, price (unit, incl. options), line_total, image, options [{name, values:[{name, price}]}], instructions."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢view_cart
Show the current shopping cart (items, options, quantities, line prices, subtotal). Anonymous — no sign-in required. Read-only.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant_id": {
"type": "number"
},
"merchant_name": {
"type": "string"
},
"merchant_city": {
"type": "string"
},
"currency": {
"type": "string"
},
"items": {
"type": "array",
"items": {},
"description": "Cart line items (line_id, product_id, name, quantity, prices, options)."
},
"item_count": {
"type": "number"
},
"subtotal": {
"type": "number"
},
"message": {
"type": "string",
"description": "Present on an empty cart."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡add_to_cart(items, productId, quantity, optionValueIds, language)
Add one or more products to the cart in a single call (put a whole request's items in one call). For several of the SAME item use `quantity` (e.g. "2 Chili Boxes" → quantity: 2). For DIFFERENT products use `items` (an array of { productId, quantity?, optionValueIds? }), each with its own `quantity`. For a single product, pass `productId`/`quantity`/`optionValueIds` directly. product_id comes from search_merchant_products/get_product_details; optionValueIds are addon/size value ids from the product's options. One merchant per cart.
輸入結構描述
{
"type": "object",
"properties": {
"items": {
"type": "array",
"items": {
"type": "object",
"properties": {
"productId": {
"type": "integer",
"description": "Product id to add."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Quantity (default 1)."
},
"optionValueIds": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Selected option value ids (size/extras)."
}
},
"required": [
"productId"
],
"additionalProperties": false
},
"description": "Add multiple items in one call."
},
"productId": {
"type": "integer",
"description": "Single product id to add (when not using `items`)."
},
"quantity": {
"type": "integer",
"minimum": 1,
"description": "Quantity for the single product (default 1)."
},
"optionValueIds": {
"type": "array",
"items": {
"type": "integer"
},
"description": "Option value ids for the single product."
},
"language": {
"type": "string",
"enum": [
"en",
"ar",
"kr",
"bd"
],
"description": "Language for item names (en, ar, kr, bd)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant_id": {
"type": "number"
},
"merchant_name": {
"type": "string"
},
"merchant_city": {
"type": "string"
},
"currency": {
"type": "string"
},
"items": {
"type": "array",
"items": {},
"description": "Cart line items (line_id, product_id, name, quantity, prices, options)."
},
"item_count": {
"type": "number"
},
"subtotal": {
"type": "number"
},
"message": {
"type": "string",
"description": "Present on an empty cart."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟡update_cart_item(lineId, quantity)
Set the quantity of a cart line by line_id (from view_cart). Quantity 0 removes it.
輸入結構描述
{
"type": "object",
"properties": {
"lineId": {
"type": "string",
"description": "line_id from view_cart."
},
"quantity": {
"type": "integer",
"minimum": 0,
"description": "New quantity (0 removes)."
}
},
"required": [
"lineId",
"quantity"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant_id": {
"type": "number"
},
"merchant_name": {
"type": "string"
},
"merchant_city": {
"type": "string"
},
"currency": {
"type": "string"
},
"items": {
"type": "array",
"items": {},
"description": "Cart line items (line_id, product_id, name, quantity, prices, options)."
},
"item_count": {
"type": "number"
},
"subtotal": {
"type": "number"
},
"message": {
"type": "string",
"description": "Present on an empty cart."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴remove_cart_item(lineId)
Remove a cart line by line_id (from view_cart).
輸入結構描述
{
"type": "object",
"properties": {
"lineId": {
"type": "string",
"description": "line_id from view_cart."
}
},
"required": [
"lineId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant_id": {
"type": "number"
},
"merchant_name": {
"type": "string"
},
"merchant_city": {
"type": "string"
},
"currency": {
"type": "string"
},
"items": {
"type": "array",
"items": {},
"description": "Cart line items (line_id, product_id, name, quantity, prices, options)."
},
"item_count": {
"type": "number"
},
"subtotal": {
"type": "number"
},
"message": {
"type": "string",
"description": "Present on an empty cart."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴clear_cart
Remove all items from the cart.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"merchant_id": {
"type": "number"
},
"merchant_name": {
"type": "string"
},
"merchant_city": {
"type": "string"
},
"currency": {
"type": "string"
},
"items": {
"type": "array",
"items": {},
"description": "Cart line items (line_id, product_id, name, quantity, prices, options)."
},
"item_count": {
"type": "number"
},
"subtotal": {
"type": "number"
},
"message": {
"type": "string",
"description": "Present on an empty cart."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_payment_methods
List the available DIGITAL payment methods for checkout (e.g. Lezzoo Pay wallet, FIB, Card, Asia Pay, FastPay, Qi Card, NassWallet). Cash on delivery is NOT supported. Requires sign-in. Use this to map a payment method the user names to its payment_type_id.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"methods": {
"type": "array",
"items": {},
"description": "Digital payment methods (payment_type_id, name)."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_wallet_balance
Get the current Lezzoo Pay (wallet) balance for the signed-in customer. Requires sign-in.
輸入結構描述
{
"type": "object",
"properties": {},
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"balance": {
"type": "number",
"description": "Wallet balance in IQD."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢review_order(paymentTypeId, addressId, voucherCode)
Prices the current cart for checkout (delivery, discount, fees, total) and renders an interactive widget in which the user selects their delivery address and payment method as tappable options — those details are chosen in the widget rather than in chat. Use when the user is ready to check out. Requires sign-in and a non-empty cart. Places no order.
輸入結構描述
{
"type": "object",
"properties": {
"paymentTypeId": {
"type": "integer",
"description": "Optional — the user picks this in the widget; defaults to Lezzoo Pay wallet for the initial price."
},
"addressId": {
"type": "integer",
"description": "Optional — the user picks this in the widget; defaults to the first saved address in the merchant's city."
},
"voucherCode": {
"type": "string",
"description": "Voucher/promo code to apply."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"subtotal": {
"type": "number"
},
"delivery": {
"type": "number"
},
"discount": {
"type": "number"
},
"fees": {
"type": "number"
},
"total": {
"type": "number"
},
"currency": {
"type": "string"
},
"payment_type_id": {
"type": "number"
},
"address_id": {
"type": "number"
},
"merchant_city": {
"type": "string"
},
"addresses": {
"type": "array",
"items": {},
"description": "Addresses eligible for this merchant's city."
},
"voucher_error": {
"type": "string"
},
"wallet": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "Wallet balance and can_pay flag."
},
"not_serviceable": {
"type": "boolean"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🔴place_order(confirm, paymentTypeId, addressId, voucherCode, confirmActiveOrder)
Place the order from the current cart. Call review_order first so the customer can confirm the total. Set confirm:true to actually place the order — without it, this returns a preview only. Requires sign-in and a non-empty cart.
輸入結構描述
{
"type": "object",
"properties": {
"confirm": {
"type": "boolean",
"description": "Must be true to place the order. If false, returns a preview (same as review_order)."
},
"paymentTypeId": {
"type": "integer",
"description": "Payment method ID (from get_payment_methods)."
},
"addressId": {
"type": "integer",
"description": "Address ID to deliver to. Defaults to your first saved address."
},
"voucherCode": {
"type": "string",
"description": "Voucher/promo code to apply."
},
"confirmActiveOrder": {
"type": "boolean",
"description": "Set true to place even though you have an active order — only after the user acknowledges."
}
},
"required": [
"confirm",
"paymentTypeId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"subtotal": {
"type": "number"
},
"delivery": {
"type": "number"
},
"discount": {
"type": "number"
},
"fees": {
"type": "number"
},
"total": {
"type": "number"
},
"currency": {
"type": "string"
},
"payment_type_id": {
"type": "number"
},
"address_id": {
"type": "number"
},
"merchant_city": {
"type": "string"
},
"addresses": {
"type": "array",
"items": {},
"description": "Addresses eligible for this merchant's city."
},
"voucher_error": {
"type": "string"
},
"wallet": {
"type": "object",
"properties": {},
"additionalProperties": true,
"description": "Wallet balance and can_pay flag."
},
"not_serviceable": {
"type": "boolean"
},
"order_id": {
"type": "number"
},
"payment_url": {
"type": "string",
"description": "Payment gateway URL for online methods."
},
"note": {
"type": "string"
},
"paid_from_wallet": {
"type": "boolean"
},
"confirm_required": {
"type": "string"
},
"_note": {
"type": "string"
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}🟢get_payment_link(orderId)
Generate a payment link for a placed order. Use this if the payment link expired or was not returned at order placement. Requires sign-in.
輸入結構描述
{
"type": "object",
"properties": {
"orderId": {
"type": "integer",
"description": "The order ID returned by place_order."
}
},
"required": [
"orderId"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}輸出結構描述
{
"type": "object",
"properties": {
"payment_url": {
"type": "string",
"description": "Payment gateway URL for the order."
}
},
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}社群
證據