mcpField
B
Belgian Train Schedule

Belgian Train Schedule

Local
github.com/hansfProductivity0Updated 38w ago
Repository

About Belgian Train Schedule

Belgian Train Schedule is an MCP server for Belgian rail information, intended for travelers and assistants planning journeys. It uses the iRail API to provide station searches, live boards, routes, train details and disruption data; results may be inaccurate or outdated, so verify with official sources.

Key features

  1. 01Search Belgian railway stations
  2. 02View live departures and arrivals
  3. 03Plan routes with transfers
  4. 04Check train stops, delays and platforms
  5. 05View disruptions and planned works

Use cases

  1. 01Check upcoming departures from a station
  2. 02Plan a trip between Belgian stations
  3. 03Look up a train’s stops and platform
  4. 04Check for network disruptions

MCP support

Exposes Belgian rail search, schedule, routing, train-detail and disruption tools to MCP clients. It gets this information through the iRail API.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "irail": {
      "command": "uvx",
      "args": [
        "irail-mcp"
      ]
    }
  }
}
Run commanduvx irail-mcp

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiirail-mcp

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

iRail MCP Server

Disclaimer: This project was vibe coded and is not affiliated with or supported by iRail vzw. Train data may be inaccurate or outdated. Always verify with official sources (belgiantrain.be or the NMBS/SNCB app) before making travel decisions.

A Model Context Protocol (MCP) server that provides Belgian railway travel information via the iRail API.

Features

  • Search Stations - Find Belgian railway stations by name
  • Live Departures/Arrivals - Real-time departure and arrival boards
  • Find Connections - Route planning between stations with transfers
  • Train Information - Detailed stops, delays, and platforms for a specific train
  • Network Disturbances - Current disruptions and planned maintenance

Installation

Requires Python 3.11+ and uv.

git clone https://github.com/HansF/irail-mcp.git
cd irail-mcp
uv venv && source .venv/bin/activate
uv pip install -e .

Usage with Claude Code

Add to your project's .mcp.json:

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

Then ask Claude things like:

  • "What trains leave Brussels Central in the next hour?"
  • "Find a route from Antwerp to Bruges at 2:30 PM tomorrow"
  • "Are there any disruptions on the Belgian rail network?"
  • "Show me details for train IC2240"

Tools

search_stations

Search for stations by name.

  • query (required) - Station name or partial name
  • lang (optional) - Language: en, nl, fr, de, it
get_liveboard

Real-time departures or arrivals from a station.

  • station (required) - Station name
  • date (optional) - YYYY-MM-DD, "today", "tomorrow", "+2 days"
  • time (optional) - HH:MM (24h)
  • arrival (optional) - Show arrivals instead of departures
  • lang (optional)
find_connections

Find routes between two stations.

  • from_station (required) - Departure station
  • to_station (required) - Destination station
  • date, time, lang (optional)
  • arrival_time (optional) - If true, time is desired arrival time
get_train_info

Detailed information about a specific train.

  • train_id (required) - e.g. "IC1234" or "BE.NMBS.IC1234"
  • date, lang (optional)
get_disturbances

Current network disruptions and planned works.

  • lang (optional)

Running Tests

uv pip install -e ".[dev]"
python -m pytest tests/ -v

API Compliance

  • Rate limited to 3 requests/second per iRail guidelines
  • Proper User-Agent header set
  • 30-second timeout for slow responses

License

MIT

References

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.