NSW Roads

io.github.fisher98kimPublished by GitHub account fisher98kimv0.3.1Updated Oct 30, 2026

NSW live traffic hazards (crashes, roadworks, floods, fires, events) and toll costs.

VerifiedSTDIODesktop onlyLocation & LifestyleFinance

Overview

AI-generated overview

Reads live NSW road hazards and estimates Sydney toll costs from Transport for NSW data, so an assistant can answer road-condition and toll questions.

What you can do
  • List live traffic hazards such as crashes, breakdowns, roadworks, floods, fires, alpine conditions and major events, filtered by feed category, area or road name, or by distance from a place
  • Estimate toll costs in AUD between two places, with the motorways used and an optional comparison against a toll-free route, for cars or trucks and for a given Sydney time
  • Accept places as names, addresses or latitude/longitude coordinates, and return candidate matches instead of guessing when a name is ambiguous
When to use it
Useful when someone asks about current road conditions in New South Wales, such as crashes or roadworks on a specific motorway, or wants to know what tolls a Sydney drive will cost and how much time they save.
Requirements
Runs locally as a Python package via uvx (uv must be installed). Needs a free Transport for NSW Open Data Hub API token supplied in the NSW_TRANSPORT_API_KEY environment variable, and network access to the TfNSW Open Data Hub. Desktop MCP clients only.
Before you install
The API token is a secret passed in the environment; keep it out of shared configs. Toll amounts are estimates from Transport for NSW and may differ from what is actually charged. Hazard data is read-only, but every call fetches live data from a third-party government API.

Installation

In SourceWeft

  1. Open NSW Roads in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

mcp-au-nsw

MCP servers for NSW Government APIs. Ask Claude (or any MCP client) things like "How do I get from UNSW to Circular Quay right now?", "Any crashes on the M4?", "Is electrician licence 241132C current?" or "Where's the cheapest diesel near Parramatta?" and get live answers.

ServerWhat it coversData sourceKey
transportTrip planning, real-time departures, service alerts (trains, metro, buses, light rail, ferries), Park&Ride car parksTfNSW Open Data HubTfNSW key
roadsLive traffic hazards (crashes, roadworks, floods, fires, events) and toll costsTfNSW Open Data HubTfNSW key (same one)
licencesLicence checks on 15 NSW public registers (tradespeople, property agents, security, liquor, pharmacies, WHS licences, ...)API.NSWOne API.NSW key per register
fuelLive fuel prices for NSW & TASAPI.NSWAPI.NSW key

Each server is a separate subcommand, so you only add the ones you need.

Quick start

1. Get API keys (free)

TfNSW Open Data Hub (for transport and roads; one key covers both)

  1. Register: https://opendata.transport.nsw.gov.au/data/user/register
  2. Log in: https://opendata.transport.nsw.gov.au/data/user/login
  3. Click your profile icon → API Tokens, enter a name and click Create API Token.
  4. Copy the token right away; it can't be viewed again. This is your NSW_TRANSPORT_API_KEY.

Official guide: https://opendata.transport.nsw.gov.au/developers/userguide

API.NSW (for fuel and licences)

  1. Register: https://api.nsw.gov.au/Account/Register (log in: https://api.nsw.gov.au/Account/Login)
  2. Go to My Apps → Add new app: https://api.nsw.gov.au/DeveloperApp/AppCreate and attach one API product. Each app can have only one API product, so create one app per API you want (e.g. one for the Fuel API, one for the Trades register).
  3. Copy each app's API Key and API Secret into the matching environment variables (NSW_FUEL_API_KEY / NSW_FUEL_API_SECRET, NSW_TRADES_API_KEY / NSW_TRADES_API_SECRET, ...; see the licences section for the full list). The free plan allows 2,500 calls per month per app.

