SupaPark Gold MCP server docs

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.

Try: “Which Disney World park is the best pick right now?”

Current posted wait times for Walt Disney World attractions plus SupaPark's Real Wait estimate of the actual wait, 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: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park to return waits for. Omit for all four parks.

Try: “What are the waits at Magic Kingdom right now? Anything short that's worth it?”

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): string — Attraction slug, e.g. "space-mountain".
• range: string; one of today, 7d, 30d; default 7d

Try: “How has Slinky Dog Dash's wait moved this week?”

Right now at one Walt Disney World park: which rides are operating, which are closed while the park is open (down, weather delay or not running today), each operating ride's posted wait and SupaPark's Real Wait estimate, and how fresh each reading is. Use for "is Tron down", "what's closed at Magic Kingdom right now". Ride status comes from the park's live feed; SupaPark does not currently keep a reliable breakdown history.

• park (required): string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park.
• only: string; one of all, not_operating, operating; default all — not_operating = closed or down while the park is open.

Try: “Is Tron down right now? What's closed at Magic Kingdom?”

Opening and closing times for the Walt Disney World theme parks on a date (or a run of days), plus separately ticketed party nights (Halloween and Christmas parties, After Hours) that close the park early for day guests. Use this for "what time does Magic Kingdom open/close", "is there a party that night". Early Theme Park Entry and Extended Evening Hours are not included (SupaPark does not track them yet). Times are Eastern.

• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park. Omit for all four parks.
• date: string (date) — First date, YYYY-MM-DD (Eastern). Defaults to today.
• days: integer; 1–31; default 1 — How many consecutive days to return (1-31).

Try: “What time does Magic Kingdom close on Friday? Is there a party that night?”

Today's (or the next two days') show times at one Walt Disney World park: nighttime spectaculars and fireworks, parades and stage shows, with any same-day schedule change SupaPark detected, party-only performances, and optionally character meet windows. Use for "when are the fireworks", "what time is the parade", "what shows are on". Times are Eastern. If the schedule is not loaded for that day, it says so; a show missing from a loaded schedule is not on the published schedule.

• park (required): string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park.
• date: string (date) — YYYY-MM-DD (Eastern), today through two days ahead. Defaults to today.
• include_character_meets: boolean; default false — Also list character meet-and-greet windows.

Try: “When are the fireworks and the parade at Magic Kingdom tonight?”

Weather for the Walt Disney World parks: daily forecast (high/low °F, chance of rain, conditions, storm risk), an hour-by-hour outlook for one park, and right now the National Weather Service thunderstorm/lightning picture for the resort (chance of thunder in the next hours, any active warning). Lightning pauses outdoor rides and pools, so use this for "will it rain", "should we do indoor rides", "is there lightning nearby".

• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park for the hourly outlook. Omit for the four-park daily forecast.
• date: string (date) — YYYY-MM-DD (Eastern); today through 14 days ahead. Defaults to today.
• days: integer; 1–14; default 3 — Daily forecast days to return.

Try: “Will it rain at EPCOT this afternoon? Any lightning nearby?”

The newest Walt Disney World news SupaPark has published (closures, openings, refurbishments, announcements, Lightning Lane and dining moves), newest first, each with a link. Use for "any Disney World news", "what changed at EPCOT this week".

• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Only news about this park.
• limit: integer; 1–20; default 8

Try: “Any Disney World news this week I should know about before our trip?”

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): string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park to forecast.
• from: string (date) — First date, YYYY-MM-DD.
• to: string (date) — Last date, YYYY-MM-DD.

Try: “How busy will EPCOT be next Tuesday through Friday?”

SupaPark's crowd calendar: the 1-10 crowd level for every day of a month at one or all four Walt Disney World parks, the least crowded days, and the best park each day. Levels within about a month are precise forecasts; further out they are directional. Use for "when should we go", "least crowded days in March", "which park on which day". For a short date range with drivers (holidays, events), use get_crowd_forecast.

