TfNSW Realtime Alerts MCP Server
About
A Model Context Protocol (MCP) server for TfNSW's realtime alerts API
Details
- Author
- piddlingtuna
- GitHub stars
- 7
- Downloads
- 173
- Categories
- Other
Jump to
- List and access transport alerts via nsw-transport:// URIs
- Filter alerts by transport mode (buses, ferries, trains, etc.)
- Retrieve current alerts formatted with route, time, and impact details
- Pre‑built prompt for summarizing major disruptions
- Plain text output for easy consumption by AI assistants
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
TfNSW Realtime Alerts MCP ServerCommand (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
From the repository
Install and run via npx, then configure your TfNSW API key as an environment variable. Add the server configuration to your Claude Desktop config file (e.g., ~/Library/Application Support/Claude/claude_desktop_config.json on macOS). The server provides the tool get-transport-alerts and the prompt transport-disruption-summary.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"tfnsw realtime alerts mcp server": {
"tfnsw-realtime-alerts": {
"command": "npx",
"args": [
"-y",
"tfnsw-realtime-alerts-mcp-server"
],
"env": {
"NSW_TRANSPORT_API_KEY": "your_api_key_here"
}
}
}
}
}McpServers
{
"tfnsw-realtime-alerts": {
"command": "npx",
"args": [
"-y",
"tfnsw-realtime-alerts-mcp-server"
],
"env": {
"NSW_TRANSPORT_API_KEY": "your_api_key_here"
}
}
}TfNSW Realtime Alerts MCP Server
A Model Context Protocol server for Transport for NSW's (TfNSW) Realtime Alerts API. This server provides tools to access and interact with real-time transport alerts and information via Large Language Models.
Overview
This TypeScript-based MCP server implements integration with Transport for NSW's Realtime Alerts system. It enables AI assistants to access up-to-date information about transport disruptions, planned works, and other important alerts across the NSW transport network.
Features
Resources
- List and access transport alerts viansw-transport:// URIs
- Filter alerts by transport mode (buses, trains, ferries, etc.)
- Plain text format for easy consumption by AI assistants
Tools
-get-transport-alerts - Retrieve current transport alerts
- Filter by transport mode
- Returns formatted alert information including affected routes, time periods, and impact details
Prompts
-transport-disruption-summary - Generate a summary of current transport alerts
- Includes relevant alert details as embedded resources
- Returns structured prompt for LLM summarisation of major disruptions
Transport Modes
The following transport modes are supported:
- all - All transport modes
- buses - Sydney Metro and Outer Metro Bus services
- ferries - Sydney Ferries and Newcastle Transport ferries
- lightrail - Light Rail services
- metro - Sydney Metro
- nswtrains - NSW Trains regional trains and coaches
- regionbuses - Regional Bus services
- sydneytrains - Sydney Trains suburban and intercity network
Authentication
This server requires authentication with the TfNSW Open Data API. You will need to register for an API key at the TfNSW Open Data Hub.
Installation
To use with Claude Desktop, add the server config:
On MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json
On Windows: %APPDATA%/Claude/claude_desktop_config.json
{
"mcpServers": {
"tfnsw-realtime-alerts": {
"command": "npx",
"args": [
"-y",
"tfnsw-realtime-alerts-mcp-server"
],
"env": {
"NSW_TRANSPORT_API_KEY": "your_api_key_here"
}
}
}
}
Replace "your_api_key_here" with your TfNSW API key from the TfNSW Open Data Hub.
Development
Configure your API key as an environment variable in your .env file:
NSW_TRANSPORT_API_KEY="your_api_key_here"
Install dependencies:
npm install
Build the server:
npm run build
For development with auto-rebuild:
npm run watch
Debugging
You can use the MCP Inspector for debugging, which is available as a package script:
npm run inspector
The Inspector will provide a URL to access debugging tools in your browser.
License
This project is licensed under the MIT License - see the LICENSE file for details.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
