Oebb Mcp Server

oebb-mcp-server

[](https://pypi.org/project/oebb-mcp-server/) [](https://pypi.org/project/oebb-mcp-server/) [](LICENSE)

MCP server for OeBB (Austrian Federal Railways) train data. Query Austrian train stations, departures, connections, and service alerts directly from LLMs via the Model Context Protocol.

Installation

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "oebb": {
      "command": "uvx",
      "args": ["oebb-mcp-server"]
    }
  }
}

Claude Code

claude mcp add oebb -- uvx oebb-mcp-server

From source (development)

{
  "mcpServers": {
    "oebb": {
      "command": "uvx",
      "args": ["--from", "/path/to/oebb-mcp-server", "oebb-mcp-server"]
    }
  }
}

Tools

search_station

Search OeBB stations by name. Returns matching stations with IDs, coordinates, and types.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | query | string | required | Station name (e.g. "Wien Hbf") | | max_results | int | 10 | Maximum results |

station_board

Fetch live departures or arrivals at a station. Provide either station_id or station_name.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | station_id | string | — | OeBB station ID (e.g. "1190100") | | station_name | string | — | Station name (auto-resolved) | | board_type | string | "DEP" | "DEP" for departures, "ARR" for arrivals | | max_journeys | int | 10 | Maximum journeys |

trip_search

Search train connections between two stations. Supports time planning and direct-only filtering.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | from_station_id | string | — | Departure station ID | | from_station_name | string | — | Departure station name | | to_station_id | string | — | Arrival station ID | | to_station_name | string | — | Arrival station name | | max_connections | int | 5 | Maximum connections | | time | string | now | ISO 8601 time (e.g. "2026-04-15T08:00:00") | | time_mode | string | "departure" | "departure" or "arrival" | | direct_only | bool | false | Only direct connections |

service_alerts

Fetch current OeBB service alerts and disruptions.

| Parameter | Type | Default | Description | |-----------|------|---------|-------------| | max_alerts | int | 20 | Maximum alerts | | product_filter | int | 65535 | Product bitmask (1=ICE/RJX, 2=IC/EC, 4=NJ, 8=D/EN, 16=REX/R, 32=S-Bahn, 64=Bus, 128=Ferry, 256=U-Bahn, 512=Tram, 4096=private operators like Westbahn/RegioJet, 65535=all) |

Development

# Install dependencies
uv sync

# Lint & format
ruff check .
ruff format .

# Run unit tests
pytest tests/ -v -m "not integration"

# Run integration tests (hits real OeBB API)
pytest tests/ -v -m integration

License

MIT

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: slettmayer
• Source: slettmayer/oebb-mcp-server
• License: MIT
• Homepage: https://pypi.org/project/oebb-mcp-server/

Install and usage instructions live in the source repository linked above.