• month: string — Month, YYYY-MM. Defaults to the current month.
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park. Omit for all four.
• weekends: string; one of include, exclude, only; default include — Filter Saturdays and Sundays.

Try: “What are the least crowded days in March, and which park each day?”

Searches Walt Disney World rides by what a party needs: a child's height (only rides they can ride), thrill level (1 gentle to 5 intense), Lightning Lane type, single rider line, Rider Switch, or words in the name or land. Each match has height requirement, thrill, duration, Lightning Lane, the posted wait now, SupaPark's Real Wait estimate, and the short SupaPark review verdict. Use for "what can a 40-inch kid ride", "gentle rides at EPCOT", "rides with single rider".

• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park. Omit for all four.
• rider_height_in: integer; 30–80 — Shortest rider's height in inches; only rides they meet the height requirement for.
• min_thrill: integer; 1–5
• max_thrill: integer; 1–5 — 1 = gentle, 5 = most intense.
• lightning_lane: string; one of any, multi, single, none; default any — Lightning Lane type.
• single_rider: boolean — true = only rides with a single rider line.
• rider_switch: boolean — true = only rides that offer Rider Switch.
• query: string — Words in the ride name or land, e.g. "coaster" or "Tomorrowland".
• sort: string; one of wait, thrill, name, popularity; default name
• limit: integer; 1–60; default 25

Try: “What can a 40-inch kid ride at Hollywood Studios?”

When the line for one Walt Disney World ride should be shortest: for today and the next two days, SupaPark's half-hour wait forecast with the best windows and the peak; for any date, the typical wait at each hour measured from SupaPark's wait history (weekday or weekend pattern). Use for "when should we ride Slinky Dog", "is it better to do Flight of Passage early or late".

• ride (required): string — Ride slug or name, e.g. "slinky-dog-dash" or "Slinky Dog".
• date: string (date) — YYYY-MM-DD (Eastern). Defaults to today.
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Optional: the ride's park, to tell apart similar names.

Try: “When should we ride Flight of Passage tomorrow, early or late?”

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): string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park to price.

Try: “Is today's Single Pass for Hollywood Studios worth the money?”

The Lightning Lane Multi Pass price for a Walt Disney World park on a given date (defaults to today).

• park (required): string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park to price.
• date: string (date) — YYYY-MM-DD; defaults to today.

Try: “What does Lightning Lane Multi Pass cost for Animal Kingdom on Saturday?”

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: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Filter to one park. Omit for all four parks.
• range: string; one of today, week; default today
• limit: integer; 1–25; default 15

Try: “When did Lightning Lanes sell out at Magic Kingdom this week?”

How often one Walt Disney World ride's Lightning Lane sold out, measured by SupaPark: on how many of the last measured park days (up to 28) it sold out, how many were gone before 7:00 AM, the typical sellout time, refills, and today's status. Times are Eastern. Days the ride was down or closed are excluded.

• ride (required): string — Ride slug or name, e.g. "seven-dwarfs-mine-train".
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — The ride's park (recommended; resolves similar names).

Try: “How likely is the Tron Lightning Lane to sell out before noon?”

Listed while SupaPark's insider tools are switched on.

Lightning Lane availability right now at Walt Disney World: for each ride, whether Lightning Lane return times are available and the next return time, the current Single Pass price where there is one, and how fresh each reading is. Optionally, when the booking window opens for a trip date (resort guests 7 days before check-in, everyone else 3 days before each park day, at 7:00 AM Eastern). For historical sellout times use get_lightning_lane_sellouts.

• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park. Omit for all four.
• only_available: boolean; default false — Only rides with return times available now.
• trip_date: string (date) — Optional: check-in date (on-site) or park day (off-site) to compute the booking window.
• staying_on_site: boolean — With trip_date: staying at a Disney resort hotel.

Try: “Which Lightning Lanes at Magic Kingdom still have return times right now?”

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: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Filter to restaurants in this park.
• date: string (date) — Target dining date, YYYY-MM-DD.
• limit: integer; 1–50; default 20

