Skip to main content
Glama
NS Travel Information MCP Server

NS Travel Information MCP Server

by r-huijts

NS Travel Information MCP Server

npm version

Transform your AI assistant into a Dutch railways expert! This MCP server connects Claude to real-time NS (Nederlandse Spoorwegen) travel information, making it your perfect companion for navigating the Netherlands by train.

Installation

You can install this server in three ways:

1. Using Claude Desktop with NPM Package

Update your Claude configuration file (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "ns-server": {
      "command": "npx",
      "args": [
        "-y",
        "ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

You can get an API key from NS API Portal

2. Using Smithery

To install NS Travel Information Server automatically via Smithery:

npx -y @smithery/cli install ns-server --client claude

3. From Source

  1. Clone this repository

  2. Install dependencies:

    npm install
  3. Copy the example environment file:

    cp .env.example .env
  4. Add your NS API key to the .env file:

    NS_API_KEY=your_api_key_here

Then update your Claude configuration file:

{
  "mcpServers": {
    "ns-server": {
      "command": "node",
      "args": [
        "/path/to/ns-server/build/index.js"
      ],
      "env": {
        "NS_API_KEY": "your_api_key_here"
      }
    }
  }
}

Make sure to:

  1. Replace /path/to/ns-server with the actual path to your installation

  2. Add your NS API key in the env section. It can be obtained from here https://apiportal.ns.nl/product#product=NsApp

After updating the configuration, restart Claude Desktop for the changes to take effect.

Related MCP server: mcp-ns-railways

Real-World Use Cases

  • "Is my usual 8:15 train from Almere to Amsterdam running on time?"

  • "Are there any delays on the Rotterdam-Den Haag route today?"

  • "What's the best alternative route to Utrecht if there's maintenance on the direct line?"

  • "Which train should I take to arrive at my office in Amsterdam Zuid before 9 AM?"

  • "Which route to Amsterdam has the fewest transfers with a stroller?"

  • "What's the earliest train I can take to make my 10 AM meeting in The Hague?"

  • "When's the last train back to Groningen after a night out in Amsterdam?"

  • "Are there any weekend engineering works that might affect my Monday morning class?"

  • "Are there OV-fiets bikes available at Utrecht Centraal for my afternoon meeting?"

  • "Is Eindhoven Strijp-S station wheelchair accessible and what platforms does it have?"

  • "What trains are arriving at Utrecht Centraal in the next hour?"

  • "Has the train from Venlo to Schiphol Airport arrived on time?"

  • "How much does a first-class ticket from Amsterdam to Rotterdam cost?"

  • "What's the price for 2 adults and 1 child traveling to Den Haag?"

🔑 Environment Variables

Variable

Description

NS_API_KEY

Your NS API key (required)

🌟 Features

This MCP server provides comprehensive access to NS train information through the following endpoints:

Real-time Train Information

  • Departures: Get real-time departure information including platform numbers, delays, and travel notes

  • Arrivals: Access upcoming train arrivals with origin stations, platform changes, and status updates

  • Journey Planning: Find optimal travel routes with transfers and real-time updates

  • Service Updates: Check for disruptions, maintenance work, and engineering activities

Pricing Information

  • Ticket Prices: Get accurate pricing for single and return journeys

  • Travel Classes: Compare prices for first and second class travel

  • Group Pricing: Calculate fares for adults and children

  • Discount Options: Check joint journey discounts and special offers

  • Validity Details: View ticket validity periods and travel conditions

Station Information

  • Station Details: Access comprehensive station information including:

    • Facilities and accessibility features

    • Platform layouts and track information

    • OV-fiets (bike rental) availability

    • Location and approach details

Additional Features

  • Multi-language Support: Information available in Dutch and English

  • Flexible Queries: Search by station name, code, or UIC identifier

  • Time Zones: Proper handling of time zones for international stations

  • Status Updates: Track changes, delays, and cancellations in real-time

License

This project is licensed under the MIT License - see the LICENSE file for details

Available Tools

8 tools
get_arrivalsA

Get 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.

Inputs: station, uicCode, dateTime, maxJourneys, +1 more.

get_current_time_in_rfc3339A

Get the current server time (Europe/Amsterdam timezone) in RFC3339 format. This can be used as input for other tools that require date-time parameters.

Inputs: no named parameters.

get_departuresA

Get 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.

Inputs: station, uicCode, dateTime, maxJourneys, +1 more.

get_disruptionsA

Get 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.

Inputs: isActive, type.

get_ovfietsC

Get OV-fiets availability at a train station

Inputs: stationCode (required).

get_pricesC

Get price information for domestic train journeys, including different travel classes, ticket types, and discounts. Returns detailed pricing information with conditions and validity.

Inputs: fromStation (required), toStation (required), travelClass, travelType, +6 more.

get_station_infoC

Get detailed information about a train station

Inputs: query (required), includeNonPlannableStations, limit.

get_travel_adviceA

Get 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.

Inputs: fromStation (required), toStation (required), dateTime, searchForArrival.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.8/5.0

    Scored across 8 tools

    Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific aspects of train travel information, such as arrivals, departures, disruptions, pricing, station details, and route planning. There is no overlap in functionality, and the descriptions clearly differentiate the scope of each tool, making it easy for an agent to select the correct one without confusion.

    Naming Consistency5/5

    All tool names follow a consistent 'get_' prefix pattern with descriptive nouns, such as get_arrivals, get_departures, get_disruptions, etc. This uniform naming convention enhances readability and predictability, allowing agents to easily understand and anticipate the purpose of each tool based on its name.

    Tool Count5/5

    With 8 tools, the server is well-scoped for providing comprehensive Dutch railway travel information. Each tool serves a specific and necessary function, covering real-time data, disruptions, pricing, station details, and route planning, without being overly broad or lacking in essential features for the domain.

    Completeness5/5

    The tool set offers complete coverage for train travel information, including real-time arrivals and departures, disruptions, pricing, station details, bike availability, and route planning. There are no obvious gaps, as it supports core workflows from trip planning to real-time updates and ancillary services like OV-fiets, ensuring agents can handle a wide range of travel-related queries effectively.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      D
      maintenance
      An MCP server that enables AI assistants to interact with the Netherlands Railways (NS) API for route planning, pricing, and real-time departure information. It provides tools for searching stations, planning trips with connections, and viewing real-time departure boards.
      3
      1
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      MCP server for querying Dutch railway data via the NS API, with planned tools for station search, departures, trip planning, and disruptions.
      -