db-fahrplan-mcp

Live Deutsche Bahn timetables for Claude, Cursor, and any MCP client: connections, every fare option, cheapest time of day, departure boards, delays, platform changes, all stops of a train, coach sequence, stations near you.

It talks directly to the JSON endpoints behind bahn.de — the same ones the website uses. No API key. No proxy. No third-party mirror to go down. You get what bahn.de shows, including real-time data.

uvx db-fahrplan-mcp

What it can answer

Every journey carries a recon_token (→ fares), every leg and board row a journey_id (→ stops). Times are Europe/Berlin wherever the server runs; (+7) means 7 minutes late; (+1d) means after midnight. Occupancy (load), amenities (WiFi, bike, step-free, quiet zone…), real-time platforms and disruption notes are included.

Install

Claude Code

claude mcp add db-fahrplan -s user -- uvx db-fahrplan-mcp

Claude Desktop / Cursor / any MCP client — claude_desktop_config.json:

{
  "mcpServers": {
    "db-fahrplan": {
      "command": "uvx",
      "args": ["db-fahrplan-mcp"]
    }
  }
}

No uv? pipx install db-fahrplan-mcp or pip install db-fahrplan-mcp, then use "command": "db-fahrplan-mcp".

Remote / HTTP

db-fahrplan-mcp --transport streamable-http --host 127.0.0.1 --port 8000

Binds to localhost by default. Put it behind a reverse proxy with auth before exposing it.

Example

Krefeld Hbf → Köln Messe/Deutz, arrive by 08:00 Sunday

db_journeys("Krefeld Hbf", "Köln Messe/Deutz", "2026-08-30 08:00", arrive_by=true, format="text")

Krefeld Hbf → Köln Messe/Deutz, arrive by 2026-08-30 08:00 (Europe/Berlin)

06:35 → 07:23 · 48 min · 0× change · 25.80 €
   RE7       Krefeld Hbf 06:35 Gl.5 → Köln Messe/Deutz 07:23 Gl.1

…and on a bad day (real output, signal-box failure at Montabaur):

15:53 → 17:09 · 76 min · 0× change
   ICE 125   Köln Hbf 15:53 Gl.2 A-C → Frankfurt(Main)Hbf 17:09 Gl.1 CANCELLED
      ! Ein defektes Stellwerk im Raum Montabaur beeinträchtigt den Bahnverkehr …
   ! Verbindung fällt aus

format="text" is compact and cheap in tokens; format="json" (default) is structured.

Configuration

How it compares

¹ e.g. PaulvonBerg/db-mcp-server, jorekai/db-timetable-mcp. ² e.g. AnythingMCP's DB connector.

Development

git clone https://github.com/capraCoder/db-fahrplan-mcp && cd db-fahrplan-mcp
python -m pip install -e ".[dev]"
pytest              # offline, replays recorded bahn.de responses (tests/fixtures)
pytest -m live      # hits bahn.de — Krefeld→Garmisch multi-modal trip, fares, best price, boards
ruff check . && mypy

CI runs on Linux + Windows, Python 3.10–3.13, on both MCP SDK 1.x and 2.x. A weekly canary runs the live tests and opens an issue if bahn.de changes something.

Caveats, honestly

• Unofficial. Not affiliated with, endorsed by, or supported by Deutsche Bahn AG. "Deutsche Bahn" and "DB" are trademarks of Deutsche Bahn AG.
• Undocumented endpoints. bahn.de can change or block them at any time. The canary will notice within a week; please open an issue with the raw response if you hit it first.
• bahn.de's terms of use restrict automated access. This is a personal, non-commercial tool with an honest User-Agent and a rate limiter (30 req/min by default). Use it for yourself; do not build a scraping farm on it. Cloud/VPN IPs are sometimes blocked (HTTP 403).
• Prices are informational, as bahn.de quotes them for the given travellers at that moment. Booking happens on bahn.de.
• Timetable changes (mid-December, mid-June) can make far-future queries temporarily odd.

Citing

If this server is part of published work, cite it (metadata in CITATION.cff; GitHub's "Cite this repository" button renders it):

capraCoder (2026). db-fahrplan-mcp: Deutsche Bahn timetables as an MCP server (Version 0.2.1) [Software]. https://github.com/capraCoder/db-fahrplan-mcp

@software{capracoder_db_fahrplan_mcp_2026,
  author  = {{capraCoder}},
  title   = {db-fahrplan-mcp: Deutsche Bahn timetables as an MCP server},
  version = {0.2.1},
  year    = {2026},
  url     = {https://github.com/capraCoder/db-fahrplan-mcp}
}

Release artifacts carry OpenTimestamps proofs (*.ots, Bitcoin-anchored): existence and integrity are provable without any third-party archive.

Licence

MIT.