MCP.so
Sign In

TfNSW Realtime Alerts MCP Server

@piddlingtuna

Basic information

Category

Other

License

MIT

Transports

stdio

Author

piddlingtuna

About TfNSW Realtime Alerts MCP Server

A Model Context Protocol (MCP) server for TfNSW's realtime alerts API

TfNSW Realtime Alerts MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "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 tools

1

Retrieve current transport alerts

Overview

What is TfNSW Realtime Alerts MCP Server?

A Model Context Protocol (MCP) server that integrates with Transport for NSW’s Realtime Alerts API, enabling AI assistants to access and interact with up‑to‑date transport disruption and planned works information across the NSW transport network. It is built in TypeScript and designed for use with large language models.

How to use TfNSW Realtime Alerts MCP Server?

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.

Key features of TfNSW Realtime Alerts MCP Server

  • 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

Use cases of TfNSW Realtime Alerts MCP Server

  • Querying current transport disruptions across all modes in NSW
  • Getting a bullet‑point summary of major works or service changes
  • Integrating real‑time alert data into conversational AI helpdesks or travel assistants

Frequently asked questions

1

What authentication is required?

You must register for a free API key at the TfNSW Open Data Hub and set it as the `NSW_TRANSPORT_API_KEY` environment variable.

2

Which transport modes are supported?

`all`, `buses`, `ferries`, `lightrail`, `metro`, `nswtrains`, `regionbuses`, and `sydneytrains`.

3

How do I install and run the server?

Use `npx -y tfnsw-realtime-alerts-mcp-server` in your Claude Desktop configuration, or clone the repo, run `npm install` and `npm run build`.

4

Where is the configuration file located?

On macOS: `~/Library/Application Support/Claude/claude_desktop_config.json`. On Windows: `%APPDATA%/Claude/claude_desktop_config.json`.

5

Can I debug the server?

Yes, you can use the MCP Inspector by running `npm run inspector` in the project root.

Comments

More Other MCP servers