Servers Playground How we check Add a server Log in

Guest

Working · 1.6 s

ge.meni/guestv1.0.0 Domain verified

Guest API for meni.ge restaurants: browse menus, place orders, reserve tables. No auth needed.

Local Services

Website Registry entry

Maintain this server? Claim it

Try it

Call this server's tools from your browser. Nothing to install.

https://api.meni.ge/llm/mcp

Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.

Tool list from our last check. Connect live to refresh it.

cancel_reservation

Cancel a reservation previously created with create_reservation.

domainstring, required

reservationIdstring, required

This tool isn't marked read-only, so it may change something on the server or in an account you connected.

I understand, run it anyway

Guest MCP server | mcptry

Tools (16)

cancel_reservation

Cancel a reservation previously created with create_reservation.

Argument	Type	Description
domain*	string
reservationId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "reservationId"
  ],
  "properties": {
    "domain": {
      "type": "string"
    },
    "reservationId": {
      "type": "string"
    }
  }
}

check_table_availability

Which tables of the location are free or busy in a given time window (uses the floor plan published by the restaurant). Pass the chosen table id to create_reservation as tableId.

Argument	Type	Description
start*	string	ISO 8601 datetime
domain*	string
durationMinutes	integer

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "start"
  ],
  "properties": {
    "start": {
      "type": "string",
      "description": "ISO 8601 datetime"
    },
    "domain": {
      "type": "string"
    },
    "durationMinutes": {
      "type": "integer",
      "default": 120
    }
  }
}

create_order

Validate and place an order at a meni.ge location. Returns orderId (keep it — it is the access token for status checks) and the computed total. customer.name/phone are required for pickup and delivery; delivery.address is required for delivery. Pass either items (inline) or cartId (the cart built with update_cart) — not both. Always pass idempotencyKey when you might retry: the same key within 48h returns the original order instead of placing a second one.

Argument	Type	Description
items	array
notes	string
cartId	string	Order this cart; mutually exclusive with items
domain*	string
pickup	object
qrCode	string
customer	object
delivery	object
language	string
orderType	string

create_reservation

Request a table reservation. Starts as "pending" until the restaurant confirms — check with get_reservation_status. Returns reservationId (keep it: it is the token for status and cancellation). Optionally bind a specific table via tableId (from check_table_availability).

Argument	Type	Description
name*	string	Guest name
phone	string
start*	string	ISO 8601 datetime
codeId	string
domain*	string
comment	string
tableId	string
partySize	integer
idempotencyKey	string	Retry guard: repeating the same key returns the original reservation instead of booking twice.
durationMinutes	integer

get_cart

Read a cart created with update_cart: lines with live unit prices, subtotal, item count, the checkoutUrl for a human hand-off and the expiry date (carts live 7 days). Lines whose item left the menu are flagged unavailable and excluded from the subtotal.

Argument	Type	Description
cartId*	string
domain*	string
language	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "cartId"
  ],
  "properties": {
    "cartId": {
      "type": "string"
    },
    "domain": {
      "type": "string"
    },
    "language": {
      "type": "string"
    }
  }
}

get_hotel_availability

Hotels only. Есть ли свободные номера на ВСЕ ночи [checkIn, checkOut): по типам номеров — сколько свободно и помещается ли компания. Данные — из опубликованного календаря отеля. Дат нет — не вызывай, а спроси их. ok:false с reason unknown/stale/unavailable — данных нет: не утверждай ни «свободно», ни «занято», веди к форме бронирования или к человеку. ok:false с reason bad_request — ошибка в датах вызова, а не «данных нет»: dates-required — спроси у гостя даты заезда и выезда; checkin-in-the-past, checkout-not-after-checkin, checkin-too-far-ahead — уточни даты.

