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 via nsw-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.

This server cannot be installed

security - not tested

license - permissive license

quality - not tested

remote-capable server

The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.

This server enables large language models to access and interact with real-time transport alerts from Transport for NSW's network, supporting filtering by transport mode and returning formatted alert information about disruptions and planned works.

Related Resources

Reddit Discussion about this server

Related MCP Servers

Vilnius Transport MCP Server
sarunasdaujotis
A
security
F
license
A
quality
Enables Large Language Models to access real-time data on Vilnius public transport stops and routes through the Model Context Protocol.
Last updated -
2
1
Python
Linear MCP Server
jerhadf
-
security
A
license
-
quality
A Model Context Protocol server that integrates with Linear's issue tracking system, allowing LLMs to create, update, search, and comment on Linear issues through natural language interactions.
Last updated -
324
288
JavaScript
MIT License
Transport NSW API Client MCP
danhussey
-
security
F
license
-
quality
An MCP service for interacting with Transport NSW's API that enables users to find transport stops around locations and retrieve information about transport alerts and disruptions.
Last updated -
Python
NTFY MCP Server
cyanheads
-
security
A
license
-
quality
A Model Context Protocol server enabling AI systems to send real-time notifications to phones, desktops, and other devices through the ntfy publish/subscribe service.
Last updated -
18
7
TypeScript
Apache 2.0

View all related MCP servers

TfNSW Realtime Alerts MCP Server