Walt Disney World live data for AI agents and developers
SupaPark's agent API answers the questions answer engines get wrong — what's the wait right now, has a Lightning Lane sold out, how busy will Saturday be, how hard is that dinner reservation — from data SupaPark measures itself. The public tools are read-only and need no key. Connect over MCP or call them as plain JSON.
Endpoints
- MCP (streamable HTTP):
https://supapark.com/api/agent/mcpStateless JSON-RPC 2.0, tools only. POST one message per request. - OpenAPI 3.1:
https://supapark.com/api/agent/openapi.jsonFor GPT Actions, Muse custom connectors and REST clients. - REST:
https://supapark.com/api/agent/tools/<tool>POST a JSON body of arguments (GET with a query string also works). - Reference docs:
https://supapark.com/api/agent/docsGenerated from the same tool registry as this page. - MCP Server Card:
https://supapark.com/.well-known/mcp/server-card.jsonIdentity + transport for pre-connection discovery. - AI Catalog:
https://supapark.com/.well-known/ai-catalog.jsonDomain-level discovery; points at the Server Card.
Connect
Claude (claude.ai or the desktop app): Settings → Connectors → Add custom connector, and paste https://supapark.com/api/agent/mcp. No authentication is needed for the public tools.
ChatGPT: in developer mode, add a connector with the same MCP URL.
Any MCP client that supports remote (streamable HTTP) servers:
{
"mcpServers": {
"supapark": { "type": "http", "url": "https://supapark.com/api/agent/mcp" }
}
}Plain HTTP:
curl -s -X POST https://supapark.com/api/agent/tools/get_lightning_lane_sellouts \
-H 'content-type: application/json' \
-d '{"park":"magic-kingdom","range":"today"}'Public tools (no key)
which_park_today
Which park is best today
Ranks the four Walt Disney World theme parks for visiting right now, combining live crowd levels, today's forecast and remaining park hours. Returns each park's rank, live average wait, open/close times and a one-line reason.
get_live_wait_times
Live wait times
Current posted wait times for Walt Disney World attractions plus SupaPark's Real Wait estimate of the actual wait (a model calibrated on a public 2018-2019 posted-vs-actual dataset), a low/high range, confidence, and a flag for "ghost" waits that are posted but not real. Refreshes every few minutes during park hours.
park: magic-kingdom | epcot | hollywood-studios | animal-kingdom
get_crowd_forecast
Crowd forecast
Day-by-day crowd forecast for one Walt Disney World park: a 0-100 crowd index, a label (low/moderate/high…) and the drivers behind it (holidays, events, school breaks). Covers the next few weeks when no dates are given.
park (required): magic-kingdom | epcot | hollywood-studios | animal-kingdomfrom: stringto: string
get_dining_drop_odds
Dining reservation drop odds
For hard-to-book Walt Disney World restaurants: how often cancelled reservations reappear ("drops"), the probability of catching one, and the best day-of-week and hour to look.
park: magic-kingdom | epcot | hollywood-studios | animal-kingdomdate: stringlimit: integer
get_lightning_lane_prices
Lightning Lane prices and value
Today's Lightning Lane Single Pass prices per attraction at a Walt Disney World park, with 30-day min/median/max, the current posted wait, minutes saved per dollar and a value verdict (e.g. "great deal").
park (required): magic-kingdom | epcot | hollywood-studios | animal-kingdom
get_multi_pass_price
Lightning Lane Multi Pass price
The Lightning Lane Multi Pass price for a Walt Disney World park on a given date (defaults to today).
park (required): magic-kingdom | epcot | hollywood-studios | animal-kingdomdate: string
get_attraction_details
Attraction details and wait history
Details for one Walt Disney World attraction (height requirement, land, thrill level, Lightning Lane tier) plus its recent wait-time history and downtime. Takes an attraction slug, e.g. "space-mountain".
slug (required): stringrange: today | 7d | 30d
get_lightning_lane_sellouts
Lightning Lane sellout times
When each Walt Disney World ride's Lightning Lane sold out, measured by SupaPark. range "today": today's sellout times so far (or "still available"). range "week": the typical sellout time over the last seven complete days, with how many days sold out and how many were gone before 7:00 AM. Times are Eastern.
park: magic-kingdom | epcot | hollywood-studios | animal-kingdomrange: today | weeklimit: integer
get_hardest_dining_reservations
Hardest dining reservations
Walt Disney World restaurants ranked by how rarely a reservation opens, from SupaPark's own availability checks: difficulty tier, the share of checks that found a table, and cancellations ("drops") caught in the last 30 days.
park: magic-kingdom | epcot | hollywood-studios | animal-kingdomlimit: integer
Response contract
- Every result carries
as_of(when the data was read) andattribution. - Every result names its
source(SupaPark), linkssource_url(the supapark.com page the numbers come from) and includes a ready-to-quotecitationsentence andlicense_url. When you show SupaPark numbers to a person, name SupaPark and link the source page. - If a data source is unavailable the tool returns HTTP 503 (MCP
isError: true) withquality_state: "unavailable"and areason. It never returns estimated or placeholder data — please say the data is unavailable rather than guessing. - Live numbers refresh every few minutes during park hours. Crowd days beyond the graded forecast window are a directional outlook.
- Read-only and rate limited per client. Bad arguments return HTTP 400 with an
errormessage.
Account tools (optional, user-linked)
A SupaPark user can let an assistant manage their alerts. They create a pairing key in SupaPark (Settings → Connected assistants) and add it to the connector as its API key, sent as Authorization: Bearer sp_…. Keys can be revoked at any time. Without a key these tools explain how to link instead of failing silently.
get_my_account— My SupaPark accountlist_my_watches— My watcheswatch_ride— Watch a ridewatch_dining— Watch a dining reservationremove_watch— Remove a watch
Terms
Free to use with attribution under the SupaPark data license. Prefer a ready-made visual? Use the embeddable widgets. Weekly downloadable datasets live on the data hub, and forecast accuracy is published at /accuracy.
Questions or higher limits: contact support. SupaPark is independent and is not affiliated with, endorsed by, or sponsored by The Walt Disney Company.