Argument	Type	Description
party	object	Кто едет: взрослые (≥1), дети и возраст каждого ребёнка (childAges). Передавай, только если гость назвал; не назвал — не передавай и НЕ спрашивай ради цены или наличия: посчитается цена номера (priceBasis room). Названная компания меняет цену так же, как в форме бронирования (доплата за дополнительного взрослого и за детей по возрасту).
domain*	string	Hotel location code (uppercase, from the site URL or QR).
checkIn*	string	Заезд. Дата YYYY-MM-DD по календарю отеля.
checkOut*	string	Выезд (позже заезда). Дата YYYY-MM-DD по календарю отеля.

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "checkIn",
    "checkOut"
  ],
  "properties": {
    "party": {
      "type": "object",
      "properties": {
        "adults": {
          "type": "integer",
          "minimum": 1
        },
        "children": {
          "type": "integer",
          "minimum": 0
        },
        "childAges": {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 17,
            "minimum": 0
          },
          "description": "Возраст каждого ребёнка, если гость назвал."
        }
      },
      "description": "Кто едет: взрослые (≥1), дети и возраст каждого ребёнка (childAges). Передавай, только если гость назвал; не назвал — не передавай и НЕ спрашивай ради цены или наличия: посчитается цена номера (priceBasis room). Названная компания меняет цену так же, как в форме бронирования (доплата за дополнительного взрослого и за детей по возрасту)."
    },
    "domain": {
      "type": "string",
      "description": "Hotel location code (uppercase, from the site URL or QR)."
    },
    "checkIn": {
      "type": "string",
      "description": "Заезд. Дата YYYY-MM-DD по календарю отеля."
    },
    "checkOut": {
      "type": "string",
      "description": "Выезд (позже заезда). Дата YYYY-MM-DD по календарю отеля."
    }
  }
}

get_item

Get one menu item with its variant groups and addons, or several at once: pass itemIds (up to 10) instead of itemId to look items up in bulk — the bulk answer is {items, notFound}.

Argument	Type	Description
domain*	string
itemId	string	One item; mutually exclusive with itemIds
itemIds	array	Bulk lookup, up to 10 ids; mutually exclusive with itemId
language	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string"
    },
    "itemId": {
      "type": "string",
      "description": "One item; mutually exclusive with itemIds"
    },
    "itemIds": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Bulk lookup, up to 10 ids; mutually exclusive with itemId"
    },
    "language": {
      "type": "string"
    }
  }
}

get_menu

Get the full menu of a meni.ge location: categories, items with prices, variant groups and addons, currency and ordering capabilities. domain = uppercase location code from the QR/menu URL.

Argument	Type	Description
domain*	string	Location domain code, e.g. MYCAFE
language	string	ISO 639-1 menu language, default en

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string",
      "description": "Location domain code, e.g. MYCAFE"
    },
    "language": {
      "type": "string",
      "description": "ISO 639-1 menu language, default en"
    }
  }
}

get_order_status

Check the status of an order previously created with create_order.

Argument	Type	Description
domain*	string
orderId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "orderId"
  ],
  "properties": {
    "domain": {
      "type": "string"
    },
    "orderId": {
      "type": "string"
    }
  }
}

get_reservation_status

Status of a reservation created with create_reservation (pending/confirmed/seated).

Argument	Type	Description
domain*	string
reservationId*	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "reservationId"
  ],
  "properties": {
    "domain": {
      "type": "string"
    },
    "reservationId": {
      "type": "string"
    }
  }
}

get_store_info

Facts about the location that are not on the menu: address, contacts, coordinates, working hours with openNow computed in the venue timezone, delivery and pickup terms (fees, minimum order, zones, ETA), accepted payment methods and currency, shipping/return terms and links to the published legal documents. Use this before answering "are you open?", "do you deliver?", "how much is delivery?".

Argument	Type	Description
domain*	string
language	string	ISO 639-1; falls back to the location default

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "domain": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "description": "ISO 639-1; falls back to the location default"
    }
  }
}

hotel_info

Hotels only. Факты об отеле из его базы знаний для гостей: заезд/выезд, завтрак, парковка, правила, услуги, как добраться. Вызывай для любого вопроса об отеле, кроме свободных номеров и цены проживания, — и для ПРОСЬБЫ об услуге («организуйте трансфер», «закажите такси», «нужна кроватка»): узнай, как она заказывается, и ответь фактами. Возвращает выдержки; ok:false — в базе ответа нет, тогда честно скажи, что не знаешь, и предложи человека.

Argument	Type	Description
lang	string	Язык гостя (en, ru, ka, tr…), необязательно.
query*	string	Вопрос гостя своими словами (на любом языке).
domain*	string	Hotel location code (uppercase, from the site URL or QR).

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "query"
  ],
  "properties": {
    "lang": {
      "type": "string",
      "description": "Язык гостя (en, ru, ka, tr…), необязательно."
    },
    "query": {
      "type": "string",
      "description": "Вопрос гостя своими словами (на любом языке)."
    },
    "domain": {
      "type": "string",
      "description": "Hotel location code (uppercase, from the site URL or QR)."
    }
  }
}

quote_stay

Hotels only. ПРЕДВАРИТЕЛЬНАЯ цена проживания на конкретные даты (не бронь и не резерв). roomTypeId — из get_hotel_availability, если гость выбрал тип номера; тип не назван — НЕ спрашивай его, а вызывай без roomTypeId: посчитается каждый тип (roomTypes[] — у каждого quote или reason отказа). Называй гостю ровно total и currency из ответа вместе с датами; окончательная цена — в форме бронирования. ok:false — цены нет, не угадывай; detail — причина (min-stay — минимальный срок проживания и т.п.), её и назови. Цена относится к тарифу ratePlan из ответа: называй его по ratePlan.name (на языке гостя) и с его условиями отмены, а не тарифом, о котором спросил гость. Тариф не назван — подбирается самый дешёвый продаваемый; notOffered — тарифы, которые на эти даты не продаются, и причина (min-stay и т.п.). Без party цена — за номер (priceBasis room); гость назвал компанию — передай party, цена будет на неё (priceBasis party): так и скажи гостю. detail child-ages-required — цена зависит от возраста детей: спроси возраст каждого ребёнка и посчитай снова. ok:false с reason bad_request — ошибка в датах вызова, а не «данных нет»: dates-required — спроси у гостя даты заезда и выезда; checkin-in-the-past, checkout-not-after-checkin, checkin-too-far-ahead — уточни даты.

Argument	Type	Description
party	object	Кто едет: взрослые (≥1), дети и возраст каждого ребёнка (childAges). Передавай, только если гость назвал; не назвал — не передавай и НЕ спрашивай ради цены или наличия: посчитается цена номера (priceBasis room). Названная компания меняет цену так же, как в форме бронирования (доплата за дополнительного взрослого и за детей по возрасту).
domain*	string	Hotel location code (uppercase, from the site URL or QR).
checkIn*	string	Заезд. Дата YYYY-MM-DD по календарю отеля.

search_policies_and_faqs

Search the location's own published policies, FAQ entries and info pages (privacy, terms, returns, delivery, cookies, help articles) plus, when the owner allows it, their internal knowledge base. Returns short snippets with a link to the source. Use it for policy/help questions instead of guessing; use get_store_info when you need structured numbers.

Argument	Type	Description
limit	integer	How many snippets to return (1–10, default 5)
query*	string	The guest question, in any language
domain*	string
language	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "How many snippets to return (1–10, default 5)"
    },
    "query": {
      "type": "string",
      "description": "The guest question, in any language"
    },
    "domain": {
      "type": "string"
    },
    "language": {
      "type": "string"
    }
  }
}

search_products

Semantic search over the location's catalog: product/dish names, descriptions, specifications, brand, SKU/barcodes and attached docs. Use for "do you have…" / "recommend…" / "how much is…" questions instead of paging through get_menu. Returns matching items with prices and a relevance score; falls back with a note when the search index is unavailable for the location.

Argument	Type	Description
limit	integer	How many items to return (1–10, default 6)
query*	string	What the guest is looking for, in any language
domain*	string
language	string	ISO 639-1 menu language, default en

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "query"
  ],
  "properties": {
    "limit": {
      "type": "integer",
      "description": "How many items to return (1–10, default 6)"
    },
    "query": {
      "type": "string",
      "description": "What the guest is looking for, in any language"
    },
    "domain": {
      "type": "string"
    },
    "language": {
      "type": "string",
      "description": "ISO 639-1 menu language, default en"
    }
  }
}

update_cart

Build the guest order step by step in a server-side cart, the way a human uses the web cart. Without cartId a new cart is created (keep the returned cartId — it is the access token). Each entry of updates: {itemId, quantity, variants?, addons?, comment?} adds a line; {lineId, quantity} changes one; {lineId, quantity: 0} removes it. Prices are recomputed from the live menu on every read, never stored. The answer includes a checkoutUrl the human can open to finish in the normal web checkout, and the cart can be placed as an order with create_order(cartId).