Try: “Which hard-to-book restaurants at Magic Kingdom get the most cancellations?”

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: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Filter to restaurants in this park.
• limit: integer; 1–25; default 10

Try: “Which Disney World restaurants are hardest to book right now?”

Searches Walt Disney World restaurants by park or area (including Disney Springs and the resort hotels), service type, cuisine, price, character dining, and whether they take reservations. Each match has SupaPark's 0-10 rating, how hard it is to book (from SupaPark's own availability checks), price range, cuisine and a one-line description. Use for "character breakfast at EPCOT", "best table service at Animal Kingdom", "cheap quick service near Tomorrowland".

• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom, disney-springs, resort-hotels, water-parks — Park or area. Omit for everywhere.
• category: string; one of table_service, quick_service, lounge, snack, fine_dining — Service type.
• cuisine: string — Cuisine word, e.g. "Italian", "Mexican", "seafood".
• character_dining: boolean — true = only character dining (characters visit tables), per SupaPark's restaurant catalog.
• price: string; one of $, $$, $$$, $$$$ — Price range ($ under $15 a person … $$$$ over $60).
• takes_reservations: boolean
• query: string — Words in the restaurant name.
• sort: string; one of rating, hardest_to_book, name; default rating
• limit: integer; 1–40; default 15

Try: “Find a character breakfast at EPCOT that takes reservations.”

Reservation times SupaPark's checks saw open at one Walt Disney World restaurant in the last 45 minutes (today and upcoming dates), the same-day openings it caught over the past week, and when cancellations tend to appear. This is what was seen, not a booking: grab it in My Disney Experience, or set a watch (watch_dining) to be alerted. If SupaPark has no fresh check, it says so instead of guessing.

• restaurant (required): string — Restaurant slug or name, e.g. "be-our-guest-restaurant" or "Be Our Guest".
• date: string (date) — Only this date, YYYY-MM-DD (Eastern).

Try: “Has anything opened up at Be Our Guest today?”

SupaPark's measured odds of getting a table at one Walt Disney World restaurant for a date, meal and party size: the chance a table turns up if you keep watching until the day, the chance one drops when the meal is full at first look, and the time of day openings usually appear. Measured on comparable past dates (same lead time and weekday/weekend). Works up to 60 days ahead (the reservation window).

• restaurant (required): string — Restaurant slug or name, e.g. "be-our-guest-restaurant" or "Be Our Guest".
• date (required): string (date) — Dining date, YYYY-MM-DD, today through 60 days ahead.
• meal (required): string; one of breakfast, lunch, dinner
• party_size (required): integer; 1–10

Try: “What are our odds of a dinner table for 4 at Cinderella's Royal Table on March 12?”

Verified insider tips SupaPark keeps for one Walt Disney World ride or restaurant: where to sit, timing, shortcuts, what to order, and patterns SupaPark measured itself. Without a linked account the result has one shortened tip and the number of further tips; a linked Silver or Gold account gets the full list. Takes a slug or name, e.g. "space-mountain" or "Space Mountain".

• entity (required): string — Ride or restaurant slug or name.
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Optional: the park, to tell apart places with similar names.

Try: “Any insider tips for Guardians of the Galaxy: Cosmic Rewind?”

Listed while SupaPark's insider tools are switched on.

Verified practical facts for one Walt Disney World ride: height requirement, ride length, Rider Switch, single rider line, scary moments for young children, whether it is wet, dark or loud, motion sickness risk, recommended seat, on-ride photo, indoor queue and wheelchair access. Only facts confirmed by SupaPark's attraction data or cross-checked across independent sources are returned.

• ride (required): string — Ride slug or name, e.g. "slinky-dog-dash".
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Optional: the park, to tell apart rides with similar names.

Try: “What's the height requirement for Expedition Everest, and does it have single rider?”

Listed while SupaPark's insider tools are switched on.

A short answer to a Walt Disney World question from SupaPark's verified knowledge: insider tips and practical facts about the rides and restaurants the question names, plus Lightning Lane sellout history when asked. Returns plain points with the places they are about. It does not include live wait times (use get_live_wait_times). Without a linked Silver or Gold account the answer is shorter.

