неофициальный · только чтение · mcp

Четыре места — ещё не купе

MCP-сервер к неофициальному API РЖД. Ищет поезда, вагоны и места прямо в диалоге с ассистентом — и отличает подтверждённое купе от четырёх мест, разбросанных по вагону.

endpoint https://rzd-api.vercel.app/mcp

вагон 07подтверждено

Четыре места за одной дверью: API перечислил их внутри купе 1.

вагон 09кандидат

Тоже четыре свободных места — но в двух разных купе. Семья поедет за разными дверями.

Проект не связан с ОАО «РЖД» и использует внутренние endpoint сайта ticket.rzd.ru, которые могут измениться без предупреждения. Все инструменты только читают данные: сервер не логинится, не принимает документы и не покупает билеты. Наличие мест и цены меняются в реальном времени — перед покупкой проверьте их на официальном сайте или в приложении РЖД.

Как подключить

ChatGPT

  1. Включите режим разработчика в настройках.
  2. Создайте приложение и подключите его по URL сервера.
  3. Укажите адрес https://rzd-api.vercel.app/mcp.
  4. Авторизация — «без авторизации»: сервер только читает данные.
  5. Запустите сканирование инструментов и подтвердите предупреждение о непроверенном сервере.

Названия пунктов зависят от тарифа и этапа rollout.

Codex и локальные клиенты

Удалённый сервер по Streamable HTTP:

codex mcp add rzd --url https://rzd-api.vercel.app/mcp

Или локальный STDIO из клона репозитория:

codex mcp add rzd -- bun run /path/to/rzd-api/src/mcp.ts

Свой экземпляр

git clone https://github.com/slavb18/rzd-api
bun install
bun run mcp:http

Endpoint РЖД переопределяется переменными RZD_BASE_URL и RZD_B2B_BASE_URL — например, на свой reverse proxy, если прямой доступ закрыт.

Как спрашивать

Обычным языком — параметры ассистент достроит сам:

@rzd Москва → Владивосток, полное купе, с 1 по 30 сентября 2026 с картинкой
«Полное купе» — это четыре места за одной дверью. Схема вагона придёт картинкой, свободные места на ней синие.
@rzd СВ на двоих Москва — Петербург в ближайшие выходные
В двухместном вагоне за дверью два места, а не четыре, поэтому искать нужно именно два — иначе не подтвердится ничего.
@rzd целое купе во Владивосток в сентябре
Голый месяц берётся целиком. Диапазон ограничен 31 днём: если попросить больше, ассистент проверит первые 31 и скажет об этом.

В ответе подтверждённые купе и отдельно кандидаты — вагоны, где мест хватает, но API не подтвердил их одним купе. Номера мест приходят как есть: 36Ж — место в женском купе, 6С — в смешанном. Ответ помечен временем проверки: наличие устаревает за минуты.

Инструменты

ИнструментЧто делает
search_ticketsПоезда на дату между двумя станциями
search_full_compartmentsПолностью свободные купе за диапазон дат
find_stationsСтанции и их коды по названию
get_carriagesВагоны, свободные места и цены у поезда
get_train_availabilityДаты, когда поезд ходит
get_minimal_pricesМинимальные цены по датам
get_car_schemeСхема конкретного вагона
get_car_imagesФотографии вагона
get_route_stationsОстановки поезда по маршруту