# Dobby — staging-only train booking bot

> "DotCom's Booking Bot → DBB → Dobby." A staging-only train booking bot.
> One booking pipeline, exposed through every interface a developer might
> want — CLI, Web UI, Electron desktop app, MCP (stdio + HTTP), HTTP API,
> Slack bot, Chrome extension. All bookings hit the Eurostar **staging**
> environment with a test payment card. They are not real.

## For agents

The fastest way to use Dobby from an agent is the **Streamable HTTP MCP**
endpoint at `/mcp`. From there the agent has three tools:

- `eurostar_create_booking` — full booking pipeline against staging
- `eurostar_list_stations` — UIC code lookup by name / city / country
- `eurostar_list_markets` — supported market codes (currency + language)

## Endpoints

- [/mcp](/mcp) — Streamable HTTP MCP transport (POST initialize → JSON-RPC)
- [/api/booking](/api/booking) — POST a `BookingRequest`, get a `BookingResponse`
- [/api/search-link](/api/search-link) — POST a `BookingRequest`, get a deep-link URL
- [/api/checkout-vars](/api/checkout-vars) — GET checkout-credential status
- [/api/checkout-vars/refresh](/api/checkout-vars/refresh) — POST to trigger an SSE refresh stream
- [/healthz](/healthz) — JSON health check

## OpenAPI

- [/openapi.json](/openapi.json) — OpenAPI 3.1 spec for `/api/*`

Use this to import Dobby into ChatGPT (Custom GPT → Actions) or any agent
framework that prefers OpenAPI to MCP.

## Documentation

- [Web UI](/ui) — point-and-click booking
- [Documentation](/docs/) — rendered from `docs/*.md`
  - [HTTP API reference](/docs/api.html)
  - [MCP server setup](/docs/mcp.html) — Claude Desktop & Claude Code
  - [Slack bot](/docs/slack.html)
  - [Chrome extension](/docs/extension.html)
  - [Postman collection](/docs/postman.html)

## Downloads

- [Postman collection](/dobby-postman-collection.json)
- [Chrome extension](/dobby-browser-extension.zip)

## Source code

- GitHub: https://github.com/diegoeil/eurostar-booking-bot
- README: https://github.com/diegoeil/eurostar-booking-bot/blob/main/README.md
- AGENTS.md: https://github.com/diegoeil/eurostar-booking-bot/blob/main/AGENTS.md

## Important

All bookings hit the **Eurostar staging** environment with a test payment
card. They are not real. There is no cost. Feel free to create bookings
liberally for testing.