• question (required): string — The question, in plain words (max 300 characters).
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Optional: the park the question is about.

Try: “Ask Merlin whether Space Mountain or Big Thunder is better for a nervous first-timer.”

Listed while SupaPark's insider tools are switched on.

Everything SupaPark knows about one Walt Disney World ride, in one call: the basics (height, thrill, length, land, single rider, Rider Switch, Lightning Lane type), verified practical facts (scary moments, wet, dark, motion sickness, best seat, accessibility), live status with posted wait and Real Wait estimate, best times to ride today and the typical hour-by-hour pattern, 30-day wait history, Lightning Lane price and how often it sells out (and how early), every verified insider tip including Gold-only measured secrets, and SupaPark's fact-checked review. Use when the member asks about a specific ride in any depth.

• ride (required): string — Ride slug or name, e.g. "tron-lightcycle-run" or "Tron".
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Optional: the ride's park, to tell apart similar names.

Try: “Give me the full rundown on Tron Lightcycle Run before we go.”

Everything SupaPark knows about one Walt Disney World restaurant, in one call: service type, cuisine, price, meals, seating and what it is best for; signature dishes and menu highlights with prices; SupaPark's 0-10 rating and its own take; how hard it is to book, the measured odds of getting a table by meal, party size and lead time, when cancellations appear, open times seen right now and same-day openings caught this week; and every verified insider tip including Gold-only ones. Use when the member asks about a specific restaurant in any depth.

• restaurant (required): string — Restaurant slug or name, e.g. "be-our-guest-restaurant" or "Be Our Guest".

Try: “Tell me everything about Sanaa: what to order, how hard it is to book, any tips.”

SupaPark's verified insider tips across one Walt Disney World park, filterable by topic: rope drop, the last hour before close, rain, fireworks and parade time, Lightning Lane, where to sit, shortcuts and hacks, secrets, comfort, photo and viewing spots, what to order, or patterns SupaPark measured from its own wait history. Each tip names the ride or restaurant it is about. Gold sees every tip, including Gold-only measured secrets. For one ride or restaurant use get_ride_details_gold / get_restaurant_details_gold.

• park (required): string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Park.
• topic: string; one of all, rope_drop, last_hour, rain, fireworks_and_parades, lightning_lane, timing, where_to_sit, shortcuts_and_hacks, secrets, comfort, photo_and_viewing_spots, what_to_order, measured; default all — What the tips should be about.
• about: string; one of rides, restaurants, both; default both
• limit: integer; 1–50; default 15

Try: “Rope drop tips for Hollywood Studios?”

Ratings and reviews SupaPark holds for one Walt Disney World ride or restaurant. Rides: SupaPark's fact-checked editorial review (overview, is it worth it, tips). Restaurants: SupaPark's single 0-10 rating (estimated when there is no review average), the Google review average where on file, SupaPark's own take, signature dishes and who it suits. SupaPark does not publish guest reviews; editorial text is labeled as such.

• entity (required): string — Ride or restaurant slug or name, e.g. "space-mountain" or "Le Cellier".
• park: string; one of magic-kingdom, epcot, hollywood-studios, animal-kingdom — Optional: the park, to tell apart similar names.

Try: “Is Test Track worth it? What does the SupaPark review say?”

Lists the active ride and dining watches (alerts) on this SupaPark account, with each watch's id.

Try: “What am I watching on SupaPark right now?”

Creates an alert on this SupaPark account for a Walt Disney World ride. kind "lightning_lane": alert when Lightning Lane return times open up (optionally for a specific date). kind "wait_drop": alert when the standby wait drops to threshold_minutes or less. Delivery channel follows the account's plan.

• ride (required): string — Ride slug (e.g. "space-mountain") or name.
• kind (required): string; one of lightning_lane, wait_drop
• date: string (date) — lightning_lane only: YYYY-MM-DD. Omit for the next opening.
• threshold_minutes: integer; 5–240 — wait_drop only. Default 30.

