Справочник API

Что такое MCP

MCP (Model Context Protocol) — открытый протокол для подключения AI-ассистентов к внешним источникам данных и инструментам. Он стандартизирует способ, которым большие языковые модели взаимодействуют с внешними сервисами.

Этот сервер реализует MCP с транспортом Streamable HTTP для поиска туров на eto.travel. Клиент (AI-ассистент или приложение) отправляет JSON-RPC запросы, а сервер возвращает структурированные результаты поиска туров.

Эндпойнты

POST /mcp
Content-Type: application/json
Accept: application/json, text/event-stream

{
  "status": "ok",
  "mode": "live",
  "upstream": "reachable",
  "cache_size": 12,
  "circuit_breaker": "closed"
}

Tool: search_tours

Инструмент для поиска туров. Принимает человекочитаемые параметры и возвращает структурированные результаты.

Пример запроса

{
  "jsonrpc": "2.0",
  "id": 3,
  "method": "tools/call",
  "params": {
    "name": "search_tours",
    "arguments": {
      "to_country": "Turkey",
      "from_city": "Moscow",
      "date_from": "2026-03-01",
      "nights_min": 7,
      "nights_max": 10,
      "adults": 2,
      "limit": 5
    }
  }
}

Пример ответа

{
  "jsonrpc": "2.0",
  "id": 3,
  "result": {
    "content": [
      {
        "type": "text",
        "text": "{\"meta\":{\"source\":\"live\",\"live_available\":true,\"cached\":false,\"total\":5,\"query\":{\"to_country\":\"Turkey\",\"from_city\":\"Moscow\",\"date_from\":\"2026-03-01\",\"nights_min\":7,\"nights_max\":10,\"adults\":2,\"limit\":5}},\"tours\":[{\"hotel\":\"Rixos Premium Belek\",\"stars\":5,\"country\":\"Turkey\",\"resort\":\"Belek\",\"meal\":\"UAI\",\"nights\":7,\"date\":\"2026-03-05\",\"price_rub\":185000,\"operator\":\"Anex Tour\",\"link\":\"https://eto.travel/search/?hotel=#tvtourid=\"}]}"
      }
    ]
  }
}

Режимы работы

Сервер работает в live+fallback, с опциональным demo-режимом для отладки.

meta.source = "live-eto-web"
meta.live_available = true

meta.source = "demo"

meta.source = "fallback-demo"
meta.live_available = false
meta.upstream_error = "ECONNREFUSED"

Обработка ошибок

Типичные ошибки и способы их решения.