{"tools":[{"name":"search_experiences","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return ranked, currently on-sale catalogue candidates for a city, optional title query, category, tags, rating, review-count, and price filters. Each result includes an opaque product_id for provider-neutral follow-up calls and a public slug for comparison. Confirm a selected date with get_availability before claiming it is available.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug, e.g., \"london\", \"new-york\", \"paris\"."},"query":{"type":"string","description":"Free-text query matched against experience name and venue (not description). Split into words that must all match, so it suits a title or keyword; a query that matches no name returns city top-picks flagged match_type \"fallback_city_ranked\"."},"category":{"type":"string","description":"Category slug, e.g., \"theatre\", \"tours\", \"museums\", \"attractions\"."},"tags":{"type":"array","items":{"type":"string"},"description":"Filter by experience tags. Multiple tags are AND-combined (every tag must match) so adding more tags narrows the result set. Use lowercase singular forms; matching is substring-based against the tag array. The canonical tag taxonomy in the catalogue, ordered by frequency, is: 'tour', 'attraction', 'historical', 'outdoor', 'museum', 'family', 'landmark', 'adventure', 'show', 'indoor', 'food & drink', 'transport', 'theatre', 'concert', 'theme park', 'cruise', 'nightlife', 'comedy', 'musical', 'city pass', 'sport', 'dance', 'aquarium', 'zoo', 'gallery', 'opera', 'wellness', 'water park', 'workshop', 'religious', 'festival'. Examples: ['museum'] for museums; ['family','indoor'] for indoor family attractions; ['outdoor','adventure'] for outdoor adventure activities. Other free-form values may match by substring but are not guaranteed."},"indoor_outdoor":{"type":"string","enum":["indoor","outdoor","either"],"description":"Optional setting filter. 'indoor' and 'outdoor' resolve through catalogue tags; 'either' applies no setting filter."},"min_review_count":{"type":"integer","minimum":0,"description":"Minimum number of customer reviews. Use to filter out new or sparsely-reviewed products."},"min_rating":{"type":"number","minimum":0,"maximum":5,"description":"Minimum aggregate rating on a 0-5 scale."},"restrict_to_top_rated":{"type":"boolean","description":"HARD RESULT FILTER. When true, restricts results to products with rating >= 4.5 AND review_count >= 100. This is a WHERE clause, not a sort hint. Anything failing the floor is dropped from the result set entirely. Use only when the caller genuinely wants to exclude lower-rated or lesser-reviewed products. For ranking-by-popularity without exclusion, do not set this; results are already ordered by rating and review count."},"popular_only":{"type":"boolean","description":"DEPRECATED: use restrict_to_top_rated. Alias for the hard top-rated result filter (rating >= 4.5 AND review_count >= 100). The name implies a sort hint but it is a hard WHERE clause. Existing callers continue to work unchanged.","deprecated":true},"max_price":{"type":"number","minimum":0,"description":"Maximum price per person in the listed currency. A positive value applies a cap; 0 (or unset) means no price cap (unbounded)."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Number of results to return (1-50). Default 10."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"additionalProperties":false},"annotations":{"title":"Search experiences","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"search_local_experiences","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search_local/1.0","description":"Use this when the user mentions a place, neighbourhood, landmark, or area but does not give exact coordinates. Examples: 'near the Louvre', 'in Trastevere', 'around Times Square', \"walking distance from St Paul's Cathedral\". Returns experiences matched first by exact venue/neighbourhood, then by city centre fallback. Do not use for general city-wide search; use search_experiences for that.","inputSchema":{"type":"object","properties":{"place_hint":{"type":"string","description":"Free-text place reference: a landmark, neighbourhood, monument, station, or street name. E.g. 'Louvre Museum', 'Trastevere', 'Soho', 'Times Square'. Required."},"city":{"type":"string","description":"City slug or name to disambiguate. Recommended for any place_hint that could exist in multiple cities."},"neighbourhood":{"type":"string","description":"Optional: a known neighbourhood within the city to narrow results."},"radius_hint":{"type":"string","enum":["walking","short_drive","city_wide"],"description":"Optional: how broadly to interpret the place_hint. 'walking' is ~1km, 'short_drive' is ~5km, 'city_wide' falls back to the whole city. Default 'walking'."},"tags":{"type":"array","items":{"type":"string"},"description":"Filter by experience tags. Multiple tags are AND-combined (every tag must match) so adding more tags narrows the result set. Use lowercase singular forms; matching is substring-based against the tag array. The canonical tag taxonomy in the catalogue, ordered by frequency, is: 'tour', 'attraction', 'historical', 'outdoor', 'museum', 'family', 'landmark', 'adventure', 'show', 'indoor', 'food & drink', 'transport', 'theatre', 'concert', 'theme park', 'cruise', 'nightlife', 'comedy', 'musical', 'city pass', 'sport', 'dance', 'aquarium', 'zoo', 'gallery', 'opera', 'wellness', 'water park', 'workshop', 'religious', 'festival'. Examples: ['museum'] for museums; ['family','indoor'] for indoor family attractions; ['outdoor','adventure'] for outdoor adventure activities. Other free-form values may match by substring but are not guaranteed."},"date_from":{"type":"string","format":"date","description":"Optional YYYY-MM-DD accepted for compatibility. This search does not apply a date window; use get_availability to check live dates for a selected product."},"date_to":{"type":"string","format":"date","description":"Optional YYYY-MM-DD accepted for compatibility. This search does not apply a date window; use get_availability to check live dates for a selected product."},"limit":{"type":"integer","minimum":1,"maximum":50,"default":10,"description":"Number of results to return (1-50). Default 10."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["place_hint"],"additionalProperties":false},"annotations":{"title":"Search local experiences","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"whats_on_tonight","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return evening-appropriate experience candidates for a city. A start_time appears only when the live calendar confirms one; use get_availability before claiming a specific time is available.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"category":{"type":"string","description":"Optional category slug to narrow results."},"max_results":{"type":"integer","minimum":1,"maximum":30,"default":10,"description":"Default 10, max 30."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"What is on tonight","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_last_minute","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return ranked, currently-on-sale experience candidates for the requested city and time window. Confirm a selected candidate with get_availability before claiming a specific time is available.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"hours":{"type":"integer","minimum":1,"maximum":12,"default":3,"description":"How many hours ahead to look (1-12). Default 3."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"Last minute","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_whats_on_this_week","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Use this when the user wants ideas for the coming week in a city. Returns a ranked list of currently on-sale experiences (search rows) with out-of-season products dropped, not a day-by-day calendar. Assemble any weekly structure yourself and verify specific dates with get_availability.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"This week","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"recommend_experiences","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return ranked experience candidates from a natural-language preference and optional city, price, result-count, and language inputs.","inputSchema":{"type":"object","properties":{"query":{"type":"string","description":"Natural-language preference, e.g., \"romantic evening in Paris under 100 euros\" or \"rainy day in Edinburgh with kids 8 and 12\"."},"city":{"type":"string","description":"Optional city slug. If omitted, the city is parsed from the query."},"limit":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Number of recommendations to return (1-20). Default 5."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["query"],"additionalProperties":false},"annotations":{"title":"Recommend experiences","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_city_highlights","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return a ranked overview of currently on-sale catalogue candidates for a city, including public prices and ratings. Confirm a selected date with get_availability before claiming it is available.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"City highlights","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"search_experiences_by_topic","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return ranked experience candidates for a city. This tool does not generate prose travel advice or apply a topic filter.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"City experience search","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"compare_experiences","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_compare/1.0","description":"Compare 2-5 selected experiences from one or more cities. Pass every value as city_slug/product_slug using the city and slug returned by an earlier public-agent result; each product_slug component must be distinct.","inputSchema":{"type":"object","properties":{"slugs":{"type":"array","minItems":2,"maxItems":5,"items":{"type":"string","pattern":"^[a-z0-9][a-z0-9-]{0,254}/[a-z0-9][a-z0-9-]{0,254}$","maxLength":511},"description":"City-scoped public paths in city_slug/product_slug form from earlier results. Each product_slug component must be distinct.","uniqueItems":true},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["slugs"],"additionalProperties":false},"annotations":{"title":"Compare experiences","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"comparison":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","maxLength":512},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":512},"duration":{"type":["string","null"],"maxLength":256},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"audience":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":256}},"wheelchair_accessible":{"type":["boolean","null"]}},"required":["slug"]}},"winner":{"type":"object","additionalProperties":false,"properties":{"best_value":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"highest_rated":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"most_popular":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"best_for_families":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["best_value","highest_rated","most_popular","best_for_families"]},"differences":{"type":"array","maxItems":0,"items":{"type":"string","maxLength":512}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"comparison":{"type":"array","maxItems":5,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","maxLength":512},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":512},"duration":{"type":["string","null"],"maxLength":256},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"audience":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":256}},"wheelchair_accessible":{"type":["boolean","null"]}},"required":["slug"]}},"winner":{"type":"object","additionalProperties":false,"properties":{"best_value":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"highest_rated":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"most_popular":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"best_for_families":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["best_value","highest_rated","most_popular","best_for_families"]},"differences":{"type":"array","maxItems":0,"items":{"type":"string","maxLength":512}}},"required":["comparison","winner","differences"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_hidden_gems","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Use this when the user wants lower-profile options rather than headline bestsellers. Excludes Bestseller, hop-on-hop-off, and CityPass tagged products and prefers highly rated rows with fewer reviews; falls back to the standard ranked list when a city has too few qualifying rows (results may then overlap with headline search).","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"max_results":{"type":"integer","minimum":1,"maximum":20,"default":5,"description":"Default 5, max 20."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"Hidden gems","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_family_day","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return ranked, in-season family-oriented experience candidates for a city. Arrange the day and verify selected dates separately.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"date":{"type":"string","description":"Optional ISO date (YYYY-MM-DD)."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"Family day","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_date_night","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return ranked, in-season date-night experience candidates for a city. Arrange the evening and verify selected dates separately.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"date":{"type":"string","description":"Optional ISO date (YYYY-MM-DD)."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city"],"additionalProperties":false},"annotations":{"title":"Date night","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_itinerary_candidates","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_search/1.0","description":"Return flat, ranked experience candidates for the requested city and number of days. The calling agent must arrange sequencing and verify dates.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City slug."},"days":{"type":"integer","minimum":1,"maximum":7,"description":"Number of days to plan (1-7)."},"audience":{"type":"string","enum":["family","couple","solo","group","business"],"description":"Optional audience signal. The 'family' value resolves through the family catalogue tag; other values are best-effort and may be sparsely populated."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city","days"],"additionalProperties":false},"annotations":{"title":"Itinerary candidates","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"list_cities","schemaVersion":"https://mcp.tickadoo.com/schemas/list_cities/1.0","description":"Use this when the user wants to browse supported cities before searching. Returns city names, slugs, country codes, and product counts.","inputSchema":{"type":"object","properties":{"country":{"type":"string","description":"Optional country code or country name filter."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Maximum number of cities to return (1-50). Defaults to 50 when omitted."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"additionalProperties":false},"annotations":{"title":"List cities","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"cities":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"city":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"country":{"type":"string","maxLength":512},"country_code":{"type":"string","maxLength":2,"pattern":"^[A-Z]{2}$"},"product_count":{"type":"integer"}},"required":["city","slug","country","country_code","product_count"]}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"cities":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"city":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"country":{"type":"string","maxLength":512},"country_code":{"type":"string","maxLength":2,"pattern":"^[A-Z]{2}$"},"product_count":{"type":"integer"}},"required":["city","slug","country","country_code","product_count"]}}},"required":["cities"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_experience_details","schemaVersion":"https://mcp.tickadoo.com/schemas/experience_detail/1.0","description":"Return provider-neutral public product, location, price, rating, and image fields for one selected experience. Requires the opaque product_id from an earlier public-agent result.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Opaque product_id returned by this public-agent endpoint. Raw inventory IDs are rejected.","pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"additionalProperties":false,"required":["product_id"]},"annotations":{"title":"Experience details","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"product":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]},"products":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"product":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]},"products":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}}},"required":["product"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_show_guide","schemaVersion":"https://mcp.tickadoo.com/schemas/show_guide/1.0","description":"Use this when the user asks about a specific show: how long it is, age guidance, venue and address, typical curtain times and dark days, who it is good for, and this week's performances. One rich guide record fusing live catalogue data with theatre expertise. Accepts slug or product_id.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Opaque product_id returned by this public-agent endpoint. Raw inventory IDs are rejected.","pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"slug":{"type":"string","description":"Product slug from a previous search result. Requires city_slug."},"city_slug":{"type":"string","description":"City slug, required when slug is used (slugs are only unique per city)."}},"additionalProperties":false},"annotations":{"title":"Show guide","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"city_slug":{"type":"string","maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"age_guidance":{"type":["string","null"],"maxLength":256},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"venue":{"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"],"maxLength":512},"slug":{"type":["string","null"],"maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"address":{"type":["string","null"],"maxLength":512}}},"house_patterns":{"type":["object","null"],"additionalProperties":false,"properties":{"dark_day":{"type":"string","maxLength":512},"curtain_evening":{"type":"string","maxLength":64},"curtain_matinee_wed_thu_sat":{"type":"string","maxLength":64},"curtain_matinee_sunday":{"type":"string","maxLength":64},"note":{"type":"string","maxLength":512}}},"good_for":{"type":"array","maxItems":16,"items":{"type":"string","maxLength":256}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"performances_this_week":{"type":"array","maxItems":14,"items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","maxLength":64},"time":{"type":["string","null"],"maxLength":64},"time_known":{"type":"boolean"}},"required":["date","time_known"]}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"city_slug":{"type":"string","maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"age_guidance":{"type":["string","null"],"maxLength":256},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"venue":{"type":"object","additionalProperties":false,"properties":{"name":{"type":["string","null"],"maxLength":512},"slug":{"type":["string","null"],"maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"address":{"type":["string","null"],"maxLength":512}}},"house_patterns":{"type":["object","null"],"additionalProperties":false,"properties":{"dark_day":{"type":"string","maxLength":512},"curtain_evening":{"type":"string","maxLength":64},"curtain_matinee_wed_thu_sat":{"type":"string","maxLength":64},"curtain_matinee_sunday":{"type":"string","maxLength":64},"note":{"type":"string","maxLength":512}}},"good_for":{"type":"array","maxItems":16,"items":{"type":"string","maxLength":256}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"performances_this_week":{"type":"array","maxItems":14,"items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","maxLength":64},"time":{"type":["string","null"],"maxLength":64},"time_known":{"type":"boolean"}},"required":["date","time_known"]}}},"required":["slug","name","city_slug"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_theatre_weekend","schemaVersion":"https://mcp.tickadoo.com/schemas/theatre_weekend/1.0","description":"Use this when the user asks what theatre is on this weekend or next. Server-side date math resolves the Friday/Saturday/Sunday dates; returns theatre shows in the city with scheduled performances on those days, grouped by day. Schedule data, not live seat inventory.","inputSchema":{"type":"object","properties":{"city_slug":{"type":"string","description":"City slug, e.g. london."},"city":{"type":"string","description":"City name, resolved to a slug."},"weekend":{"type":"string","enum":["this","next"],"description":"Which weekend. Defaults to this."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Max shows to return. Defaults to 20."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"additionalProperties":false},"annotations":{"title":"Theatre weekend","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"city_slug":{"type":"string","maxLength":512},"weekend":{"type":"string","enum":["this","next"]},"dates":{"type":"object","additionalProperties":false,"properties":{"friday":{"type":"string","maxLength":64},"saturday":{"type":"string","maxLength":64},"sunday":{"type":"string","maxLength":64}},"required":["friday","saturday","sunday"]},"total_shows":{"type":"integer","minimum":0},"shows":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"venue_name":{"type":["string","null"],"maxLength":512},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"performances":{"type":"object","additionalProperties":false,"properties":{"friday":{"type":"array","items":{"type":"string","maxLength":64}},"saturday":{"type":"array","items":{"type":"string","maxLength":64}},"sunday":{"type":"array","items":{"type":"string","maxLength":64}}},"required":["friday","saturday","sunday"]}},"required":["slug","name","performances"]}},"note":{"type":["string","null"],"maxLength":512},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"city_slug":{"type":"string","maxLength":512},"weekend":{"type":"string","enum":["this","next"]},"dates":{"type":"object","additionalProperties":false,"properties":{"friday":{"type":"string","maxLength":64},"saturday":{"type":"string","maxLength":64},"sunday":{"type":"string","maxLength":64}},"required":["friday","saturday","sunday"]},"total_shows":{"type":"integer","minimum":0},"shows":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"venue_name":{"type":["string","null"],"maxLength":512},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"performances":{"type":"object","additionalProperties":false,"properties":{"friday":{"type":"array","items":{"type":"string","maxLength":64}},"saturday":{"type":"array","items":{"type":"string","maxLength":64}},"sunday":{"type":"array","items":{"type":"string","maxLength":64}}},"required":["friday","saturday","sunday"]}},"required":["slug","name","performances"]}},"note":{"type":["string","null"],"maxLength":512}},"required":["city_slug","weekend","dates","total_shows","shows"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"ask_theatre_concierge","schemaVersion":"https://mcp.tickadoo.com/schemas/theatre_concierge/1.0","description":"Return a concise grounded answer plus provider-neutral theatre candidates for a free-text theatre question.","inputSchema":{"type":"object","properties":{"city_slug":{"type":"string","description":"City slug, e.g. london."},"city":{"type":"string","description":"City name, resolved to a slug."},"question":{"type":"string","description":"Free-text theatre question, max 500 chars."},"limit":{"type":"integer","minimum":1,"maximum":10,"description":"Max cited products. Defaults to 5."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"additionalProperties":false},"annotations":{"title":"Theatre concierge","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"city_slug":{"type":"string","maxLength":512},"question":{"type":"string","maxLength":512},"detected_intents":{"type":"object","additionalProperties":false,"properties":{"budget":{"type":"string","enum":["budget","luxury"]},"audience":{"type":"string","enum":["family","romantic","group"]},"timeframe":{"type":"string","enum":["today","weekend"]}}},"answer":{"type":"string","maxLength":512},"cited_products":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"venue_name":{"type":["string","null"],"maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"short_description":{"type":["string","null"],"maxLength":256}},"required":["slug","name"]}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"city_slug":{"type":"string","maxLength":512},"question":{"type":"string","maxLength":512},"detected_intents":{"type":"object","additionalProperties":false,"properties":{"budget":{"type":"string","enum":["budget","luxury"]},"audience":{"type":"string","enum":["family","romantic","group"]},"timeframe":{"type":"string","enum":["today","weekend"]}}},"answer":{"type":"string","maxLength":512},"cited_products":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"venue_name":{"type":["string","null"],"maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"short_description":{"type":["string","null"],"maxLength":256}},"required":["slug","name"]}}},"required":["city_slug","question","answer","cited_products"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"find_theatre_for_occasion","schemaVersion":"https://mcp.tickadoo.com/schemas/theatre_occasion/1.0","description":"Use this when the user has an occasion: family outing, date night, group celebration, solo culture trip, business entertainment. Returns ranked theatre shows with fit scores and reasons, honouring party ages and an optional date.","inputSchema":{"type":"object","properties":{"city_slug":{"type":"string","description":"City slug, e.g. london."},"city":{"type":"string","description":"City name, resolved to a slug."},"occasion":{"type":"string","enum":["family_outing","date_night","group_celebration","solo_culture","business_entertainment"]},"date":{"type":"string","description":"ISO date or natural language like this Saturday."},"party":{"type":"object","properties":{"adults":{"type":"integer","minimum":1,"maximum":20},"children_ages":{"type":"array","items":{"type":"integer","minimum":0,"maximum":17}}},"additionalProperties":false},"limit":{"type":"integer","minimum":1,"maximum":25,"description":"Max shows. Defaults to 10."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"additionalProperties":false},"annotations":{"title":"Theatre for occasion","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"city_slug":{"type":"string","maxLength":512},"occasion":{"type":"string","maxLength":512},"date":{"type":["string","null"],"maxLength":512},"party":{"type":"object","additionalProperties":false,"properties":{"adults":{"type":["integer","null"]},"children_ages":{"type":"array","items":{"type":"integer"}},"age_band":{"type":["string","null"],"maxLength":512}}},"total_matches":{"type":"integer","minimum":0},"shows":{"type":"array","maxItems":25,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"venue_name":{"type":["string","null"],"maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"fit_score":{"type":"integer"},"fit_reasons":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":256}}},"required":["slug","name","fit_score","fit_reasons"]}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"city_slug":{"type":"string","maxLength":512},"occasion":{"type":"string","maxLength":512},"date":{"type":["string","null"],"maxLength":512},"party":{"type":"object","additionalProperties":false,"properties":{"adults":{"type":["integer","null"]},"children_ages":{"type":"array","items":{"type":"integer"}},"age_band":{"type":["string","null"],"maxLength":512}}},"total_matches":{"type":"integer","minimum":0},"shows":{"type":"array","maxItems":25,"items":{"type":"object","additionalProperties":false,"properties":{"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"name":{"type":"string","maxLength":512},"venue_name":{"type":["string","null"],"maxLength":512},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"price_from":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":64},"fit_score":{"type":"integer"},"fit_reasons":{"type":"array","maxItems":10,"items":{"type":"string","maxLength":256}}},"required":["slug","name","fit_score","fit_reasons"]}}},"required":["city_slug","occasion","total_matches","shows"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_related_experiences","schemaVersion":"https://mcp.tickadoo.com/schemas/related_experiences/1.0","description":"Return provider-neutral related experience candidates for one opaque product_id, without supplier provenance or precise coordinates.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Opaque product_id returned by this public-agent endpoint. Raw inventory IDs are rejected.","pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"context":{"type":"string","enum":["pair","after","nearby","similar"],"default":"pair","description":"Relationship type: pair, after, nearby, or similar."},"max_results":{"type":"integer","minimum":1,"maximum":10,"default":6,"description":"Number of related products to return. Default 6, max 10."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["product_id"],"additionalProperties":false},"annotations":{"title":"Related experiences","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"source_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"context":{"type":"string","maxLength":512},"related":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","maxLength":512},"name":{"type":"string","maxLength":512},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"price":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":512},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"city_slug":{"type":["string","null"],"maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["product_id","slug","title","name"]}},"total":{"type":"integer"},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"source_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"context":{"type":"string","maxLength":512},"related":{"type":"array","maxItems":10,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"title":{"type":"string","maxLength":512},"name":{"type":"string","maxLength":512},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"price":{"type":["number","null"]},"currency":{"type":["string","null"],"maxLength":512},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"city_slug":{"type":["string","null"],"maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"}},"required":["product_id","slug","title","name"]}},"total":{"type":"integer"}},"required":["source_id","related","total"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"get_availability","schemaVersion":"https://mcp.tickadoo.com/schemas/availability/1.0","description":"Return live public dates, times, prices, and remaining-space hints for one selected experience. Accepts an opaque product_id or public slug plus city_slug. Slot price.amount is in minor currency units (pence/cents): amount 13125 with currency_code GBP means GBP 131.25.","inputSchema":{"type":"object","properties":{"product_id":{"type":"string","description":"Opaque product_id returned by this public-agent endpoint. Raw inventory IDs are rejected.","pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"slug":{"type":"string","description":"Product slug. Use with city_slug when product_id is unavailable."},"city_slug":{"type":"string","description":"City slug required when slug is used."},"date_from":{"type":"string","description":"Start date as YYYY-MM-DD, or a natural-language phrase the server resolves: today, tomorrow, this Saturday, next Friday, this weekend, next weekend. Defaults to today."},"date_to":{"type":"string","description":"End date as YYYY-MM-DD or a natural-language phrase (same as date_from). Defaults to 14 days after date_from and is capped to a 365-day window."},"party_size":{"type":"integer","minimum":1,"default":2,"description":"Number of guests. Default 2."},"preferred_time":{"type":"string","description":"Optional broad time preference such as morning, afternoon, or evening."},"as_of":{"type":"string","format":"date-time","description":"Previous ISO timestamp from an earlier availability response; returns a delta only when data changed."},"fresh":{"type":"boolean","default":false,"description":"When true, bypasses the 60-second cache and performs a live supplier check, subject to rate limits."}},"additionalProperties":false},"annotations":{"title":"Get availability","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"timezone":{"type":"string","maxLength":64},"slots":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","maxLength":64},"time":{"type":"string","maxLength":64},"datetime":{"type":"string","maxLength":64},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"integer"},"currency_code":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"spaces_remaining":{"type":["integer","null"]},"sold_out":{"type":"boolean"}}}},"total_slots":{"type":"integer"},"next_available":{"type":["string","null"],"maxLength":64},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"delta":{"type":"object","additionalProperties":false,"properties":{"flag":{"type":"string","maxLength":64},"changed_fields":{"type":"array","maxItems":3,"items":{"type":"string","maxLength":64}},"previous_as_of":{"type":"string","maxLength":64},"current_as_of":{"type":"string","maxLength":64}}},"applied_filters":{"type":"array","maxItems":1,"items":{"type":"string","maxLength":64}},"partial":{"type":"boolean"},"message":{"type":"string","maxLength":256},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"timezone":{"type":"string","maxLength":64},"slots":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":"string","maxLength":64},"time":{"type":"string","maxLength":64},"datetime":{"type":"string","maxLength":64},"price":{"type":"object","additionalProperties":false,"properties":{"amount":{"type":"integer"},"currency_code":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"spaces_remaining":{"type":["integer","null"]},"sold_out":{"type":"boolean"}}}},"total_slots":{"type":"integer"},"next_available":{"type":["string","null"],"maxLength":64},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"delta":{"type":"object","additionalProperties":false,"properties":{"flag":{"type":"string","maxLength":64},"changed_fields":{"type":"array","maxItems":3,"items":{"type":"string","maxLength":64}},"previous_as_of":{"type":"string","maxLength":64},"current_as_of":{"type":"string","maxLength":64}}},"applied_filters":{"type":"array","maxItems":1,"items":{"type":"string","maxLength":64}},"partial":{"type":"boolean"},"message":{"type":"string","maxLength":256}},"required":["product_id","slug","slots"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"check_availability","schemaVersion":"https://mcp.tickadoo.com/schemas/check_availability/1.0","description":"Check one selected experience on exactly one date. Pass slug as city_slug/product_slug using the city and slug returned by an earlier public-agent result.","inputSchema":{"type":"object","properties":{"slug":{"type":"string","description":"City-scoped public path in city_slug/product_slug form from an earlier result.","pattern":"^[a-z0-9][a-z0-9-]{0,254}/[a-z0-9][a-z0-9-]{0,254}$","maxLength":511},"date":{"type":"string","description":"Date to check as YYYY-MM-DD, or a natural-language phrase the server resolves: today, tomorrow, this Saturday, next Friday, this weekend, next weekend."},"party_size":{"type":"integer","minimum":1,"maximum":50,"default":2,"description":"Number of guests or tickets to price. Default 2."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["slug","date"],"additionalProperties":false},"annotations":{"title":"Check availability","readOnlyHint":true,"destructiveHint":false,"idempotentHint":false,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"available":{"type":"boolean"},"title":{"type":["string","null"],"maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"date":{"type":"string","maxLength":64},"slots":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":["string","null"],"maxLength":64},"time":{"type":["string","null"],"maxLength":64},"label":{"type":["string","null"],"maxLength":256},"price_per_person":{"type":"number"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"},"tickets_remaining":{"type":["integer","null"]},"availability_status":{"type":["string","null"],"maxLength":64}}}},"total_for_party":{"type":"object","additionalProperties":false,"properties":{"party_size":{"type":"integer"},"cheapest":{"type":["number","null"]},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"available":{"type":"boolean"},"title":{"type":["string","null"],"maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"date":{"type":"string","maxLength":64},"slots":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"date":{"type":["string","null"],"maxLength":64},"time":{"type":["string","null"],"maxLength":64},"label":{"type":["string","null"],"maxLength":256},"price_per_person":{"type":"number"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"},"tickets_remaining":{"type":["integer","null"]},"availability_status":{"type":["string","null"],"maxLength":64}}}},"total_for_party":{"type":"object","additionalProperties":false,"properties":{"party_size":{"type":"integer"},"cheapest":{"type":["number","null"]},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}}},"required":["available","slug","date","slots","total_for_party"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}},{"name":"search_by_mood","schemaVersion":"https://mcp.tickadoo.com/schemas/search_by_mood/1.0","description":"Use this when the user describes the feeling or vibe they want rather than a category, such as romantic, relaxing, adventurous, family fun, foodie, luxury, or rainy day. Maps the mood to preset search filters and returns matching experiences.","inputSchema":{"type":"object","properties":{"city":{"type":"string","description":"City name or slug, e.g. \"london\", \"new-york\", or \"paris\"."},"mood":{"type":"string","enum":["adventurous","romantic","relaxing","family_fun","cultural","thrill_seeking","foodie","budget_friendly","luxury","rainy_day"],"description":"Mood preset. Valid values: adventurous, romantic, relaxing, family_fun, cultural, thrill_seeking, foodie, budget_friendly, luxury, rainy_day."},"limit":{"type":"integer","minimum":1,"maximum":50,"description":"Maximum number of experiences to return (1-50). Defaults to the mood preset size when omitted."},"language":{"type":"string","description":"BCP-47 language code for human-readable fields (e.g., 'en', 'fr-FR'). Defaults to English when omitted."}},"required":["city","mood"],"additionalProperties":false},"annotations":{"title":"Search by mood","readOnlyHint":true,"destructiveHint":false,"idempotentHint":true,"openWorldHint":false},"outputSchema":{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}},"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"oneOf":[{"type":"object","additionalProperties":false,"properties":{"results":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"experiences":{"type":"array","maxItems":50,"items":{"type":"object","additionalProperties":false,"properties":{"product_id":{"type":"string","minLength":16,"maxLength":26,"pattern":"^t_[A-Za-z0-9_-]{14,24}$"},"name":{"type":"string","maxLength":512},"slug":{"type":"string","maxLength":255,"pattern":"^[a-z0-9]+(?:-[a-z0-9]+)*$"},"city":{"type":"string","maxLength":512},"category":{"type":"string","maxLength":64},"venue":{"type":"string","maxLength":512},"price":{"type":"object","additionalProperties":false,"properties":{"amount_minor":{"type":"integer"},"currency":{"type":"string","maxLength":3,"pattern":"^[A-Z]{3}$"}}},"rating":{"type":["number","null"]},"review_count":{"type":["integer","null"]},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"runtime":{"type":["string","null"],"maxLength":64},"audience":{"type":"array","maxItems":8,"items":{"type":"string","maxLength":256}},"inventoryLevel":{"oneOf":[{"type":"object","additionalProperties":false,"properties":{"level":{"type":"string","enum":["low","medium","high","sold_out","unknown"]}},"required":["level"]},{"type":"object","additionalProperties":false,"properties":{"@type":{"const":"QuantitativeValue"},"value":{"type":"number"},"unitCode":{"const":"C62"}},"required":["@type","value","unitCode"]}]},"image_url":{"type":["string","null"],"maxLength":2048,"pattern":"^https://cdn\\.tickadoo\\.com/"},"start_time":{"type":"string","maxLength":64},"countdown_text":{"type":"string","maxLength":256}},"required":["product_id","name","slug","category","tags"]}},"pagination":{"type":"object","additionalProperties":false,"properties":{"limit":{"type":"integer"},"offset":{"type":"integer"},"total":{"type":"integer"}}},"location_match":{"type":"object","additionalProperties":false,"properties":{"match_type":{"type":"string","maxLength":64},"matched_to":{"type":"string","maxLength":512},"fallback_used":{"type":"boolean"},"fallback_reason":{"type":"string","maxLength":512}}},"mood":{"type":"string","maxLength":512},"mapped_filters":{"type":"object","additionalProperties":false,"properties":{"audience":{"type":"string","maxLength":256},"tags":{"type":"array","maxItems":32,"items":{"type":"string","maxLength":64}},"setting":{"type":"string","maxLength":256},"physical_level":{"type":"string","maxLength":256},"max_price":{"type":"number"},"min_rating":{"type":"number"},"sort":{"type":"string","maxLength":512}}}},"required":["results"]},{"type":"object","additionalProperties":false,"properties":{"error_type":{"type":"string","enum":["ambiguous_input","invalid_input","rate_limited","supplier_unavailable","circuit_breaker_open","partial_result","unauthorized","forbidden","internal_error","not_found"]},"message":{"type":"string","maxLength":256},"retry_after_seconds":{"type":"integer","minimum":0,"maximum":86400}},"required":["error_type","message"]}]}}],"ttlMs":3600000,"cacheScope":"public","server":{"name":"com.tickadoo/mcp","version":"1.6.0","description":"Discover theatre, attractions, tours, and experiences worldwide. Returns structured results with stable product_id identifiers usable in follow-up calls."}}