Try: “Alert me when the Seven Dwarfs Mine Train wait drops under 30 minutes today.”

Creates an alert on this SupaPark account that fires when a reservation opens at a Walt Disney World restaurant for the given date and party size.

• restaurant (required): string — Restaurant slug (e.g. "be-our-guest-restaurant") or name.
• date (required): string (date) — Dining date, YYYY-MM-DD (within 180 days).
• party_size (required): integer; 1–12

Try: “Watch Space 220 for a table for 4 on June 2.”

Turns off one watch on this SupaPark account, by watch id. It can be restored in the SupaPark app.

• id (required): string — Watch id (UUID).

Try: “Stop watching Space 220.”

Every active or paused watch on this SupaPark account with its status and history: when it last fired, how many alerts it sent in the last 30 days, and the latest alert message (e.g. the reservation time or return time it found). Pass id for one watch. Use for "did my Be Our Guest watch find anything", "which of my alerts are paused".

• id: string — Optional watch id (from list_my_watches or this tool).
• include_paused: boolean; default true

Try: “Did my Be Our Guest watch find anything?”

Changes one watch on this SupaPark account: pause or resume it, move a Lightning Lane or dining watch to another date (null puts a Lightning Lane watch back to "next opening"), change a wait-drop threshold, or a dining party size. Same rules as the SupaPark app. Confirm the change with the member first.

• id (required): string — Watch id (from get_my_watch_status or list_my_watches).
• paused: boolean — true pauses (no alerts), false resumes.
• date: string | null (date) — New date, YYYY-MM-DD within 180 days; null = next opening (Lightning Lane only).
• threshold_minutes: integer; 5–240 — Wait-drop watches: alert at or below this many minutes.
• party_size: integer; 1–10 — Dining watches only.

Try: “Move my Space 220 watch to June 3 and make it a party of 5.”

This SupaPark account's area alert switches (lightning nearby, severe weather, police & safety notices, breaking park news, I-4 traffic), which are on, how they are delivered (push, email or the in-app feed), whether they only run on trip days, and quiet hours. Use before turning alerts on or off with set_area_alerts.

Try: “Which SupaPark area alerts do I have on?”

Turns this SupaPark account's area alerts on or off: lightning (nearby lightning that pauses outdoor rides, and the all-clear), severe_weather (National Weather Service warnings), safety_incidents (major police or emergency activity near the resort), breaking_news (big park closures and announcements), traffic (I-4 crashes on trip days). Only categories SupaPark currently runs can change; the result says which changed, which already were, and which are unavailable. Confirm with the member first.

• on: array — Categories to turn on.
• off: array — Categories to turn off.

Try: “Turn on lightning alerts for my trip.”

Shows whether this assistant is linked to a SupaPark account, the plan (free, silver or gold) and how alerts are delivered.

Try: “What plan am I on, and where do my SupaPark alerts go?”

Alerts that fired on this SupaPark account in the last few days (Lightning Lane openings, wait drops, dining reservations): when each fired, its message, and the watch it came from.

• days: integer; 1–30; default 7 — How many days back to look.

Try: “Which SupaPark alerts fired for me in the last three days?”

The Walt Disney World trip saved on this SupaPark account: arrival and last day, whether the party stays on site, and any saved park-by-day plan.

Try: “What trip dates do I have saved in SupaPark?”

Saves the trip dates on this SupaPark account (the same trip the app shows). start_date is the arrival day, end_date the last park day; null clears a date. on_site is whether the party stays at a Disney resort hotel.

• start_date: string | null (date) — Arrival, YYYY-MM-DD; null clears it.
• end_date: string | null (date) — Last park day, YYYY-MM-DD; null clears it.
• on_site: boolean — Staying at a Disney resort hotel.

Try: “Set my SupaPark trip to May 4 through May 9, staying on site.”

The family members saved on this SupaPark account (names and heights, used for ride height checks) and the trip party size if one is saved. Pair with search_rides rider_height_in (the shortest member's height) to list rides everyone can ride.

Try: “Which rides can everyone in my party ride?”