MCP SERVERPlan a Dutch rail journey and everything that can spoil it: routes with transfers, live departures and arrivals, disruptions, fares, and whether a station has an OV-fiets free.
LABSCO SUMMARY
Planning and disruption tools sitting together is the combination that matters on the day: get_travel_advice returns routes with real-time status and crowding, and get_disruptions says whether the line is being worked on at all. get_current_time_in_rfc3339 exists because the other tools want RFC3339 timestamps in the Europe/Amsterdam timezone, which removes the one thing an agent reliably gets wrong when planning a journey for later today.
An eight-tool client for Dutch railway travel information, covering journey planning, live station boards, disruptions, station facts and domestic pricing.
NS_API_KEY for the Dutch railway API, and station names or codes for the journey tools — a uicCode where a station has one. Pricing covers domestic journeys. MIT licensed.
One command plus a key — npx -y ns-mcp-server, then supply credentials
USE CASES
Take the current Amsterdam time in the format the planner expects, ask for routes to arrive by a given moment rather than depart now, then check the live board at the origin station before leaving for it.
Ask for active disruptions to see whether it is maintenance work or something unplanned, what alternative transport is running, and how much time it adds, then read the arrivals board to see what is still getting through.
Plan the journey first so the route is fixed, then price it for the party actually travelling — adults, children, travel class, and whether it is a joint journey, each of which changes the fare.
Check whether the destination station has an OV-fiets free before planning to ride one, and look the station up by name when you only know roughly where it is.
Counted once with only startup setup. Other versions, modes or optional credentials may expose a different list.
get_arrivalsGet real-time arrival information for trains at a specific station, including platform numbers, delays, origin stations, and any relevant travel notes. Returns a list of upcoming arrivals with timing, origin, and status information.
get_current_time_in_rfc3339Get the current server time (Europe/Amsterdam timezone) in RFC3339 format. This can be used as input for other tools that require date-time parameters.
get_departuresGet real-time departure information for trains from a specific station, including platform numbers, delays, route details, and any relevant travel notes. Returns a list of upcoming departures with timing, destination, and status information.
get_disruptionsGet comprehensive information about current and planned disruptions on the Dutch railway network. Returns details about maintenance work, unexpected disruptions, alternative transport options, impact on travel times, and relevant advice. Can filter for active disruptions and specific disruption types.
get_ovfietsGet OV-fiets availability at a train station
get_pricesGet price information for domestic train journeys, including different travel classes, ticket types, and discounts. Returns detailed pricing information with conditions and validity.
get_station_infoGet detailed information about a train station
get_travel_adviceGet detailed travel routes between two train stations, including transfers, real-time updates, platform information, and journey duration. Can plan trips for immediate departure or for a specific future time, with options to optimize for arrival time. Returns multiple route options with status and crowding information.
BEFORE YOU INSTALL
8 tools when we connected. All eight read the NS API: get_prices quotes a fare, but nothing books or buys. get_current_time_in_rfc3339 lets the model establish the current time before asking for departures.
Both documented setups run the server on your machine.
CONTEXT COST
Rated by the size of the 8 tool definitions that ride along on every turn, not by how many there are
INSTALLATION
npx -y ns-mcp-server{
"mcpServers": {
"ns-server": {
"command": "npx",
"args": [
"-y",
"ns-mcp-server"
],
"env": {
"NS_API_KEY": "<YOUR_NS_API_KEY>"
}
}
}
}{
"mcpServers": {
"ns-server": {
"command": "node",
"args": [
"<YOUR_PATH_TO_NS_SERVER>/build/index.js"
],
"env": {
"NS_API_KEY": "<YOUR_NS_API_KEY>"
}
}
}
}MCP servers
Fabsbags
KyrieTangSheng
danilat
davidyen1124