Belgian Train Schedule

by hansf

281 downloads

Not rated

GitHub

Productivity

About

> **Disclaimer:** This project was vibe coded and is **not affiliated with or supported by [iRail vzw](https://hello.irail.be)**. Train data may be inaccurate or outdated. Always verify with official sources ([belgiantrain.be](https://www.belgiantrain.be) or the NMBS/SNCB app) be

Details

Author: hansf
Downloads: 281
Categories: Productivity

Setting up with Highlight

This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:

Download and install Highlight from highlightai.com/download
Navigate to the plugins tab and select "Add Custom Plugin"
Configure the plugin with the settings below

Plugin Name Belgian Train Schedule

Command (node, npx, python, etc.)

Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
Enable "Start Automatically" if you want the plugin to start when Highlight launches

Setting up with Cursor

Open Cursor's settings
Navigate to the MCP section
Click "Add new Global MCP server"
Copy and paste the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Claude Desktop

Open Claude Desktop's settings
Go to the Integrations tab
Click "Add MCP Server"
Use the configuration below based on your operating system

Note: Make sure Claude Desktop is running before attempting to connect.

JSON

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

JSON

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

JSON

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

Setting up with Windsurf

Open Windsurf's preferences
Go to the Integrations section
Click "Add MCP Integration"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

Setting up with Cline

Open Cline's settings
Navigate to the Integrations section
Click "Add MCP Server"
Copy and paste the configuration below based on your operating system

Note: Make sure to restart Cline after adding the configuration.

JSON

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

JSON

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

JSON

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

Setting up with Goose

Open Goose's preferences
Go to the Integrations tab
Select "MCP Servers"
Click "Add New Server"
Use the configuration below based on your operating system

JSON

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

JSON

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

JSON

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

From the repository

Install with Python 3.11+ and uv, then configure in your MCP client (e.g., Claude Code’s .mcp.json) with command uvx and args ["irail-mcp"]. Use natural language queries to get station searches, live departure/arrival boards, route connections, train details, and network disturbances.

Claude Desktop / Cursor

Paste into your MCP client config file to install this server.

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

McpServers

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

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

- iRail API - Documentation
- Model Context Protocol
- NMBS/SNCB

No reviews yet — be the first

Use Google, GitHub, or an email account so ratings stay tied to real people.

Email sign in

No reviews posted yet.

About

Details

Jump to

Setting up with Highlight

From the repository

Claude Desktop / Cursor

McpServers

iRail MCP Server

Features

Installation

Usage with Claude Code

Tools

search_stations

get_liveboard

find_connections

get_train_info

get_disturbances

Running Tests

API Compliance

License

References

Install

More like this

Time

Github SSE

Npx Y convex@latest mcp start

Inbox Zero

Lamda

Windows-MCP