NS Travel Information MCP Server

1[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/r-huijts-ns-mcp-server-badge.png)](https://mseep.ai/app/r-huijts-ns-mcp-server)
2 
3| <img src="https://upload.wikimedia.org/wikipedia/commons/b/b7/Nederlandse_Spoorwegen_logo.svg" alt="NS Logo" width="380"/> | <img src="https://glama.ai/mcp/servers/tzd5oz5tov/badge" alt="NS Travel Information Server MCP server" width="380"/> |
4|:---:|:---:|
5 
6# NS Travel Information MCP Server
7 
8[![smithery badge](https://smithery.ai/badge/ns-server)](https://smithery.ai/server/ns-server)
9[![npm version](https://badge.fury.io/js/ns-mcp-server.svg)](https://www.npmjs.com/package/ns-mcp-server)
10 
11Transform 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.
12 
13## Installation
14 
15You can install this server in three ways:
16 
17### 1. Using Claude Desktop with NPM Package
18 
19Update your Claude configuration file (`~/Library/Application Support/Claude/claude_desktop_config.json`):
20 
21```json
22{
23  "mcpServers": {
24    "ns-server": {
25      "command": "npx",
26      "args": [
27        "-y",
28        "ns-mcp-server"
29      ],
30      "env": {
31        "NS_API_KEY": "your_api_key_here"
32      }
33    }
34  }
35}
36```
37 
38You can get an API key from [NS API Portal](https://apiportal.ns.nl/)
39 
40### 2. Using Smithery
41 
42To install NS Travel Information Server automatically via [Smithery](https://smithery.ai/server/ns-server):
43 
44```bash
45npx -y @smithery/cli install ns-server --client claude
46```
47 
48### 3. From Source
49 
501. Clone this repository
512. Install dependencies:
52   ```bash
53   npm install
54   ```
553. Copy the example environment file:
56   ```bash
57   cp .env.example .env
58   ```
594. Add your NS API key to the `.env` file:
60   ```
61   NS_API_KEY=your_api_key_here
62   ```
63 
64Then update your Claude configuration file:
65 
66```json
67{
68  "mcpServers": {
69    "ns-server": {
70      "command": "node",
71      "args": [
72        "/path/to/ns-server/build/index.js"
73      ],
74      "env": {
75        "NS_API_KEY": "your_api_key_here"
76      }
77    }
78  }
79}
80```
81 
82Make sure to:
831. Replace `/path/to/ns-server` with the actual path to your installation
842. Add your NS API key in the `env` section. It can be obtained from here [https://apiportal.ns.nl/product#product=NsApp](https://apiportal.ns.nl/product#product=NsApp)
85 
86After updating the configuration, restart Claude Desktop for the changes to take effect.
87 
88## Real-World Use Cases
89 
90- "Is my usual 8:15 train from Almere to Amsterdam running on time?"
91- "Are there any delays on the Rotterdam-Den Haag route today?"
92- "What's the best alternative route to Utrecht if there's maintenance on the direct line?"
93- "Which train should I take to arrive at my office in Amsterdam Zuid before 9 AM?"
94- "Which route to Amsterdam has the fewest transfers with a stroller?"
95- "What's the earliest train I can take to make my 10 AM meeting in The Hague?"
96- "When's the last train back to Groningen after a night out in Amsterdam?"
97- "Are there any weekend engineering works that might affect my Monday morning class?"
98- "Are there OV-fiets bikes available at Utrecht Centraal for my afternoon meeting?"
99- "Is Eindhoven Strijp-S station wheelchair accessible and what platforms does it have?"
100- "What trains are arriving at Utrecht Centraal in the next hour?"
101- "Has the train from Venlo to Schiphol Airport arrived on time?"
102- "How much does a first-class ticket from Amsterdam to Rotterdam cost?"
103- "What's the price for 2 adults and 1 child traveling to Den Haag?"
104 
105## 🔑 Environment Variables
106 
107| Variable | Description |
108|----------|-------------|
109| NS_API_KEY | Your NS API key (required) |
110 
111## 🌟 Features
112 
113This MCP server provides comprehensive access to NS train information through the following endpoints:
114 
115### Real-time Train Information
116- **Departures**: Get real-time departure information including platform numbers, delays, and travel notes
117- **Arrivals**: Access upcoming train arrivals with origin stations, platform changes, and status updates
118- **Journey Planning**: Find optimal travel routes with transfers and real-time updates
119- **Service Updates**: Check for disruptions, maintenance work, and engineering activities
120 
121### Pricing Information
122- **Ticket Prices**: Get accurate pricing for single and return journeys
123- **Travel Classes**: Compare prices for first and second class travel
124- **Group Pricing**: Calculate fares for adults and children
125- **Discount Options**: Check joint journey discounts and special offers
126- **Validity Details**: View ticket validity periods and travel conditions
127 
128### Station Information
129- **Station Details**: Access comprehensive station information including:
130  - Facilities and accessibility features
131  - Platform layouts and track information
132  - OV-fiets (bike rental) availability
133  - Location and approach details
134 
135### Additional Features
136- **Multi-language Support**: Information available in Dutch and English
137- **Flexible Queries**: Search by station name, code, or UIC identifier
138- **Time Zones**: Proper handling of time zones for international stations
139- **Status Updates**: Track changes, delays, and cancellations in real-time
140 
141## License
142 
143This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details
144