get_traffic_alerts_and_jamsLABSCO SUMMARY
Ask what the traffic is doing, not where the map is.
Routing and live alerts in the same place means "is this drive bad right now" comes back with the accidents and closures already attached to the route, rather than as a second lookup you have to line up yourself.
What it is
An MCP server over OpenWeb Ninja's Waze API. It turns real-time alerts, jams, routing and place lookup into tools an assistant can call, with your own API key supplied at runtime.
What you get
- Real-time alerts inside a geographic rectangle: accident, police, hazard, road-closed and more
- Traffic jams in that same rectangle
- Driving routes between two points, including the alerts along each route
- Venues and points of interest inside a rectangle
- Type-ahead for places, addresses and POIs, to turn text into coordinates before routing
Requirements
A current Python and your own Waze API key from OpenWeb Ninja, supplied in the environment — no key ships with the server. Rectangles are given as a bottom-left and a top-right corner, and openweb_ninja_waze.py must sit in the same folder as waze_mcp_server.py.
Setup effort
Follow the published steps — Get an API key at https://app.openwebninja.com/api/waze
USE CASES
01
Deciding whether to leave now or wait
Pull the alerts and jams inside the rectangle covering your route.
02
Planning a drive with the hazards attached
Get the routes between two points, each carrying the alerts on it.
03
Turning an address into coordinates
Run it through type-ahead first, then route from the result.
04
Finding somewhere to stop along the way
Search venues inside the rectangle you are passing through.
05
Watching a neighbourhood for closures
Query the same rectangle for road-closed alerts.
4 tools
Listed in project docs. Your client may show a different list.
get_driving_directionssearch_venuesautocomplete_placesBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation. All four only read; nothing reports a hazard or changes a route.
Requires
OPENWEB_NINJA_API_KEY in your environment
Where it runs
Both documented clients run the server on your machine.
INSTALLATION
Connect your client
Server setup
TERMINAL
git clone https://github.com/AmitBarKama/WazeMCPGet an API key at https://app.openwebninja.com/api/waze
TERMINAL
cd <YOUR_PATH_TO_WAZE_MCP>Option A: python3 -m venv .venv ; . .venv/bin/activate (Windows: .venv\Scripts\activate) ; pip install -r requirements.txt (or pip install "mcp[cli]" requests)
Option B (uv):
TERMINAL
uv venv ; uv pip install -r requirements.txtRecord the absolute venv interpreter path: python3 -c "import sys; print(sys.executable)"
Register with the host — either automatically: mcp install waze_mcp_server.py -v OPENWEB_NINJA_API_KEY=<YOUR_OPENWEB_NINJA_API_KEY>, or manually with the mcpServers block below in claude_desktop_config.json
Claude Code alternative:
TERMINAL
claude mcp add waze -e OPENWEB_NINJA_API_KEY=<YOUR_OPENWEB_NINJA_API_KEY> -- <YOUR_PATH_TO_WAZE_MCP>/.venv/bin/python <YOUR_PATH_TO_WAZE_MCP>/waze_mcp_server.pyRestart the host and confirm the waze tools appear
MCP Clients
Claude Desktop, Claude Code
JSON
{
"mcpServers": {
"waze": {
"command": "<YOUR_PATH_TO_WAZE_MCP>/.venv/bin/python",
"args": [
"<YOUR_PATH_TO_WAZE_MCP>/waze_mcp_server.py"
],
"env": {
"OPENWEB_NINJA_API_KEY": "<YOUR_OPENWEB_NINJA_API_KEY>"
}
}
}
}
