db-fahrplan-mcp

Status, 2026-10-13: currently blocked by bahn.de. bahn.de answers this tool's requests (station search, departure boards, journeys) with HTTP 403 OPS_BLOCKED, from a residential connection too. The tool reports the block with bahn.de's reference and does not work around it: this project stays an honest client (see Legal, honestly). Until bahn.de lets it through again, use bahn.de or the DB Navigator app.

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.

Legal, honestly

Full text: DISCLAIMER.md. The short version:

• Unofficial. Not affiliated with, endorsed by, or supported by Deutsche Bahn AG. "Deutsche Bahn" and "DB" are trademarks of Deutsche Bahn AG. The software ships no DB data and performs no systematic extraction — each query fetches only what the user asked for.
• 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. bahn.de can refuse requests (HTTP 403) from cloud/VPN addresses or from this tool itself, on any network. The tool reports the block with bahn.de's reference and stops; it does not work around blocks.
• 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.
• No liability for missed connections or wrong fares — see DISCLAIMER.md.

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 1.0.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 = {1.0.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.