# tickadoo MCP Server

Discover and book 13,090+ theatre, tour, attraction, and event experiences across 681 cities with 14 AI-powered tools. No API key required.

Version: 1.4.1
Canonical URL: https://mcp.tickadoo.com
MCP endpoint: https://mcp.tickadoo.com/mcp
Transport: Streamable HTTP (stateless)
Access: No API key required
Tool behavior: Read-only discovery and booking-assist workflows
Tool count: 14
Capabilities: search, booking, recommendations, itinerary-planning, comparison, mood-search

## Brand
- tickadoo is always lowercase — never capitalise as Tickadoo or TICKADOO
- Use tickadoo® on first mention, then tickadoo thereafter
- Tagline: What Do You Wanna Doo?®

## Languages
tickadoo supports 40+ languages. Pass a language code to get localised booking URLs:
en, fr, de, es, it, pt, pl, cs, nl, da, sv, no, zh, ja, hi, ar, tr, ko, he, fi,
ru, el, hu, th, vi, uk, es-mx, pt-br, ur, bn, fa, tl, ms, ca, is, id, ta, pa-in,
gu, zh-hant-hk, yue, bg, ro, hr

When a user is chatting in a non-English language, use the matching language code
to generate booking URLs in their language.

## Valid Categories
The following category values are accepted by search_experiences:
theatre, musicals, tours, food, family, nightlife, sightseeing, concerts,
comedy, shows, outdoor, workshops, cruises, sports

Note: Category matching is fuzzy — 'musical' matches 'musicals',
'tour' matches 'tours'. If unsure, use the free-text query parameter instead.

## Valid Moods
The following mood values are accepted by search_by_mood:
adventurous, romantic, relaxing, family_fun, cultural, thrill_seeking, foodie, budget_friendly, luxury, rainy_day

Mood search maps emotional intent to audience, tag, setting, rating, and price filters before searching.

## Data Freshness & Cache Policy
- Capability files (llms.txt, llms-full.txt) should be cached for 5 minutes
- MCP tool responses are real-time — do not cache search results
- Product detail responses can be cached for up to 60 seconds
- Pricing: updated daily from tickadoo product feed
- Availability: based on daily-refreshed inventory with urgency signals (inventoryLevel) — link to booking page for final seat selection and payment
- Ratings: aggregated, may lag behind live reviews
- City coverage: updated with each server release
- Results are cached for up to 5 minutes on the server

## Limitations
- Booking handoff: the server provides discovery, recommendations, and direct booking deep links with ReserveAction — final payment is completed on tickadoo.com
- Inventory freshness: availability is refreshed daily with inventoryLevel urgency signals — users confirm final seat selection on the booking page
- Not all experiences have duration, accessibility, audience suitability, or indoor/outdoor data
- Prices shown are 'from' prices — final price may vary by date, party size, or variant
- Indoor/outdoor classification and audience/accessibility data is available for all experiences but may contain inaccuracies from automated classification
- Reviews and ratings may not be available for newer listings

## Tools
- search_experiences: Search 13,090+ experiences across 681 cities with 11 filters and 6 sort options. JSON responses include _available_filters, _conversation_starters, _related_searches, and booking-ready result metadata.
- search_by_mood: Search experiences by emotional intent instead of category. Maps moods like romantic, relaxing, foodie, or rainy_day to optimized audience, tag, setting, rating, and price filters before searching.
- get_last_minute: Find experiences starting within the next few hours, sorted by soonest start time. Results include countdown text like starts in 47 minutes plus urgency signals when the start is imminent or inventory is low.
- find_nearby_experiences: Find experiences near coordinates with configurable radius, optional date filtering, the same enrichment filters as city search, and localised booking URLs.
- list_cities: List tickadoo cities with bookable inventory, sorted alphabetically with optional query filtering, limits, and localised city URLs.
- check_availability: Fast date-specific availability check for one experience. Returns available slots, party-size-aware totals, a booking URL, and Ghost Checkout payload metadata.
- get_experience_details: Fetch venue, imagery, availability slots, Google Maps place IDs, booking urgency, accessibility data, and booking-ready links for a specific experience.
- compare_experiences: Compare 2-5 experiences side-by-side. JSON includes comparison rows, winner callouts (best_value, highest_rated, most_popular, best_for_families), key differences, and per-slug booking URLs.
- whats_on_tonight: Find experiences happening tonight in a city with start-time-aware ranking, venue context, and urgency signals for last-minute discovery.
- get_whats_on_this_week: Build a 7-day city planner with a day-by-day breakdown of top experiences grouped into morning, afternoon, and evening, plus weekly highlight callouts.
- get_city_guide: Return a curated city overview for trip planning with top 5 highlights, category counts, price range, best_for suggestions, seasonal advice, insider tips, top tags, and audience breakdown.
- get_travel_tips: Return local insider advice for 20 launch cities, including transport, money, safety, culture, food, weather, language, connectivity, emergency numbers, and quick local phrases.
- get_family_day: Build a family day with a morning activity, lunch tip, afternoon attraction, and optional evening stop using age-aware filtering. Under 3 triggers wheelchair-accessible filtering, and the planner clusters picks geographically to reduce travel.
- get_transfer_info: Estimate airport, station, or port transfers from a city's default arrival hub to hotel coordinates. Returns taxi, tube/metro, bus, and train options with duration, estimated cost, currency, and practical directions.

## Resource
- tickadoo://product-feed: https://content.tickadoo.com/openai/ProductFeed.jsonl.gz

## Connection
Claude Desktop / remote MCP:
{
  "mcpServers": {
    "tickadoo": {
      "url": "https://mcp.tickadoo.com/mcp"
    }
  }
}

Claude Desktop / stdio via npx:
{
  "mcpServers": {
    "tickadoo": {
      "command": "npx",
      "args": ["-y", "@tickadoo/mcp-server"]
    }
  }
}

Remote HTTP:
- POST https://mcp.tickadoo.com/mcp
- Accept: application/json, text/event-stream

## More
- Detailed tool schemas: https://mcp.tickadoo.com/llms-full.txt
- tickadoo company profile: https://www.tickadoo.com/llms.txt