hu-transit-mcp

MCP server for Budapest and Hungarian public transport: BKK metro, tram, bus, trolleybus and HÉV, MÁV trains nationwide (including IC, EC and railjet to Wien and München) and Volánbusz. It uses the official BKK FUTÁR API and is read-only.

Magyarul lent ↓

Ask Claude (or any MCP client) things like:

• "When does the next M2 leave Deák Ferenc tér?"

• "How do I get from Széll Kálmán tér to Nyugati tomorrow at 8:00?"

• "Is anything wrong on the M3 today?"

• "Trains from Keleti to Wien in the next 2 hours?"

• "All trains from Miskolc to Budapest tomorrow, and back?"

Tools

Related MCP server: irail-mcp

Setup

1. Get a free API key at opendata.bkk.hu.

2. Add the server to your MCP client (requires uv).

Claude Code

git clone https://github.com/kukshaus/hu-transit-mcp.git
claude mcp add hu-transit -s user -e BKK_API_KEY=your-key \
  -- uv --directory /path/to/hu-transit-mcp run hu-transit-mcp

Claude Desktop (claude_desktop_config.json)

{
  "mcpServers": {
    "hu-transit": {
      "command": "uv",
      "args": ["--directory", "/path/to/hu-transit-mcp", "run", "hu-transit-mcp"],
      "env": { "BKK_API_KEY": "your-key" }
    }
  }
}

On macOS you can keep the key out of config files and store it in the Keychain. The server reads it when BKK_API_KEY is not set:

security add-generic-password -s bkk-api-key -a "$USER" -w 'your-key'

Example

departures("Budapest-Keleti", minutes=120)

09:20  S60  → Sülysáp
09:25  IC   → Budapest-Nyugati
09:30  rjx  → München Hbf
09:35  S80  → Gödöllő

Limits

• Live predictions exist for buses, trams and trolleybuses. Metro and MÁV trains mostly show the timetable (realtime: false).

• train_connections lists direct trains only. For journeys with a change, use plan_trip.

• No ticket prices or sales. The API has none.

Development

uv sync
uv run pytest

Magyarul

MCP-szerver a budapesti és magyarországi közösségi közlekedéshez: BKK metró, villamos, busz, troli és HÉV, MÁV-vonatok országosan (IC, EC és railjet Bécsbe és Münchenbe is), valamint Volánbusz. A hivatalos BKK FUTÁR API-t használja, csak olvas.

Kérdezd Claude-ot (vagy bármely MCP-klienst) például így:

• „Mikor indul a következő M2 a Deák Ferenc térről?”

• „Hogyan jutok el holnap 8-kor a Széll Kálmán térről a Nyugatihoz?”

• „Van ma fennakadás az M3-on?”

• „Milyen vonatok mennek a Keletiből Bécsbe a következő 2 órában?”

• „Milyen vonatok mennek holnap Miskolcról Budapestre és vissza?”

Eszközök

Telepítés

1. Igényelj ingyenes API-kulcsot az opendata.bkk.hu oldalon.

2. Add hozzá a szervert az MCP-kliensedhez (a fenti parancsok szerint, uv szükséges).

A kulcs a BKK_API_KEY környezeti változóból jön. macOS-en a Kulcskarikában is tárolhatod (security add-generic-password -s bkk-api-key -a "$USER" -w 'kulcs'), ekkor egyik konfigurációs fájlba sem kell beírni.

Korlátok

• Valós idejű előrejelzés a buszokra, villamosokra és trolikra van. A metró és a MÁV-vonatok többnyire menetrend szerinti időt mutatnak (realtime: false).

• A train_connections csak közvetlen vonatokat listáz. Átszállásos utazáshoz a plan_trip való.

• Jegyár és jegyvásárlás nincs, az API ezt nem kínálja.

License

MIT. Not affiliated with BKK Zrt. or MÁV. Data © BKK Zrt. via BKK FUTÁR / opendata.bkk.hu.