2. Install uv (if you don't have it)

bash
curl -LsSf https://astral.sh/uv/install.sh | sh

3. Add the servers to your MCP client

Claude Code

bash
claude mcp add nsw-transport -e NSW_TRANSPORT_API_KEY=your-tfnsw-key -- uvx mcp-au-nsw transportclaude mcp add nsw-roads     -e NSW_TRANSPORT_API_KEY=your-tfnsw-key -- uvx mcp-au-nsw roadsclaude mcp add nsw-fuel      -e NSW_FUEL_API_KEY=your-key -e NSW_FUEL_API_SECRET=your-secret -- uvx mcp-au-nsw fuelclaude mcp add nsw-licences  -e NSW_TRADES_API_KEY=your-key -e NSW_TRADES_API_SECRET=your-secret -- uvx mcp-au-nsw licences

For licences, pass the key pair of every register you subscribed to; registers without keys are simply unavailable.

Claude Desktop / Cursor / other clients: add the servers you want to the MCP config file (claude_desktop_config.json, .cursor/mcp.json, etc.):

json
{  "mcpServers": {    "nsw-transport": {      "command": "uvx",      "args": ["mcp-au-nsw", "transport"],      "env": { "NSW_TRANSPORT_API_KEY": "your-tfnsw-key" }    },    "nsw-roads": {      "command": "uvx",      "args": ["mcp-au-nsw", "roads"],      "env": { "NSW_TRANSPORT_API_KEY": "your-tfnsw-key" }    },    "nsw-fuel": {      "command": "uvx",      "args": ["mcp-au-nsw", "fuel"],      "env": { "NSW_FUEL_API_KEY": "your-key", "NSW_FUEL_API_SECRET": "your-secret" }    },    "nsw-licences": {      "command": "uvx",      "args": ["mcp-au-nsw", "licences"],      "env": {        "NSW_TRADES_API_KEY": "your-key", "NSW_TRADES_API_SECRET": "your-secret",        "NSW_PROPERTY_API_KEY": "your-key", "NSW_PROPERTY_API_SECRET": "your-secret"      }    }  }}

uvx caches the version it first downloads. To pick up a new release, use uvx mcp-au-nsw@latest ... or run uv cache clean mcp-au-nsw.

How the servers behave

  • Places by name. Tools that take a place accept names ("Town Hall", "17 High St Kensington", "Sydney Opera House"), stop IDs, or lat,lng.
  • No guessing. If a name matches several places about equally well (e.g. "UNSW" has two light rail stops, "Sydney Airport" has domestic and international stations), the tool returns the candidates instead of picking one, so the assistant can ask you.
  • Live data, no caching. Every call fetches fresh data. Responses include stable IDs (stop IDs, station codes) so you can build your own lookups for analysis.
  • Sydney local time. All times are YYYY-MM-DD HH:MM in Sydney time.

transport server

ToolWhat it does
plan_tripA-to-B journeys with legs, platforms, real-time delays and alerts. Supports arrive-by times and limiting modes
get_departuresNext departures from a station or stop, with real-time delays and platforms
get_service_alertsCurrent disruptions and trackwork, filtered by mode, line (T1, L2, 333, ...) or stop
find_stopsSearch stations, stops and wharves by name; returns stop IDs and modes
get_car_park_availabilityLive free spaces at Transport Park&Ride car parks, by name or distance from a place
get_car_park_historyHow full a Park&Ride car park was through a given day: hourly occupancy, peak, and when it filled up

Example prompts:

  • "How do I get from UNSW to Circular Quay right now?"
  • "I need to be at Manly Wharf by 6pm. When should I leave Martin Place?"
  • "When's the next train from Town Hall?"
  • "Any problems on the T1 today?"
  • "Are there any spaces left at the Tallawong Park&Ride?"
  • "What time did the Tallawong P1 car park fill up yesterday?"

roads server

ToolWhat it does
get_traffic_hazardsCrashes, breakdowns, roadworks, floods, fires, alpine conditions and major events. Filter by area/road name or distance from a place
calculate_tollToll cost (AUD) and motorways used between two places, compared with the quickest toll-free route

Example prompts:

  • "Anything happening on the M4 right now?"
  • "Any roadworks or events near Parramatta this weekend?"
  • "How much are the tolls from Parramatta to Sydney International Airport, and how much time do they save?"

Toll amounts are estimates from Transport for NSW and may differ from what is actually charged.

licences server

Checks licences on NSW public registers. All registers work the same way: look up a licence number, search by person or business name, and get the full public record.

ToolWhat it does
verify_licenceCheck a licence number: status (Current/Expired/...), expiry, licence type and holder
search_licencesFind licences by person or business name (partial names work), current ones first
get_licence_detailsFull record: licence classes (what work it covers), conditions, history, premises, associated people and licences, and compliance actions (disciplinary actions, suspensions, prosecutions, public warnings, insurance claims)
list_registersWhich registers exist, what they cover, and which are configured
Register (register value)CoversEnvironment variablesSubscribe
tradesBuilding contractors and tradespeopleNSW_TRADES_API_KEY, NSW_TRADES_API_SECRETTrades API
propertyReal estate agents, property and strata managersNSW_PROPERTY_API_*Property API
securitySecurity guards and businessesNSW_SECURITY_API_*Security API
liquorLiquor licences and premisesNSW_LIQUOR_API_*Liquor API
motorMotor dealers, repairers, recyclersNSW_MOTOR_API_*Motor API
conveyancerConveyancersNSW_CONVEYANCER_API_*Conveyancer API
lotteriesTrade promotion lotteries and games of chanceNSW_LOTTERIES_API_*Lotteries API
owner_builderOwner builder permitsNSW_OWNER_BUILDER_API_*Owner Builder Permit API
home_building_compensationHome building compensation certificatesNSW_HOME_BUILDING_COMPENSATION_API_*Home Building Compensation API
building_practitionersDesign and building practitioners, engineersNSW_BUILDING_PRACTITIONERS_API_*Design and Building Practitioners API
asbestosAsbestos removal and demolition licencesNSW_ASBESTOS_API_*Asbestos and Demolition
high_risk_workHigh risk work licences (forklifts, cranes, ...)NSW_HIGH_RISK_WORK_API_*High Risk Work
white_cardsConstruction induction and traffic control cardsNSW_WHITE_CARDS_API_*White Cards
trainersRegistered training organisationsNSW_TRAINERS_API_*Trainers and Providers API
pharmaciesPharmacy premises and financial interest holdersNSW_PHARMACIES_API_*Register of Pharmacies

NSW_X_API_* means NSW_X_API_KEY and NSW_X_API_SECRET.

Example prompts:

  • "Is electrician licence 241132C current, and does it cover electrical work?"
  • "Check whether my builder, Smith Constructions, holds a current licence and has any disciplinary actions."
  • "Is this real estate agent licensed?"

Records come straight from the public registers and can include the names, roles and addresses of licence holders and associated people.

fuel server

ToolWhat it doesAPI calls
find_fuel_pricesCheapest (or nearest) stations for a fuel type around a suburb, postcode or coordinates1 (2 with a suburb/postcode)
get_station_pricesAll current prices at one station1
search_stationsFind stations by name, brand, suburb or postcode1
list_fuel_typesFuel type codes (U91, E10, P98, DL, ...)1

Prices are in cents per litre.

Example prompts:

  • "Where's the cheapest diesel near UNSW?"
  • "What are the prices at BP Redfern right now?"

Development

bash
git clone https://github.com/fisher98kim/mcp-au-nswcd mcp-au-nswuv syncuv run pytest
# run a server locally with keys from .envuv run --env-file .env mcp-au-nsw transport

To try local changes in Claude Code:

bash
claude mcp add nsw-transport-dev -e NSW_TRANSPORT_API_KEY=... \  -- uv run --directory /path/to/mcp-au-nsw mcp-au-nsw transport

Releasing

  1. Bump version in pyproject.toml and in every registry/*.json (a test checks they match).
  2. Create a GitHub Release tagged v<version>. The workflow publishes to PyPI, then updates the MCP Registry entries (one per server).

License

MIT. Not affiliated with or endorsed by the NSW Government or Transport for NSW. Data is provided by API.NSW and the TfNSW Open Data Hub under their own terms of use.

Source: README.md at commit 50ffa0d

Tools

2

get_traffic_hazards

Live Traffic NSW hazards: crashes, breakdowns, roadworks, floods, fires, alpine conditions and major events. categories: which feeds to read (default: all). area: text matched against suburb, region and road names (e.g. "Parramatta", "M4", "Blue Mountains"). near: a place name, address or 'lat,lng'; only hazards within radius_km are returned, nearest first. include_ended: also return hazards that have finished. Open roadworks and events include planned ones that haven't started yet; check `start`.

Parametersareanearlimitradius_kmcategoriesinclude_ended

calculate_toll

Estimate toll costs (AUD) for driving between two places in NSW, with the toll roads used. origin/destination: a place name, address or 'lat,lng'. when: 'YYYY-MM-DD HH:MM' Sydney time (tolls vary by time of day); default now. vehicle: "car" (class A, incl. motorcycles) or "truck" (class B). compare_toll_free: also return the quickest toll-free route so the time saved can be weighed against the cost. Results are estimates from Transport for NSW and may differ from what is actually charged.

Parameterswhenoriginrequiredvehicledestinationrequiredcompare_toll_free

Version history

1
  1. v0.3.1LatestOct 22, 2026

Score

90% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts
  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts