Лайв-еда — кафе с доставкой домашней еды в Люберцах. Этот эндпоинт открывает наш каталог и оформление заказа для любых AI-агентов по протоколу Model Context Protocol (Anthropic). Клиент может сказать своему AI «закажи мне лагман и шашлык на ужин» — агент сам найдёт блюда, проверит зону доставки и создаст заказ. Финальная оплата — на нашем сайте через ТБанк.
| Метод | Назначение |
|---|---|
POST /mcp | JSON-RPC 2.0 (стандарт MCP). Методы: initialize, tools/list, tools/call. |
GET /.well-known/mcp.json | Манифест для автодискавери AI-агентами. |
GET /mcp/tools | Список инструментов (REST, для агентов без JSON-RPC). |
POST /mcp/tools/{name} | Прямой вызов инструмента (REST-обёртка). |
list_categories readСписок категорий меню. Без параметров.
POST /mcp/tools/list_categories
{}
→ [{ "id": "1", "name": "Мангал", "products_count": 28 }, ...]
list_products readСписок блюд. Параметры (все опциональны): category_id, max_price, only_available (default: true), query (поиск), limit (max 200).
POST /mcp/tools/list_products
{ "category_id": "1", "max_price": 500, "limit": 10 }
→ [{ "id": 9, "name": "Шашлык из свиной шейки", "weight": "160 г",
"price": 350, "image_url": "https://лайв-еда.рф/stor/..." }, ...]
get_product readКарточка блюда: product_id (обязательно). Возвращает цены доставка/самовывоз/в зале, состав, шаги-комбо, фото.
list_reviews readОтзывы клиентов для контекстных рекомендаций. Параметр: limit (max 50).
check_delivery_zone readПараметры: distance_km (для точного ответа) или address (только информативно).
POST /mcp/tools/check_delivery_zone
{ "distance_km": 3.2 }
→ { "in_zone": true, "delivery_fee": 200, "free_delivery_from": 2000,
"note": "Доставка 200 ₽, бесплатно от 2000 ₽" }
get_order_status readСтатус по order_id. Если awaiting_payment — возвращает payment_url для повторной оплаты.
create_order_draft createСоздать черновик заказа. Обязательны: items (массив {product_id, quantity}), customer.name, customer.phone. Для доставки — address.
POST /mcp/tools/create_order_draft
{
"items": [
{ "product_id": "9", "quantity": 1 },
{ "product_id": "1757258527458", "quantity": 2 }
],
"customer": { "name": "Иван", "phone": "+79991234567" },
"delivery_type": "delivery",
"address": "Люберцы, Октябрьский пр-т 100",
"comment": "позвоните перед доставкой"
}
→ { "order_id": "1717505123000",
"status": "awaiting_payment",
"total": 910,
"subtotal": 910,
"delivery_fee": 0,
"payment_url": "https://securepay.tinkoff.ru/...",
"expires_in_seconds": 1800,
"note": "Перейдите по payment_url, оплатите.
После оплаты заказ автоматически уйдёт на кухню." }
// 1) initialize
POST /mcp
{ "jsonrpc": "2.0", "id": 1, "method": "initialize" }
// 2) tools/list
POST /mcp
{ "jsonrpc": "2.0", "id": 2, "method": "tools/list" }
// 3) tools/call
POST /mcp
{ "jsonrpc": "2.0", "id": 3, "method": "tools/call",
"params": { "name": "list_products",
"arguments": { "category_id": "1", "limit": 5 } } }
В файле claude_desktop_config.json добавьте:
{
"mcpServers": {
"liveeda": {
"url": "https://лайв-еда.рф/mcp",
"transport": "http"
}
}
}
Для агентов, которые не умеют MCP по HTTP — используйте обычный REST на /mcp/tools/{name}.
create_order_draft: 10 запросов в час с одного IP.source: "mcp" с User-Agent агента для аналитики.