find_multi_game_trips
Supported leagues are NFL, NBA, NHL, MLB, MLS, NCAAF and FIFA. For an explicitly unsupported league such as CFL, NLL, WNBA, F1 or UFC, explain the limit without making a tool call; do not substitute a supported league. Find 2–5 distinct games in one SportCation metro, checked within seven days. City is optional; omit city to search every supported metro. Use canonical city/team slugs when filtering. Search at most 31 inclusive dates within 180 days; trips span at most four local dates. Set max_trip_days=3 for a three-day trip, min_leagues=2 to require two sports, and limit at most 10. Empty results describe only these dates/filters. TBD trips are potential only. Includes SportCation ticket-and-hotel estimates in USD for two adults sharing one room, with explicit partial/unavailable status. No live quotes or best-value ranking. For requests for examples or whether trips exist, apply the named-team and league requirements and present about three suitable options once found, stating the searched dates. Do not scan the full 180 days by default or rescan solely because a result cap was reached. Refine when requirements remain unmet or the user requests broader coverage. Never claim exhaustive coverage from capped results or narrower follow-up filters. Empty truncated results are inconclusive. For weekend requests, flag Monday games as requiring an extra day; describe a holiday extension only when applicable.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"start_date": "<start_date>",
"end_date": "<end_date>"
},
"name": "find_multi_game_trips"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| city | No | ||
| limit | No | Return 1 to 10 trips. Use 5 for an initial shortlist; never request more than 10. | |
| teams | No | Canonical site team slugs; all requested teams must occur. CFB team filters cover configured site team pages. | |
| leagues | No | Allowed leagues. To require both requested sports also set min_leagues=2. | |
| end_date | Yes | ||
| max_games | No | ||
| min_games | No | ||
| start_date | Yes | ||
| min_leagues | No | Required distinct leagues; use 2 for an NFL and NHL trip. | |
| max_trip_days | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | ||
| trips | Yes | ||
| coverage | Yes | ||
| ordering | Yes | ||
| returned | Yes | ||
| truncated | Yes | ||
| provenance | Yes | ||
| limitations | Yes | ||
| generated_at | Yes | ||
| schema_version | Yes | ||
| excluded_records | Yes | ||
| candidates_examined | Yes | ||
| matching_usable_events | Yes |