ParkAlert MCP

An MCP server that exposes Disney ride status and wait times as on-demand tools, backed by the ThemeParks.wiki API.

This is the pull-based sibling of ParkAlert, a PWA that polls the same API on a timer and pushes a notification through ntfy.sh when a ride goes down or comes back up. ParkAlert answers "tell me when something changes." This server answers "what is the situation right now, because I just asked." The API client is ported from ParkAlert's server/themeparks.js; the polling loop, the transition detection, the trip codes, and the notification fan-out are all deliberately left behind.

Tools

Both tools accept a park by name, alias, or ThemeParks.wiki entity ID ("Magic Kingdom", "dhs", "epcot"), and a ride by however a person would say it — partial and near-miss names such as "space mountain" or "tron" are matched, and an ambiguous name comes back with the candidates it could have meant.

Supported parks: Magic Kingdom, EPCOT, Hollywood Studios, Animal Kingdom, Disneyland (CA), California Adventure. Add more by appending to PARKS in src/parkalert_mcp/parks.py.

Related MCP server: Disney Parks MCP Server

Setup

Requires Python 3.10 or newer (the mcp SDK's floor).

python3.12 -m venv .venv
.venv/bin/pip install -e .

Running it

The server speaks stdio, so it is launched by its client rather than run as a long-lived service. To exercise it by hand:

.venv/bin/python -m parkalert_mcp.server

For an interactive tool browser, the MCP Inspector works against the same command:

npx @modelcontextprotocol/inspector .venv/bin/python -m parkalert_mcp.server

Claude Desktop

Add the server to ~/Library/Application Support/Claude/claude_desktop_config.json:

{
  "mcpServers": {
    "parkalert": {
      "command": "/Users/austin/parkalert-mcp/.venv/bin/python",
      "args": ["-m", "parkalert_mcp.server"]
    }
  }
}

The absolute path to the venv's Python matters: Claude Desktop does not run through a login shell, so a bare python would not resolve to this environment. Restart Claude Desktop after editing, then look for the tools under the connectors icon.

Credits

Built by Austin Vodrazka with Claude.