TfNSW Realtime Alerts MCP Server

What is TfNSW Realtime Alerts MCP Server?

A Model Context Protocol server that integrates with Transport for NSW’s Realtime Alerts API. It enables AI assistants to access up-to-date information about transport disruptions, planned works, and other alerts across the NSW transport network. Designed for developers and users of LLM applications who need real-time NSW transport status.

How to use TfNSW Realtime Alerts MCP Server?

Install and configure by adding the server config to your Claude Desktop settings file. Use the command npx -y tfnsw-realtime-alerts-mcp-server and set the environment variable NSW_TRANSPORT_API_KEY to your TfNSW Open Data API key. The server provides tools like get-transport-alerts (filterable by transport mode) and prompts such as transport-disruption-summary.

Key features of TfNSW Realtime Alerts MCP Server

• Resources accessible via nsw-transport:// URIs
• Filter alerts by transport mode (buses, trains, ferries, etc.)
• Provides get-transport-alerts tool with formatted alert details
• Offers transport-disruption-summary prompt for LLM summarisation
• Plain text alert format for easy AI consumption
• Supports eight transport modes including all modes

Use cases of TfNSW Realtime Alerts MCP Server

• Check current disruptions on Sydney Trains before commuting
• Summarise all major transport alerts in the NSW network
• Filter alerts for a specific mode (e.g., ferries or metro)
• Integrate live transport status into a virtual assistant or chatbot

FAQ from TfNSW Realtime Alerts MCP Server

What runtime dependencies does the server require?

It requires Node.js and npm (Node Package Manager) to run. The server is built with TypeScript.

How do I obtain a TfNSW API key?

You must register for an API key at the TfNSW Open Data Hub at https://opendata.transport.nsw.gov.au/.

What transport modes can I query?

The supported modes are: buses, ferries, lightrail, metro, nswtrains, regionbuses, sydneytrains, or all modes together.

Where do the transport alerts come from?

Alerts are fetched live from the TfNSW Realtime Alerts API maintained by Transport for NSW. No local data is stored.

How do I install and configure it for Claude Desktop?

Add a JSON entry with command npx -y tfnsw-realtime-alerts-mcp-server and environment variable NSW_TRANSPORT_API_KEY to your Claude Desktop configuration file. On macOS the path is ~/Library/Application Support/Claude/claude_desktop_config.json; on Windows it is %APPDATA%/Claude/claude_desktop_config.json.