CourtsApp is an MCP server published by io.github.courtsapp, hosted at api.courtsapp.com. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 11 tools, including search_courts, get_booking_link, get_facility_details, search_open_play, search_lessons.
Find pickleball, tennis and padel courts, open play, coaches and tournaments, and book on CourtsApp.
Nothing else in the archive shares these values.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
Inferred from the host name and headers: what a server runs on, not who runs it.
Use this when the user wants to find places to play racquet sports (pickleball, tennis, padel, badminton, racquetball, squash, table tennis) near a location, or wants to see open court times. Sport is what unlocks live open times. With a sport and a place to search around (city+state, zip code, lat+lng, or a facilityName) it returns live open times at nearby bookable clubs, followed by nearby connected and listed clubs without times (up to 10 of each). The card shows the first 8 clubs and its Map button shows all of them, so name the rest in text if the user wants more. The date is optional and defaults to today (the date where the clubs are, and if nothing more is open today the results move on to the next day), so "near me" or "now" needs no date. Time is optional: without it the tool returns the earliest open times (from now if the date is today, otherwise from 6am). Duration is optional and defaults to 60 minutes. Returns sportId (use for get_booking_link), facilities with available slots, and hint. Facilities may include perPlayerFeeDollars, perPlayerFeePolicy, and checkInPolicy when set — mention these to the user when present. Without a sport it lists nearby places to play instead, not live times, and the hint says to ask the user which sport. A state alone also lists places only (a state is too wide to search around), and the hint says to ask for a city or zip. Search by city+state, zip code, or lat+lng (nearest clubs within 50 miles), by state alone (listed by name), or look up one club with facilityName. Returns up to 50 bookable (including coming soon), 25 connected, and 25 listed facilities (10 of each for a state alone), bookable first, each with a photo, address, lat and lng (when known), sports, court count, and the CourtsApp page url (plus distance for radius searches). The result has mode: "times" (live open times) or "directory" (places to play, no times). To turn a place list into open times, ask the user for what the hint says (the sport, or a city or zip) and call this tool again. For connected facilities, send the user to bookingUrl. For listed facilities, send the user to website. Do not create a CourtsApp checkout for either. Facilities with comingSoon: true are joining CourtsApp but are not yet bookable.
| Parameter | Type | Description |
|---|---|---|
| date | string | Optional date to check live open times, as YYYY-MM-DD (e.g. "2026-01-22"). Defaults to today where the clubs are, so leave it out when the user named no day. Used with a sport. Pass the user's spoken date directly — no timezone conversion. |
| time | string | Optional start time as HH:MM in 24-hour format (e.g. "15:00" or "9:00"), used with a sport. Omit it when the user gave no time; results then start at the earliest open time that day (from now if today, otherwise from 6am). Pass the user's spoken time directly — no timezone conversion. |
| sport | string | Sport to look for. Pass it whenever the user names one: with a sport and a location the tool returns live open times; without one it only lists places to play (and the hint says to ask which sport). Case-insensitive. Common aliases accepted (e.g. "ping pong" → table-tennis, "paddle" → padel). |
| sortBy | string | Only used for live open times (with a sport). How to sort results. "distance" (default) returns closest facilities first. "price" returns cheapest facilities first. |
| duration | integer | Optional play duration in minutes, used with a sport: 30, 60, 90 or 120. Defaults to 60. |
| location | object | Where to search. Accepts city+state, city-only, state-only, zip, or lat+lng. City+state or zip are preferred for accuracy. City-only may return broader results. Never use 0,0 or guess coordinates. A state alone lists that state's clubs by name (places only, no live times): live times need a city, zi… |
| maxResults | integer | Only used for live open times (with a sport). Number of facilities with open times to return (1–10, default 3). Use more when the user wants to compare options. |
| facilityName | string | Name of a club to find. With a sport it shows that club's live open times (a location is optional, the club says where to look) by narrowing the nearby bookable clubs by name and, if the location search finds none, searching by name instead. Without a sport it returns the clubs whose name has every … |
{
"name": "search_courts",
"title": "Find Courts",
"description": "Use this when the user wants to find places to play racquet sports (pickleball, tennis, padel, badminton, racquetball, squash, table tennis) near a location, or wants to see open court times.\nSport is what unlocks live open times. With a sport and a place to search around (city+state, zip code, lat+lng, or a facilityName) it returns live open times at nearby bookable clubs, followed by nearby connected and listed clubs without times (up to 10 of each). The card shows the first 8 clubs and its Map button shows all of them, so name the rest in text if the user wants more. The date is optional and defaults to today (the date where the clubs are, and if nothing more is open today the results move on to the next day), so \"near me\" or \"now\" needs no date. Time is optional: without it the tool returns the earliest open times (from now if the date is today, otherwise from 6am). Duration is optional and defaults to 60 minutes. Returns sportId (use for get_booking_link), facilities with available slots, and hint. Facilities may include perPlayerFeeDollars, perPlayerFeePolicy, and checkInPolicy when set — mention these to the user when present.\nWithout a sport it lists nearby places to play instead, not live times, and the hint says to ask the user which sport. A state alone also lists places only (a state is too wide to search around), and the hint says to ask for a city or zip. Search by city+state, zip code, or lat+lng (nearest clubs within 50 miles), by state alone (listed by name), or look up one club with facilityName. Returns up to 50 bookable (including coming soon), 25 connected, and 25 listed facilities (10 of each for a state alone), bookable first, each with a photo, address, lat and lng (when known), sports, court count, and the CourtsApp page url (plus distance for radius searches).\nThe result has mode: \"times\" (live open times) or \"directory\" (places to play, no times). To turn a place list into open times, ask the user for what the hint says (the sport, or a city or zip) and call this tool again.\nFor connected facilities, send the user to bookingUrl. For listed facilities, send the user to website. Do not create a CourtsApp checkout for either. Facilities with comingSoon: true are joining CourtsApp but are not yet bookable.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Optional date to check live open times, as YYYY-MM-DD (e.g. \"2026-01-22\"). Defaults to today where the clubs are, so leave it out when the user named no day. Used with a sport.\nPass the user's spoken date directly — no timezone conversion."
},
"time": {
"type": "string",
"pattern": "^\\d{2}:\\d{2}$",
"description": "Optional start time as HH:MM in 24-hour format (e.g. \"15:00\" or \"9:00\"), used with a sport. Omit it when the user gave no time; results then start at the earliest open time that day (from now if today, otherwise from 6am).\nPass the user's spoken time directly — no timezone conversion."
},
"sport": {
"enum": [
"tennis",
"pickleball",
"padel",
"table-tennis",
"badminton",
"racquetball",
"squash"
],
"type": "string",
"description": "Sport to look for. Pass it whenever the user names one: with a sport and a location the tool returns live open times; without one it only lists places to play (and the hint says to ask which sport). Case-insensitive. Common aliases accepted (e.g. \"ping pong\" → table-tennis, \"paddle\" → padel)."
},
"sortBy": {
"enum": [
"distance",
"price"
],
"type": "string",
"description": "Only used for live open times (with a sport). How to sort results. \"distance\" (default) returns closest facilities first. \"price\" returns cheapest facilities first."
},
"duration": {
"enum": [
30,
60,
90,
120
],
"type": "integer",
"default": 60,
"description": "Optional play duration in minutes, used with a sport: 30, 60, 90 or 120. Defaults to 60."
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
}
},
"description": "Where to search. Accepts city+state, city-only, state-only, zip, or lat+lng. City+state or zip are preferred for accuracy. City-only may return broader results. Never use 0,0 or guess coordinates. A state alone lists that state's clubs by name (places only, no live times): live times need a city, zip, or lat+lng."
},
"maxResults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Only used for live open times (with a sport). Number of facilities with open times to return (1–10, default 3). Use more when the user wants to compare options."
},
"facilityName": {
"type": "string",
"maxLength": 100,
"description": "Name of a club to find. With a sport it shows that club's live open times (a location is optional, the club says where to look) by narrowing the nearby bookable clubs by name and, if the location search finds none, searching by name instead. Without a sport it returns the clubs whose name has every word, in any area (a city, zip or coordinates only put the nearest first)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"mode",
"facilities",
"hint"
],
"properties": {
"hint": {
"type": "string"
},
"mode": {
"enum": [
"directory",
"times"
],
"type": "string"
},
"sportId": {
"type": "string"
},
"facilities": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"city",
"state"
],
"properties": {
"id": {
"type": "string"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"slots": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"surface",
"startTime",
"date",
"duration",
"originalPrice",
"discountedPrice",
"url"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"date": {
"type": "string"
},
"surface": {
"type": "string"
},
"duration": {
"type": "number"
},
"startTime": {
"type": "string"
},
"environment": {
"enum": [
"Indoor",
"Outdoor"
],
"type": "string",
"description": "Indoor or Outdoor. Left out when CourtsApp does not say."
},
"originalPrice": {
"type": "number"
},
"discountedPrice": {
"type": "number"
}
},
"additionalProperties": false
}
},
"sport": {
"type": "string"
},
"state": {
"type": "string"
},
"sports": {
"type": "array",
"items": {
"type": "string"
}
},
"address": {
"type": "string"
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"type": "string"
},
"distance": {
"type": "number"
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sportSlug": {
"type": "string"
},
"bookingUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"comingSoon": {
"type": "boolean"
},
"courtCount": {
"type": "number"
},
"listingTier": {
"enum": [
"bookable",
"connected",
"listed"
],
"type": "string"
},
"paidListing": {
"type": "boolean"
},
"checkInPolicy": {
"type": "string"
},
"clickTrackUrl": {
"type": "string"
},
"perPlayerFeePolicy": {
"type": "string"
},
"perPlayerFeeDollars": {
"type": "number"
}
},
"additionalProperties": false
}
},
"fallbackReason": {
"type": "string"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Get a booking link for a court. Requires facilityId, date, time, sportId, and duration. Optional players (1–8, default 2) pre-fills the booking page and is used for per-player fee totals. Returns a URL to the booking page with pre-filled details and pricing info (court + player fees).
| Parameter | Type | Description |
|---|---|---|
| date | string | YYYY-MM-DD (from the slot the user picked) |
| time | string | HH:MM 24-hour (from the slot the user picked) |
| players | integer | Optional number of players (1–8). Defaults to 2. Required for accurate totals when the facility charges a per-player fee — ask the user before calling when perPlayerFeeDollars is set. |
| sportId * | string | Sport UUID from search_courts results |
| surface | string | Optional surface filter (e.g. "Hard", "Clay") |
| duration * | integer | Duration in minutes, e.g. 60 (from the slot the user picked) |
| facilityId * | string | Facility UUID from search_courts results |
{
"name": "get_booking_link",
"title": "Get Booking Link",
"description": "Get a booking link for a court.\nRequires facilityId, date, time, sportId, and duration.\nOptional players (1–8, default 2) pre-fills the booking page and is used for per-player fee totals.\nReturns a URL to the booking page with pre-filled details and pricing info (court + player fees).",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"facilityId",
"sportId",
"duration"
],
"properties": {
"date": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "YYYY-MM-DD (from the slot the user picked)"
},
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "HH:MM 24-hour (from the slot the user picked)"
},
"players": {
"type": "integer",
"default": 2,
"maximum": 8,
"minimum": 1,
"description": "Optional number of players (1–8). Defaults to 2. Required for accurate totals when the facility charges a per-player fee — ask the user before calling when perPlayerFeeDollars is set."
},
"sportId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Sport UUID from search_courts results"
},
"surface": {
"type": "string",
"description": "Optional surface filter (e.g. \"Hard\", \"Clay\")"
},
"duration": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Duration in minutes, e.g. 60 (from the slot the user picked)",
"exclusiveMinimum": 0
},
"facilityId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Facility UUID from search_courts results"
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"facilityName",
"facilityImage",
"sport",
"surface",
"date",
"time",
"duration",
"players",
"bookingUrl",
"address",
"subtotalCents",
"playerFeeCents",
"taxCents",
"totalCents"
],
"properties": {
"date": {
"type": "string"
},
"time": {
"type": "string"
},
"sport": {
"type": "string"
},
"address": {
"type": "string"
},
"players": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"surface": {
"type": "string"
},
"duration": {
"type": "string"
},
"taxCents": {
"type": "number"
},
"bookingUrl": {
"type": "string"
},
"totalCents": {
"type": "number"
},
"facilityName": {
"type": "string"
},
"facilityImage": {
"type": "string"
},
"subtotalCents": {
"type": "number"
},
"playerFeeCents": {
"type": "number"
},
"perPlayerFeeDollars": {
"type": "number"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Use this when the user asks about a specific facility: hours, address, phone number, amenities, policies, what sports it offers, or its courts. Looks the facility up in the CourtsApp database. Accepts partial name matches, city, state, or zip. facilityId is optional — use it only when you already have a real facility id from another CourtsApp tool; otherwise use name and location fields. At least one search field is required. Returns up to 5 matching facilities, bookable first, then connected, then listed, by name. Each includes: name, listingTier (bookable, connected, or listed), comingSoon status, description/about, seoDescription, timezone, full address, phone number, website, bookingUrl, hours of operation, amenities, booking/cancellation policies, per-player fees, check-in policy, available sports, indoorCourtCount, outdoorCourtCount, courtSurfaces, courtGroups (listed and connected: courts per sport, setting, and surface), bookable court details (name, environment, surface, sports), lat and lng (when known), photos (photoUrl is the first), and a link to the facility page. website and bookingUrl are https links, or null when the stored value is missing or not a normal web URL. Facilities with comingSoon: true are joining CourtsApp but not yet bookable. For connected facilities, send the user to bookingUrl. For listed facilities, send the user to website. Do not search availability or create a CourtsApp checkout for either. bookingPolicies.advanceBookingDays is the maximum advance booking window across all sports. When different sports have different windows, advanceBookingDaysBySport lists each sport and its window (e.g. Pickleball 7 days, Tennis 14 days). If a user asks about a date that one sport allows but another doesn't, explain which sport(s) can be booked that far out and which cannot. When bookingPolicies includes perPlayerFeeDollars or perPlayerFeePolicy, tell the user about the per-player fee — it affects total cost beyond the court rental price. When checkInPolicy is present, share it so the user knows what to expect on arrival.
| Parameter | Type | Description |
|---|---|---|
| zip | string | Zip/postal code (exact match) |
| city | string | City name (case-insensitive partial match). E.g. "Austin", "New York". |
Find open play (drop-in) sessions with spots left at CourtsApp facilities near a location, or at one facility. Use when the user wants to join a session with other players rather than reserve a whole court. Requires location (city+state or zip preferred), facilityName, or facilityId. When the user names a facility, pass it as facilityName right away — do not ask for the city first. date, time, sport, and level are optional filters; with no date it looks 7 days ahead. Returns facilities, each with up to 5 sessions: level, when (facility-local), price per player, spotsLeft, maxPlayers, and url. The url is the booking page for that session — share it once the user picks a session.
| Parameter | Type | Description |
|---|---|---|
| date | string | Optional facility-local date as YYYY-MM-DD. Omit to search the next 7 days. |
| time | string | Optional earliest start time of day as HH:MM 24-hour (e.g. "17:00" for evening sessions). Pass the user's spoken time directly — no timezone conversion. |
| level | string | Optional skill level: Beginner, Advanced beginner, Intermediate, Advanced intermediate, Advanced, Expert, or Professional. Omit when the user has not said, or says any level. |
| sport | string | Optional sport filter (e.g. "pickleball"). Omit to include every sport. |
| location | object | Where to search (50-mile radius). With facilityName or facilityId there is no radius and location only sorts by distance. Accepts city+state, city-only, state-only, zip, or lat+lng. City+state or zip are preferred. Never use 0,0 or guess coordinates. |
| facilityId | string | Optional facility UUID from another CourtsApp tool, to list one facility's sessions. Never invent one. |
Use this when the user wants a coach or private lessons for pickleball or tennis near a location. Not for court availability (search_courts) or open play (search_open_play). Read-only: it finds TeachMe.To coaches within 25 miles who have an open lesson time in the next two weeks (times start 18 hours out, since coaches need that much notice), and does not book anything. Next, get_lesson_times shows a coach's open times, and each time has a checkoutUrl: TeachMe.To's checkout with the coach, place and time already filled in, where the user pays on TeachMe.To. Requires sport and a location (city+state, zip, or lat+lng). A state alone is too broad, so ask for a city or zip code. maxResults is 1-6 (default 3). Returns coaches, each with listingId and locationId (pass both to get_lesson_times), name, rating, reviewCount, a short headline, distanceMiles, city, singleLessonPrice (one lesson, all fees included; null when not listed, never guess it), startingPrice (the per-lesson rate when buying a 10-lesson pack, so say "from $X per lesson") and nextOpen (the soonest open time in the coach's local time, with its slotKey and checkoutUrl: share that link exactly as returned to book it; the player needs to give no contact details). Each coach also has locations (where they teach near the search, nearest first, with distanceMiles) and teachmeUrl, their own TeachMe.To page, where the player chooses a location, date and time themselves.
| Parameter | Type | Description |
|---|---|---|
| sport * | string | Sport to find a coach for: pickleball or tennis. |
| location | object | Where to look (25-mile radius). City+state or zip are preferred. A state alone is too broad. Use lat+lng only if the user provided real coordinates. Never use 0,0 or guess coordinates. |
| maxResults | integer | Number of coaches to return (1-6, default 3). |
Use this when the user has picked a coach from search_lessons and wants to see when that coach is free for a private lesson. Not for court times (search_courts). Read-only: it shows the coach's open lesson times at one location and does not book anything. Pass the coach's listingId and the locationId from search_lessons (a coach who teaches at several places needs one). Optional: lessonLength in minutes (30, 60, 90 or 120; default the coach's usual length), startDate and endDate (YYYY-MM-DD, local days at the location; default the next 7 days, at most 14; times start 18 hours out, since coaches need that much notice), and earliestTime and latestTime (HH:MM, local) to narrow each day, for example evenings. Returns the coach (with teachmeUrl, their own TeachMe.To page, where the player chooses a location, date and time themselves), the location and the coach's other locations, the lesson length, prices (TeachMe.To quotes for one student, fees included: one lesson, and the 10-lesson pack where the coach sells one; the exact total comes back with the checkout link) and open times grouped by local day, each with a slotKey and a checkoutUrl (TeachMe.To's checkout for that time with the coach, place and time already filled in: to book, share it exactly as returned; no contact details are needed). Times are in the location's own time zone. Each day shows a spread of its times and openTimes says how many there are in all; at most 4 days are shown.
| Parameter | Type | Description |
|---|---|---|
| endDate | string | Last day to show, YYYY-MM-DD. Defaults to a week from the first day; at most 14 days in all. |
| listingId * | string | The coach's listingId from search_lessons. |
| startDate | string | First day to show, YYYY-MM-DD, a local day at the location. Defaults to today. |
| latestTime | string | Only times starting at or before this local time, HH:MM 24-hour. |
Optional: use this only when the user asks to have their own details filled in on the checkout for them. The default way to book needs no contact details: share the picked time's checkoutUrl from get_lesson_times exactly as returned. This tool prepares a TeachMe.To checkout for that lesson and returns a link where the user pays, with the coach, location, time and the student's details already filled in. It sends the student's full name, email address and phone number to TeachMe.To to prepare that checkout (they are what lets TeachMe.To fill them in), and creates their TeachMe.To account if the email is new. Ask the user for all three first, and use only what the user gave you. Nothing is charged by this tool, and CourtsApp takes no payment for lessons: the user pays on TeachMe.To, and the coach then accepts the time or suggests another, so it is a request, never a confirmed booking. Requires listingId, locationId and slotKey (from get_lesson_times, exactly as returned), lessonLength (minutes, the one used for the times), studentName, studentEmail and studentPhone. lessons is how many lessons to buy as a prepaid pack, 1-20 (default 1). Returns paymentUrl (share it exactly as returned), the coach, location and local time, and the quote: lessons, pricePerLesson, fees, total and currency.
| Parameter | Type | Description |
|---|---|---|
| lessons | integer | How many lessons to buy as a prepaid pack (1-20). Defaults to 1. The first lesson is at the time picked. |
| slotKey * | string | The slotKey of the time the user picked, copied exactly as returned. It cannot be edited. |
| listingId * | string | The coach's listingId from search_lessons or get_lesson_times. |
| locationId * | string | The locationId the time is at, from get_lesson_times. |
Use this when the user wants tournaments or leagues to play in, near a location or by name. Not for court availability (search_courts), open play (search_open_play) or coaching (search_lessons). Read-only: it searches CourtsApp's catalog of events and cannot register anyone. Each event has a registration url on the organizer's site: share it exactly as returned and let the user sign up there. Never say anyone is registered. Location is optional (city+state, zip, or lat+lng; a state alone lists that state's events). With a city or zip it returns events within 150 miles, soonest first, each with distanceMiles; if none are that close it says so and returns the 2 nearest, which are not near, so never call them nearby. Without a location it returns the soonest events anywhere. Use q or name for an event name (e.g. "Moneyball"), type to limit to tournaments or leagues, and from/to (YYYY-MM-DD) for dates; it starts from today by default. maxResults is 1-10 (default 6). Returns tournaments, each with name, eventType, venueName, city, state, startDate and endDate (calendar days), registrationCloseDate, closingSoon (registration closes within 5 days), priceMinCents and priceMaxCents with currency (cents; 0 means free), url, and distanceMiles; plus total and hint.
| Parameter | Type | Description |
|---|---|---|
| q | string | Optional event name or venue to look for, e.g. "Moneyball". |
| to | string | Optional last day to include, as YYYY-MM-DD: events starting on or before it are returned. Omit for no end date. |
| from | string | Optional first day to include, as YYYY-MM-DD: events still on or after it are returned. Defaults to today. |
| type | string | Optional: only tournaments, or only leagues. Leave it out for both. |
| sport | string | Optional sport to find events for. Pass it whenever the user names one. Case-insensitive. Common aliases accepted (e.g. "pickle ball" → pickleball). |
Lists every open court time at one bookable CourtsApp facility on one day, grouped by indoor or outdoor and surface, with per-hour prices and a booking link for each. The CourtsApp facility card calls this to show a club's times on its profile; it is not needed to find courts for a user, which search_courts does (it returns the first few times per club). Needs the facility's id (from search_courts or get_facility_details). The date is optional and defaults to today where the facility is (tomorrow when nothing is left today); sport defaults to the facility's first sport.
| Parameter | Type | Description |
|---|---|---|
| date | string | Day to list, YYYY-MM-DD. Defaults to today where the facility is. |
| sport | string | Sport slug or name, e.g. "pickleball" or "Table Tennis". Defaults to the facility's first sport. |
| facilityId * | string | The facility's id (a UUID), as returned by search_courts or get_facility_details. |
{
"name": "get_facility_times",
"title": "Get Facility Times",
"description": "Lists every open court time at one bookable CourtsApp facility on one day, grouped by indoor or outdoor and surface, with per-hour prices and a booking link for each. The CourtsApp facility card calls this to show a club's times on its profile; it is not needed to find courts for a user, which search_courts does (it returns the first few times per club). Needs the facility's id (from search_courts or get_facility_details). The date is optional and defaults to today where the facility is (tomorrow when nothing is left today); sport defaults to the facility's first sport.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"facilityId"
],
"properties": {
"date": {
"type": "string",
"format": "date",
"description": "Day to list, YYYY-MM-DD. Defaults to today where the facility is."
},
"sport": {
"type": "string",
"description": "Sport slug or name, e.g. \"pickleball\" or \"Table Tennis\". Defaults to the facility's first sport."
},
"facilityId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The facility's id (a UUID), as returned by search_courts or get_facility_details."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"facilityId",
"sport",
"sportName",
"date",
"rolledOver",
"groups"
],
"properties": {
"date": {
"type": "string",
"description": "The day listed, YYYY-MM-DD."
},
"sport": {
"type": "string",
"description": "Sport slug."
},
"groups": {
"type": "array",
"items": {
"type": "object",
"required": [
"setting",
"surface",
"slots"
],
"properties": {
"slots": {
"type": "array",
"items": {
"type": "object",
"required": [
"startTime",
"date",
"duration",
"originalPrice",
"discountedPrice",
"url"
],
"properties": {
"url": {
"type": "string",
"description": "The CourtsApp booking page for this time."
},
"date": {
"type": "string",
"description": "YYYY-MM-DD."
},
"duration": {
"type": "number",
"description": "Minutes."
},
"startTime": {
"type": "string",
"description": "Start time in the club's local time, HH:MM (24-hour)."
},
"originalPrice": {
"type": "number",
"description": "List price per hour, in cents."
},
"discountedPrice": {
"type": "number",
"description": "Price per hour after any discount, in cents."
}
},
"additionalProperties": false
}
},
"setting": {
"enum": [
"Indoor",
"Outdoor"
],
"type": "string"
},
"surface": {
"type": "string",
"description": "Short surface name, e.g. Hard."
}
},
"additionalProperties": false
}
},
"sportName": {
"type": "string"
},
"facilityId": {
"type": "string"
},
"rolledOver": {
"type": "boolean",
"description": "True when no date was given and nothing was left today, so this is tomorrow."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}Records that someone followed a link on a CourtsApp card, for CourtsApp's own click statistics. The CourtsApp cards call this when a link is opened; it is not needed to answer a user and does not need to be called. It keeps the kind of link, the club's id, the destination's host and path and its utm_* tags, and which assistant showed the card, and nothing about the person.
| Parameter | Type | Description |
|---|---|---|
| url * | string | The link that was opened (http or https). |
| kind * | string | What kind of link it was. |
| facilityId | string | The facility's id (a UUID), when the card knows it. |
{
"name": "record_click",
"title": "Record Click",
"description": "Records that someone followed a link on a CourtsApp card, for CourtsApp's own click statistics. The CourtsApp cards call this when a link is opened; it is not needed to answer a user and does not need to be called. It keeps the kind of link, the club's id, the destination's host and path and its utm_* tags, and which assistant showed the card, and nothing about the person.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"url",
"kind"
],
"properties": {
"url": {
"type": "string",
"maxLength": 2048,
"minLength": 8,
"description": "The link that was opened (http or https)."
},
"kind": {
"enum": [
"facility_page",
"slot",
"book",
"booking_link",
"club_site",
"open_play",
"tournament",
"lesson_checkout",
"lesson_page",
"directions",
"other"
],
"type": "string",
"description": "What kind of link it was."
},
"facilityId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The facility's id (a UUID), when the card knows it."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"ok"
],
"properties": {
"ok": {
"type": "boolean",
"description": "True when the click was recorded."
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": false,
"idempotentHint": false,
"destructiveHint": false
}
}The coach card calls this when someone opens a coach's profile. It is not needed to find a coach, which search_lessons does. Read-only: it returns the bio, the places, the lesson lengths and the cancellation policy. It does not return a price.
| Parameter | Type | Description |
|---|---|---|
| listingId * | string | The coach's listingId from search_lessons. |
{
"name": "get_coach_profile",
"title": "Coach Profile",
"description": "The coach card calls this when someone opens a coach's profile. It is not needed to find a coach, which search_lessons does. Read-only: it returns the bio, the places, the lesson lengths and the cancellation policy. It does not return a price.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listingId"
],
"properties": {
"listingId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The coach's listingId from search_lessons."
}
},
"additionalProperties": false
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listingId",
"name",
"photoUrl",
"headline",
"bio",
"rating",
"reviewCount",
"lessonCount",
"acceptingNewStudents",
"lessonLengths",
"cancellation",
"guarantee",
"locations"
],
"properties": {
"bio": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"headline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"guarantee": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"listingId": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"city"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"lessonCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"reviewCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"cancellation": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lessonLengths": {
"type": "array",
"items": {
"type": "integer"
}
},
"acceptingNewStudents": {
"type": "boolean"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}CourtsApp finds and books racquet sport courts (pickleball, tennis, padel, etc.) and spots in open play sessions. ## Links Share every link exactly as a tool returned it, query string included (it carries the booking details and where the visit came from). Do not shorten, clean or rebuild links. ## Facility questions When the user asks about a specific facility (hours, address, phone number, amenities, policies, what sports it offers, courts, etc.), use get_facility_details. It accepts partial name matches, city, state, or zip. facilityId is optional: pass it only when you have a real facility id from another CourtsApp tool; otherwise use name and city/state or zip. ## Time Handling Pass date and time as separate plain values — no timezone conversion needed. - date: YYYY-MM-DD (e.g. "2026-01-22") - time: HH:MM 24-hour (e.g. "15:00") Examples: - User says "3pm tomorrow" → date: "2026-01-23", time: "15:00" - User says "9am on Jan 22" → date: "2026-01-22", time: "09:00" - User says "noon" → time: "12:00" - User says "7:30pm" → time: "19:30" The server handles all timezone conversion internally. ## Listing tiers Facilities have listingTier: bookable, connected, or listed. - bookable: checkout through CourtsApp. comingSoon: true means they are joining but not taking CourtsApp bookings yet. - connected: host a CourtsApp page and send the user to the facility booking URL (bookingUrl). Never create a CourtsApp checkout for them. - listed: host a CourtsApp page and send the user to the facility website. Do not search availability or create a CourtsApp checkout. search_courts without a sport (or with only a state) lists bookable, connected, and listed clubs (places to play, no times). With a sport and a place to search around, the results are bookable clubs with open times first, then up to 10 nearby connected facilities (listingTier: connected, no times): offer them after the bookable ones and send the user to their bookingUrl; then up to 10 nearby listed facilities (listingTier: listed, no times). The card shows the first 8 clubs and its Map button shows all of them: name the rest in text if the user wants more. When a facility is coming soon: - Tell the user the facility is on CourtsApp but not bookable yet — it will be soon. - Do not search availability or generate a booking link for coming-soon facilities. - Offer to share any details you do have (location, sports, amenities) and suggest they check back soon. ## Workflow - User wants to find places to play, see open court times, or book in an area ("courts near me", "pickleball in Austin") → search_courts with the location (city+state, zip, or lat+lng) and the sport if they named one. Sport is what unlocks live open times: with a sport you get today's open times; without one you get places to play, not times, and the hint says to ask which sport. A state alone only lists places to play: ask for a city or zip to show times. - Date is optional and defaults to today: pass it only when the user named a day. Time is optional: if the user gave none, leave it out and the results start at the earliest open time (from now if today, otherwise from 6am); then ask whether they want a specific time. Duration defaults to 60 minutes when the user does not specify one. - User picks a time to book → get_booking_link with the facilityId, sportId, date, time, and duration from the results - After a place list, if the user wants times, ask which sport (if you do not have one) and a city or zip (if you only have a state), then call search_courts again. - User asks about a specific facility (hours, amenities, location, policies, courts, sports, etc.) → get_facility_details - User wants open play, drop-in, or to join a session/game with other players (not reserve a whole court) → if they named a facility, call search_open_play with facilityName right away; otherwise collect location (date, time, and level are optional) → search_open_play → ask user to pick a session → g
Names, descriptions and schemas were written by the server and are shown as data.
Pattern matches on what the server declares. They show what it says it can do, not what it does.
None yet. Changes appear after a server's second daily check.
| name | string | Facility name or partial name (case-insensitive). E.g. "Lifetime", "Central Park Tennis", "YMCA". |
| state | string | State name or abbreviation (case-insensitive). E.g. "Texas", "TX", "New York", "NY". |
| facilityId | string | Optional. Must be a valid UUID string (RFC 4122) when provided — used for exact lookup by id. Omit when searching by name, city, state, or zip instead. |
{
"name": "get_facility_details",
"title": "Get Facility Details",
"description": "Use this when the user asks about a specific facility: hours, address, phone number, amenities, policies, what sports it offers, or its courts. Looks the facility up in the CourtsApp database.\nAccepts partial name matches, city, state, or zip. facilityId is optional — use it only when you already have a real facility id from another CourtsApp tool; otherwise use name and location fields. At least one search field is required.\nReturns up to 5 matching facilities, bookable first, then connected, then listed, by name. Each includes: name, listingTier (bookable, connected, or listed), comingSoon status, description/about, seoDescription, timezone, full address, phone number, website, bookingUrl, hours of operation, amenities, booking/cancellation policies, per-player fees, check-in policy, available sports, indoorCourtCount, outdoorCourtCount, courtSurfaces, courtGroups (listed and connected: courts per sport, setting, and surface), bookable court details (name, environment, surface, sports), lat and lng (when known), photos (photoUrl is the first), and a link to the facility page. website and bookingUrl are https links, or null when the stored value is missing or not a normal web URL.\nFacilities with comingSoon: true are joining CourtsApp but not yet bookable. For connected facilities, send the user to bookingUrl. For listed facilities, send the user to website. Do not search availability or create a CourtsApp checkout for either.\nbookingPolicies.advanceBookingDays is the maximum advance booking window across all sports. When different sports have different windows, advanceBookingDaysBySport lists each sport and its window (e.g. Pickleball 7 days, Tennis 14 days). If a user asks about a date that one sport allows but another doesn't, explain which sport(s) can be booked that far out and which cannot.\nWhen bookingPolicies includes perPlayerFeeDollars or perPlayerFeePolicy, tell the user about the per-player fee — it affects total cost beyond the court rental price. When checkInPolicy is present, share it so the user knows what to expect on arrival.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"zip": {
"type": "string",
"description": "Zip/postal code (exact match)"
},
"city": {
"type": "string",
"description": "City name (case-insensitive partial match). E.g. \"Austin\", \"New York\"."
},
"name": {
"type": "string",
"maxLength": 100,
"description": "Facility name or partial name (case-insensitive). E.g. \"Lifetime\", \"Central Park Tennis\", \"YMCA\"."
},
"state": {
"type": "string",
"description": "State name or abbreviation (case-insensitive). E.g. \"Texas\", \"TX\", \"New York\", \"NY\"."
},
"facilityId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Optional. Must be a valid UUID string (RFC 4122) when provided — used for exact lookup by id. Omit when searching by name, city, state, or zip instead."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"facilities"
],
"properties": {
"facilities": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"comingSoon",
"listingTier",
"about",
"courtSurfaces",
"courtGroups",
"timezone",
"address",
"city",
"state",
"amenities",
"hoursOfOperation",
"bookingPolicies",
"sports",
"courts"
],
"properties": {
"id": {
"type": "string"
},
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"about": {
"type": "string"
},
"phone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"type": "string"
},
"courts": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"environment",
"sports"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"sports": {
"type": "array",
"items": {
"type": "string"
}
},
"surface": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"environment": {
"type": "string"
}
},
"additionalProperties": false
}
},
"photos": {
"type": "array",
"items": {
"type": "string"
}
},
"sports": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name"
],
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
}
},
"address": {
"type": "string"
},
"website": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"zipCode": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"timezone": {
"type": "string"
},
"amenities": {
"type": "array",
"items": {
"type": "string"
}
},
"bookingUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"comingSoon": {
"type": "boolean"
},
"courtGroups": {
"type": "array",
"items": {
"type": "object",
"required": [
"sportName",
"setting",
"surface",
"count"
],
"properties": {
"count": {
"type": "number"
},
"setting": {
"type": "string"
},
"surface": {
"type": "string"
},
"sportName": {
"type": "string"
}
},
"additionalProperties": false
}
},
"listingTier": {
"enum": [
"listed",
"connected",
"bookable"
],
"type": "string"
},
"courtSurfaces": {
"type": "array",
"items": {
"type": "string"
}
},
"seoDescription": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"bookingPolicies": {
"type": "object",
"required": [
"advanceBookingDays",
"hasGuestFee"
],
"properties": {
"hasGuestFee": {
"type": "boolean"
},
"checkInPolicy": {
"type": "string"
},
"advanceBookingDays": {
"type": "number"
},
"perPlayerFeePolicy": {
"type": "string"
},
"perPlayerFeeDollars": {
"type": "number"
},
"cancellationWindowHours": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"advanceBookingDaysBySport": {
"type": "array",
"items": {
"type": "object",
"required": [
"sport",
"days"
],
"properties": {
"days": {
"type": "number"
},
"sport": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"hoursOfOperation": {
"type": "array",
"items": {
"type": "object",
"properties": {
"day": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"open": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"close": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"indoorCourtCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"outdoorCourtCount": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}| maxResults | integer | Number of facilities to return (1–10, default 3). |
| facilityName | string | Facility name the user said (e.g. "Sportime Englewood"). Every word must appear in the name, in any order, so partial names work. Searched nationwide; add location to sort same-named clubs by distance. |
{
"name": "search_open_play",
"title": "Search Open Play Sessions",
"description": "Find open play (drop-in) sessions with spots left at CourtsApp facilities near a location, or at one facility. Use when the user wants to join a session with other players rather than reserve a whole court.\nRequires location (city+state or zip preferred), facilityName, or facilityId. When the user names a facility, pass it as facilityName right away — do not ask for the city first. date, time, sport, and level are optional filters; with no date it looks 7 days ahead.\nReturns facilities, each with up to 5 sessions: level, when (facility-local), price per player, spotsLeft, maxPlayers, and url. The url is the booking page for that session — share it once the user picks a session.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"date": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Optional facility-local date as YYYY-MM-DD. Omit to search the next 7 days."
},
"time": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Optional earliest start time of day as HH:MM 24-hour (e.g. \"17:00\" for evening sessions). Pass the user's spoken time directly — no timezone conversion."
},
"level": {
"type": "string",
"maxLength": 60,
"minLength": 1,
"description": "Optional skill level: Beginner, Advanced beginner, Intermediate, Advanced intermediate, Advanced, Expert, or Professional. Omit when the user has not said, or says any level."
},
"sport": {
"enum": [
"tennis",
"pickleball",
"padel",
"table-tennis",
"badminton",
"racquetball",
"squash"
],
"type": "string",
"description": "Optional sport filter (e.g. \"pickleball\"). Omit to include every sport."
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
}
},
"description": "Where to search (50-mile radius). With facilityName or facilityId there is no radius and location only sorts by distance. Accepts city+state, city-only, state-only, zip, or lat+lng. City+state or zip are preferred. Never use 0,0 or guess coordinates."
},
"facilityId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "Optional facility UUID from another CourtsApp tool, to list one facility's sessions. Never invent one."
},
"maxResults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Number of facilities to return (1–10, default 3)."
},
"facilityName": {
"type": "string",
"maxLength": 100,
"minLength": 1,
"description": "Facility name the user said (e.g. \"Sportime Englewood\"). Every word must appear in the name, in any order, so partial names work. Searched nationwide; add location to sort same-named clubs by distance."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"available",
"facilities",
"hint"
],
"properties": {
"hint": {
"type": "string"
},
"available": {
"type": "boolean"
},
"facilities": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"address",
"city",
"state",
"timezone",
"distance",
"photoUrl",
"url",
"sessions"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"city": {
"type": "string"
},
"name": {
"type": "string"
},
"state": {
"type": "string"
},
"address": {
"type": "string"
},
"distance": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sessions": {
"type": "array",
"items": {
"type": "object",
"required": [
"sessionId",
"sport",
"level",
"date",
"startTime",
"endTime",
"when",
"pricePerPlayerCents",
"price",
"spotsLeft",
"maxPlayers",
"url"
],
"properties": {
"url": {
"type": "string"
},
"date": {
"type": "string"
},
"when": {
"type": "string"
},
"level": {
"type": "string"
},
"price": {
"type": "string"
},
"sport": {
"type": "string"
},
"endTime": {
"type": "string"
},
"sessionId": {
"type": "string"
},
"spotsLeft": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"startTime": {
"type": "string"
},
"maxPlayers": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
},
"pricePerPlayerCents": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991
}
},
"additionalProperties": false
}
},
"timezone": {
"type": "string"
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}{
"name": "search_lessons",
"title": "Find Lessons",
"description": "Use this when the user wants a coach or private lessons for pickleball or tennis near a location. Not for court availability (search_courts) or open play (search_open_play).\nRead-only: it finds TeachMe.To coaches within 25 miles who have an open lesson time in the next two weeks (times start 18 hours out, since coaches need that much notice), and does not book anything. Next, get_lesson_times shows a coach's open times, and each time has a checkoutUrl: TeachMe.To's checkout with the coach, place and time already filled in, where the user pays on TeachMe.To.\nRequires sport and a location (city+state, zip, or lat+lng). A state alone is too broad, so ask for a city or zip code. maxResults is 1-6 (default 3).\nReturns coaches, each with listingId and locationId (pass both to get_lesson_times), name, rating, reviewCount, a short headline, distanceMiles, city, singleLessonPrice (one lesson, all fees included; null when not listed, never guess it), startingPrice (the per-lesson rate when buying a 10-lesson pack, so say \"from $X per lesson\") and nextOpen (the soonest open time in the coach's local time, with its slotKey and checkoutUrl: share that link exactly as returned to book it; the player needs to give no contact details). Each coach also has locations (where they teach near the search, nearest first, with distanceMiles) and teachmeUrl, their own TeachMe.To page, where the player chooses a location, date and time themselves.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"sport"
],
"properties": {
"sport": {
"enum": [
"pickleball",
"tennis"
],
"type": "string",
"description": "Sport to find a coach for: pickleball or tennis."
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
}
},
"description": "Where to look (25-mile radius). City+state or zip are preferred. A state alone is too broad. Use lat+lng only if the user provided real coordinates. Never use 0,0 or guess coordinates."
},
"maxResults": {
"type": "integer",
"maximum": 6,
"minimum": 1,
"description": "Number of coaches to return (1-6, default 3)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"coaches",
"hint"
],
"properties": {
"hint": {
"type": "string"
},
"coaches": {
"type": "array",
"items": {
"type": "object",
"required": [
"listingId",
"name",
"sport",
"photoUrl",
"rating",
"reviewCount",
"lessonCount",
"headline",
"singleLessonPrice",
"startingPrice",
"currency",
"distanceMiles",
"city",
"locationId",
"locationName",
"lessonLengths",
"locations",
"teachmeUrl",
"nextOpen"
],
"properties": {
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"sport": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"description": "The sport the coach teaches, as TeachMe.To labels it (\"Tennis\")."
},
"rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"headline": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"nextOpen": {
"type": "object",
"required": [
"startAt",
"label",
"timezone",
"lessonLength",
"slotKey",
"checkoutUrl"
],
"properties": {
"label": {
"type": "string"
},
"slotKey": {
"type": "string"
},
"startAt": {
"type": "string"
},
"timezone": {
"type": "string"
},
"checkoutUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lessonLength": {
"type": "integer"
}
},
"additionalProperties": false
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"listingId": {
"type": "string"
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"city",
"state",
"distanceMiles",
"online"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"online": {
"type": "boolean"
},
"distanceMiles": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"locationId": {
"type": "string"
},
"teachmeUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lessonCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"reviewCount": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"locationName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"distanceMiles": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"lessonLengths": {
"type": "array",
"items": {
"type": "integer"
}
},
"startingPrice": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"singleLessonPrice": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| locationId | string | The locationId from search_lessons (the coach's place nearest the user). Needed when the coach teaches at more than one place. |
| earliestTime | string | Only times starting at or after this local time, HH:MM 24-hour (for example 17:00 for evenings). |
| lessonLength | integer | Lesson length in minutes. Leave out for the coach's usual length. |
{
"name": "get_lesson_times",
"title": "Lesson Times",
"description": "Use this when the user has picked a coach from search_lessons and wants to see when that coach is free for a private lesson. Not for court times (search_courts).\nRead-only: it shows the coach's open lesson times at one location and does not book anything. Pass the coach's listingId and the locationId from search_lessons (a coach who teaches at several places needs one). Optional: lessonLength in minutes (30, 60, 90 or 120; default the coach's usual length), startDate and endDate (YYYY-MM-DD, local days at the location; default the next 7 days, at most 14; times start 18 hours out, since coaches need that much notice), and earliestTime and latestTime (HH:MM, local) to narrow each day, for example evenings.\nReturns the coach (with teachmeUrl, their own TeachMe.To page, where the player chooses a location, date and time themselves), the location and the coach's other locations, the lesson length, prices (TeachMe.To quotes for one student, fees included: one lesson, and the 10-lesson pack where the coach sells one; the exact total comes back with the checkout link) and open times grouped by local day, each with a slotKey and a checkoutUrl (TeachMe.To's checkout for that time with the coach, place and time already filled in: to book, share it exactly as returned; no contact details are needed). Times are in the location's own time zone. Each day shows a spread of its times and openTimes says how many there are in all; at most 4 days are shown.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listingId"
],
"properties": {
"endDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "Last day to show, YYYY-MM-DD. Defaults to a week from the first day; at most 14 days in all."
},
"listingId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The coach's listingId from search_lessons."
},
"startDate": {
"type": "string",
"pattern": "^\\d{4}-\\d{2}-\\d{2}$",
"description": "First day to show, YYYY-MM-DD, a local day at the location. Defaults to today."
},
"latestTime": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Only times starting at or before this local time, HH:MM 24-hour."
},
"locationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The locationId from search_lessons (the coach's place nearest the user). Needed when the coach teaches at more than one place."
},
"earliestTime": {
"type": "string",
"pattern": "^([01]\\d|2[0-3]):[0-5]\\d$",
"description": "Only times starting at or after this local time, HH:MM 24-hour (for example 17:00 for evenings)."
},
"lessonLength": {
"enum": [
30,
60,
90,
120
],
"type": "integer",
"description": "Lesson length in minutes. Leave out for the coach's usual length."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"coach",
"location",
"locations",
"lessonLength",
"lessonLengths",
"currency",
"prices",
"range",
"days",
"daysWithOpenings",
"moreDays",
"hint"
],
"properties": {
"days": {
"type": "array",
"items": {
"type": "object",
"required": [
"date",
"label",
"timezoneAbbrev",
"openTimes",
"slots"
],
"properties": {
"date": {
"type": "string"
},
"label": {
"type": "string"
},
"slots": {
"type": "array",
"items": {
"type": "object",
"required": [
"startAt",
"time",
"slotKey",
"checkoutUrl"
],
"properties": {
"time": {
"type": "string"
},
"slotKey": {
"type": "string"
},
"startAt": {
"type": "string"
},
"checkoutUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"openTimes": {
"type": "integer"
},
"timezoneAbbrev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"hint": {
"type": "string"
},
"coach": {
"type": "object",
"required": [
"listingId",
"name",
"photoUrl",
"rating",
"teachmeUrl"
],
"properties": {
"name": {
"type": "string"
},
"rating": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"listingId": {
"type": "string"
},
"teachmeUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"range": {
"type": "object",
"required": [
"from",
"to"
],
"properties": {
"to": {
"type": "string"
},
"from": {
"type": "string"
}
},
"additionalProperties": false
},
"prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"lessons",
"perLesson",
"total"
],
"properties": {
"total": {
"type": "number"
},
"lessons": {
"type": "integer"
},
"perLesson": {
"type": "number"
}
},
"additionalProperties": false
}
},
"currency": {
"type": "string"
},
"location": {
"type": "object",
"required": [
"id",
"name",
"address",
"city",
"state",
"timezone",
"timezoneAbbrev"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"address": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"timezone": {
"type": "string"
},
"timezoneAbbrev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"moreDays": {
"type": "integer"
},
"locations": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"city",
"state",
"online"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"online": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"lessonLength": {
"type": "integer"
},
"lessonLengths": {
"type": "array",
"items": {
"type": "integer"
}
},
"daysWithOpenings": {
"type": "integer"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": true,
"destructiveHint": false
}
}| studentName * |
| string |
| The student's full name, as the user gave it. |
| lessonLength * | integer | Lesson length in minutes: the lessonLength of the times the user picked from. |
| studentEmail * | string | The student's email address, as the user gave it. |
| studentPhone * | string | The student's phone number with area code, as the user gave it. |
{
"name": "get_lesson_booking_link",
"title": "Lesson Booking Link",
"description": "Optional: use this only when the user asks to have their own details filled in on the checkout for them. The default way to book needs no contact details: share the picked time's checkoutUrl from get_lesson_times exactly as returned. This tool prepares a TeachMe.To checkout for that lesson and returns a link where the user pays, with the coach, location, time and the student's details already filled in.\nIt sends the student's full name, email address and phone number to TeachMe.To to prepare that checkout (they are what lets TeachMe.To fill them in), and creates their TeachMe.To account if the email is new. Ask the user for all three first, and use only what the user gave you. Nothing is charged by this tool, and CourtsApp takes no payment for lessons: the user pays on TeachMe.To, and the coach then accepts the time or suggests another, so it is a request, never a confirmed booking.\nRequires listingId, locationId and slotKey (from get_lesson_times, exactly as returned), lessonLength (minutes, the one used for the times), studentName, studentEmail and studentPhone. lessons is how many lessons to buy as a prepaid pack, 1-20 (default 1).\nReturns paymentUrl (share it exactly as returned), the coach, location and local time, and the quote: lessons, pricePerLesson, fees, total and currency.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"listingId",
"locationId",
"slotKey",
"lessonLength",
"studentName",
"studentEmail",
"studentPhone"
],
"properties": {
"lessons": {
"type": "integer",
"default": 1,
"maximum": 20,
"minimum": 1,
"description": "How many lessons to buy as a prepaid pack (1-20). Defaults to 1. The first lesson is at the time picked."
},
"slotKey": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "The slotKey of the time the user picked, copied exactly as returned. It cannot be edited."
},
"listingId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The coach's listingId from search_lessons or get_lesson_times."
},
"locationId": {
"type": "string",
"format": "uuid",
"pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
"description": "The locationId the time is at, from get_lesson_times."
},
"studentName": {
"type": "string",
"maxLength": 200,
"minLength": 1,
"description": "The student's full name, as the user gave it."
},
"lessonLength": {
"enum": [
30,
60,
90,
120
],
"type": "integer",
"description": "Lesson length in minutes: the lessonLength of the times the user picked from."
},
"studentEmail": {
"type": "string",
"maxLength": 254,
"minLength": 3,
"description": "The student's email address, as the user gave it."
},
"studentPhone": {
"type": "string",
"maxLength": 40,
"minLength": 7,
"description": "The student's phone number with area code, as the user gave it."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"paymentUrl",
"linkExpiresAt",
"coach",
"location",
"lesson",
"quote",
"hint"
],
"properties": {
"hint": {
"type": "string"
},
"coach": {
"type": "object",
"required": [
"listingId",
"name",
"photoUrl",
"sport"
],
"properties": {
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sport": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"photoUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"listingId": {
"type": "string"
}
},
"additionalProperties": false
},
"quote": {
"type": "object",
"required": [
"lessons",
"pricePerLesson",
"fees",
"discounts",
"savings",
"total",
"currency"
],
"properties": {
"fees": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"amount"
],
"properties": {
"name": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"additionalProperties": false
}
},
"total": {
"type": "number"
},
"lessons": {
"type": "integer"
},
"savings": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"discounts": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"amount"
],
"properties": {
"name": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"additionalProperties": false
}
},
"pricePerLesson": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"lesson": {
"type": "object",
"required": [
"startAt",
"endAt",
"timezone",
"timezoneAbbrev",
"date",
"time",
"label",
"lengthMinutes"
],
"properties": {
"date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"time": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"endAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"label": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"startAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"timezone": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"lengthMinutes": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"timezoneAbbrev": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"location": {
"type": "object",
"required": [
"id",
"name",
"city",
"state"
],
"properties": {
"id": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"paymentUrl": {
"type": "string"
},
"linkExpiresAt": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": false,
"openWorldHint": true,
"destructiveHint": false
}
}| location | object | Where to look (150-mile radius). City+state or zip are preferred; a state alone lists that state's events with no distances. Use lat+lng only if the user provided real coordinates. Never use 0,0 or guess coordinates. Optional: leave it out to search everywhere. |
| maxResults | integer | Number of events to return (1-10, default 6). |
{
"name": "search_tournaments",
"title": "Find Tournaments",
"description": "Use this when the user wants tournaments or leagues to play in, near a location or by name. Not for court availability (search_courts), open play (search_open_play) or coaching (search_lessons).\nRead-only: it searches CourtsApp's catalog of events and cannot register anyone. Each event has a registration url on the organizer's site: share it exactly as returned and let the user sign up there. Never say anyone is registered.\nLocation is optional (city+state, zip, or lat+lng; a state alone lists that state's events). With a city or zip it returns events within 150 miles, soonest first, each with distanceMiles; if none are that close it says so and returns the 2 nearest, which are not near, so never call them nearby. Without a location it returns the soonest events anywhere. Use q or name for an event name (e.g. \"Moneyball\"), type to limit to tournaments or leagues, and from/to (YYYY-MM-DD) for dates; it starts from today by default. maxResults is 1-10 (default 6).\nReturns tournaments, each with name, eventType, venueName, city, state, startDate and endDate (calendar days), registrationCloseDate, closingSoon (registration closes within 5 days), priceMinCents and priceMaxCents with currency (cents; 0 means free), url, and distanceMiles; plus total and hint.",
"inputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"properties": {
"q": {
"type": "string",
"maxLength": 100,
"description": "Optional event name or venue to look for, e.g. \"Moneyball\"."
},
"to": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Optional last day to include, as YYYY-MM-DD: events starting on or before it are returned. Omit for no end date."
},
"from": {
"type": "string",
"format": "date",
"pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
"description": "Optional first day to include, as YYYY-MM-DD: events still on or after it are returned. Defaults to today."
},
"type": {
"enum": [
"tournament",
"league"
],
"type": "string",
"description": "Optional: only tournaments, or only leagues. Leave it out for both."
},
"sport": {
"enum": [
"tennis",
"pickleball",
"padel",
"table-tennis",
"badminton",
"racquetball",
"squash"
],
"type": "string",
"description": "Optional sport to find events for. Pass it whenever the user names one. Case-insensitive. Common aliases accepted (e.g. \"pickle ball\" → pickleball)."
},
"location": {
"type": "object",
"properties": {
"lat": {
"type": "number"
},
"lng": {
"type": "number"
},
"zip": {
"type": "string"
},
"city": {
"type": "string"
},
"state": {
"type": "string"
}
},
"description": "Where to look (150-mile radius). City+state or zip are preferred; a state alone lists that state's events with no distances. Use lat+lng only if the user provided real coordinates. Never use 0,0 or guess coordinates. Optional: leave it out to search everywhere."
},
"maxResults": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Number of events to return (1-10, default 6)."
}
}
},
"outputSchema": {
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tournaments",
"total",
"hint"
],
"properties": {
"hint": {
"type": "string"
},
"total": {
"type": "integer"
},
"tournaments": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"name",
"eventType",
"categoryLabel",
"venueName",
"city",
"state",
"country",
"startDate",
"endDate",
"registrationCloseDate",
"closingSoon",
"priceMinCents",
"priceMaxCents",
"currency",
"url",
"bannerUrl",
"sportSlug",
"distanceMiles"
],
"properties": {
"id": {
"type": "string"
},
"url": {
"type": "string"
},
"city": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"name": {
"type": "string"
},
"state": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"country": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"endDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"currency": {
"type": "string"
},
"bannerUrl": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"eventType": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"sportSlug": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"startDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"venueName": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"closingSoon": {
"type": "boolean"
},
"categoryLabel": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"distanceMiles": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"priceMaxCents": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"priceMinCents": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
]
},
"registrationCloseDate": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}
},
"nothingWithinMiles": {
"type": "integer"
}
},
"additionalProperties": false
},
"annotations": {
"readOnlyHint": true,
"openWorldHint": false,
"destructiveHint": false
}
}