Argument	Type	Description
cartId	string	Omit to create a new cart
domain*	string
updates*	array
language	string

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "updates"
  ],
  "properties": {
    "cartId": {
      "type": "string",
      "description": "Omit to create a new cart"
    },
    "domain": {
      "type": "string"
    },
    "updates": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "addons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "itemId": {
            "type": "string",
            "description": "Required when adding a line"
          },
          "lineId": {
            "type": "string",
            "description": "Existing line to change; omit to add a new one"
          },
          "comment": {
            "type": "string",
            "description": "Guest note for this line (e.g. \"no onions\")"
          },
          "quantity": {
            "type": "integer",
            "maximum": 99,
            "minimum": 0,
            "description": "0 removes the line (needs lineId)"
          },
          "variants": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      }
    },
    "language": {
      "type": "string"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain"
  ],
  "properties": {
    "items": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "itemId"
        ],
        "properties": {
          "addons": {
            "type": "array",
            "items": {
              "type": "string"
            }
          },
          "itemId": {
            "type": "string"
          },
          "quantity": {
            "type": "integer",
            "default": 1,
            "minimum": 1
          },
          "variants": {
            "type": "object",
            "additionalProperties": {
              "type": "string"
            }
          }
        }
      }
    },
    "notes": {
      "type": "string"
    },
    "cartId": {
      "type": "string",
      "description": "Order this cart; mutually exclusive with items"
    },
    "domain": {
      "type": "string"
    },
    "pickup": {
      "type": "object",
      "properties": {
        "scheduledFor": {
          "type": "string"
        }
      }
    },
    "qrCode": {
      "type": "string"
    },
    "customer": {
      "type": "object",
      "properties": {
        "name": {
          "type": "string"
        },
        "email": {
          "type": "string"
        },
        "phone": {
          "type": "string"
        }
      }
    },
    "delivery": {
      "type": "object",
      "properties": {
        "notes": {
          "type": "string"
        },
        "address": {
          "type": "string"
        }
      }
    },
    "language": {
      "type": "string"
    },
    "orderType": {
      "enum": [
        "dine-in",
        "delivery",
        "pickup"
      ],
      "type": "string"
    },
    "paymentMethod": {
      "enum": [
        "cash",
        "card-on-delivery",
        "online"
      ],
      "type": "string"
    },
    "idempotencyKey": {
      "type": "string",
      "maxLength": 64,
      "minLength": 8,
      "description": "Retry guard, e.g. a UUID you keep for this order attempt"
    }
  }
}

Input schema (JSON)

{
  "type": "object",
  "required": [
    "domain",
    "checkIn",
    "checkOut"
  ],
  "properties": {
    "party": {
      "type": "object",
      "properties": {
        "adults": {
          "type": "integer",
          "minimum": 1
        },
        "children": {
          "type": "integer",
          "minimum": 0
        },
        "childAges": {
          "type": "array",
          "items": {
            "type": "integer",
            "maximum": 17,
            "minimum": 0
          },
          "description": "Возраст каждого ребёнка, если гость назвал."
        }
      },
      "description": "Кто едет: взрослые (≥1), дети и возраст каждого ребёнка (childAges). Передавай, только если гость назвал; не назвал — не передавай и НЕ спрашивай ради цены или наличия: посчитается цена номера (priceBasis room). Названная компания меняет цену так же, как в форме бронирования (доплата за дополнительного взрослого и за детей по возрасту)."
    },
    "domain": {
      "type": "string",
      "description": "Hotel location code (uppercase, from the site URL or QR)."
    },
    "checkIn": {
      "type": "string",
      "description": "Заезд. Дата YYYY-MM-DD по календарю отеля."
    },
    "checkOut": {
      "type": "string",
      "description": "Выезд (позже заезда). Дата YYYY-MM-DD по календарю отеля."
    },
    "ratePlanId": {
      "type": "string",
      "description": "id тарифа (ratePlan.ratePlanId или id из notOffered прежнего ответа), если гость выбрал конкретный тариф; иначе не передавай. Тариф с ограничением на эти даты вернёт ok:false с причиной."
    },
    "roomTypeId": {
      "type": "string",
      "description": "roomTypeId из ответа get_hotel_availability; гость тип не назвал — не передавай (посчитаются все типы)."
    }
  }
}