Ns MCP Server logo

Ns MCP Server

by r-huijts

Accesses Dutch Railways schedules, fares, station details, disruptions, and real-time train updates through MCP.

Install Ns MCP Server

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "r-huijts-ns-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "ns-mcp-server"
      ],
      "env": {
        "NS_API_KEY": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y ns-mcp-server

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 23d ago.

Overview

The r-huijts/ns-mcp-server MCP server connects an MCP-compatible assistant to Dutch Railways (NS) travel data. It provides departures, arrivals, journey planning, disruptions, fares, and station information, including accessibility and OV-fiets availability. Use it for planning Dutch train journeys or checking live service conditions; an NS API key is required.

Use cases

  • Check live departures and delays
  • Plan routes with transfers
  • Compare train fares and travel classes
  • Find station accessibility and facilities
  • Check OV-fiets availability

Key features

  • Real-time departures and arrivals
  • Journey planning with live updates
  • Disruption and engineering-work information
  • Ticket pricing and passenger fares
  • Station accessibility and OV-fiets details
  • Dutch and English responses

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 1d ago

Recent health check succeeded.

19/20 checks healthy over the last 78d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 6d ago via OSV.dev · ns-mcp-server (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars62Stargazers on the source repository.
npm downloads131Package downloads in the last 30 days.
Last commit1y agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity3 viewsConfig copies, upvotes, and views on AllMCPs.

How Ns MCP Server works

What r-huijts/ns-mcp-server does

The r-huijts/ns-mcp-server MCP server exposes Dutch Railways (NS) travel information to an AI assistant. It covers scheduled and real-time train data, allowing an assistant to answer questions about departures, arrivals, delays, cancellations, route options, transfers, and engineering work across the Netherlands.

It also provides fare information for single and return journeys, first- and second-class travel, adult and child passenger groups, discounts, ticket validity, and travel conditions. Station queries can return facilities, accessibility details, platforms, tracks, location information, approach details, and OV-fiets rental availability.

This server belongs in the 🚆 Travel & Transportation category and is relevant when an application needs conversational access to NS journey data rather than a static timetable.

How it works

The r-huijts/ns-mcp-server MCP server uses the NS API as its data source and makes the results available through MCP tools. Queries can identify stations by name, station code, or UIC identifier. The service handles time zones for international stations and can return information in Dutch or English.

The available data includes live status changes such as delays, cancellations, platform changes, and other travel notes. Journey-planning requests can include transfers and current updates, while departure and arrival requests focus on upcoming services at a station.

Setup and configuration

An NS API key is required. Obtain one through the NS API Portal, then provide it as the NS_API_KEY environment variable.

For an npm-based installation, configure the MCP client to run npx -y ns-mcp-server and pass NS_API_KEY in the server environment. The repository also supports installation from source: clone it, run npm install, copy .env.example to .env, and add the key. Build and run the generated build/index.js from the client configuration, using the actual installation path.

After changing the Claude Desktop configuration, restart the application so the server is loaded.

Tools and capabilities

The r-huijts/ns-mcp-server MCP server supports these information areas:

  • Real-time departures with platforms, delays, and travel notes
  • Upcoming arrivals with origins, platform changes, and status information
  • Journey planning with route alternatives, transfers, and live updates
  • Disruptions, maintenance, and engineering-work information
  • Ticket prices, travel classes, passenger groups, discounts, and validity
  • Station facilities, accessibility, platforms, tracks, locations, and OV-fiets availability

These capabilities support requests such as finding an early or late train, checking whether a service is running, comparing routes with fewer transfers, checking a station’s accessibility, or estimating fares for adults and children.

Limitations and notes

The server depends on access to the NS API and therefore requires a valid NS_API_KEY.

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Ns MCP Server

r-huijts/ns-mcp-server is an MCP server that connects AI assistants to Dutch Railways (NS) data through the NS API. Its main tools provide departures, arrivals, journey planning, service disruptions, fares, station details, accessibility, platforms, and OV-fiets availability, with real-time updates in Dutch or English.

Install it with npm, Smithery, or from source. The npm option runs `npx -y ns-mcp-server`; Smithery provides `npx -y @smithery/cli install ns-server --client claude`; source installation requires cloning the repository, running `npm install`, and configuring the built server.

It needs an NS API key stored in the `NS_API_KEY` environment variable. The key is obtained from the NS API Portal and must be passed in the MCP client configuration or placed in the source installation’s `.env` file.

Yes, it works with Claude Desktop through an MCP server configuration. Add the `npx` command or the built `index.js` path, provide `NS_API_KEY` in the environment, and restart Claude Desktop after saving the configuration.

Related MCP servers

Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewNs MCP Server AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/r-huijts-ns-mcp-server?style=directory)](https://allmcps.com/mcp/r-huijts-ns-mcp-server)
HTML Embed
<a href="https://allmcps.com/mcp/r-huijts-ns-mcp-server"><img src="https://allmcps.com/api/badge/r-huijts-ns-mcp-server?style=directory" alt="Ns MCP Server on AllMCPs" /></a>