Pga Golf

[
  {
    "name": "search_golf_coaches",
    "title": "Search Golf Coaches",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Search for qualified PGA golf coaches listed on pga.com/coach in the specified location (required).\nUse this tool when the user asks to find, browse, or compare coaches for private lessons in a location.\nFor location-first discovery of clinics, camps, classes, or other group programs, use `search_golf_programs` instead.\nIf the user asks for availability for a specific coach, use `get_golf_coach_availability` instead.\nInternal record identifiers (for example coach `slug` and offering `id`) are for tool calls only and must never be shown or mentioned to the user.\n- Search results include the coach's profile information, private-lesson offerings, pricing, and a short teaser of upcoming public programs they host (capped at 2). For location-first program discovery, use `search_golf_programs`.\n- Use that program context to recommend which group offering best fits the golfer when relevant; present upcoming programs when available.\n- Results are ordered by proximity to the search location, so list them to the user in this order.\n- Results are paginated, so use the pagination cursor provided at the end of the response to retrieve the next page of results.",
    "inputSchema": {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "searchLocation"
      ],
      "properties": {
        "searchRadius": {
          "type": "number",
          "default": 25,
          "minimum": 0,
          "description": "Search radius in miles from `searchLocation`. Use 25 by default unless the user requests a different radius."
        },
        "searchLocation": {
          "type": "string",
          "description": "Required location used to find nearby coaches. Accepts city/state, ZIP code, full address, or latitude/longitude coordinates."
        },
        "paginationCursor": {
          "type": "string",
          "description": "Pagination cursor from a prior `search_golf_coaches` response. Use only when fetching additional pages of the same search."
        }
      }
    }
  },
  {
    "name": "search_golf_programs",
    "title": "Search Golf Programs",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Search for upcoming public PGA Coach programs (clinics, camps, classes, and other group events) near a location (required).\nUse this tool when the user asks to find programs, clinics, camps, classes, or group events — not private one-on-one lessons.\nFor private lesson coaches, use `search_golf_coaches` instead.\nInternal record identifiers (for example program `id` and coach `slug`) are for tool calls only and must never be shown or mentioned to the user.\n- Search results include program details plus the hosting coach and facility for each program.\n- The response also includes top-level `coaches` and `facilities` arrays summarizing the unique coaches and venues in the result set — always present those to the user.\n- Results are ordered by program start instant and filtered to the requested radius.\n- Discovery uses nearby PGA Coach profiles (nearest 20 in the radius), then loads up to 30 upcoming public programs per coach in a 180-day window in one batched GraphQL request. Facility coordinates still have to fall inside the radius.\n- Results are paginated. The pagination cursor carries the remaining nearby programs so additional pages do not repeat GraphQL discovery. Reuse that cursor with the original location and radius.\n- Direct golfers to the program URL to view details and register. Coach profile and booking URLs are also included when the golfer wants to learn more about the coach.",
    "inputSchema": {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "searchLocation"
      ],
      "properties": {
        "searchRadius": {
          "type": "number",
          "default": 50,
          "minimum": 0,
          "description": "Search radius in miles from `searchLocation`. Use 50 by default unless the user requests a different radius."
        },
        "searchLocation": {
          "type": "string",
          "description": "Required location used to find nearby PGA Coach programs. Accepts city/state, ZIP code, full address, or latitude/longitude coordinates."
        },
        "paginationCursor": {
          "type": "string",
          "description": "Pagination cursor from a prior `search_golf_programs` response. Use only when fetching additional pages of the same search (same location and radius)."
        }
      }
    }
  },
  {
    "name": "get_golf_coach_availability",
    "title": "Get Golf Coach Availability",
    "annotations": {
      "readOnlyHint": true
    },
    "description": "Retrieve offering details and available lesson times for one specific coach.\nUse this when the user asks for schedule, openings, or available times for a known coach.\nIf the user has not selected a coach yet, call `search_golf_coaches` first (or reuse a coach already identified from `search_golf_programs`).\nCoach `slug` and offering `id` values are internal identifiers and must never be shown or mentioned to the user.",
    "inputSchema": {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "slug"
      ],
      "properties": {
        "slug": {
          "type": "string",
          "description": "Coach slug from a pga.com profile URL, prior `search_golf_coaches` results, or prior `search_golf_programs` results (e.g., `anthonyvitale`). Internal-only value; never display or mention it to the user."
        },
        "offeringId": {
          "type": "string",
          "description": "Optional offering ID to scope availability to a single offering. Use this when the user has already selected an offering."
        }
      }
    }
  },
  {
    "name": "book_golf_lesson",
    "title": "Book Golf Lesson",
    "annotations": {
      "readOnlyHint": false
    },
    "description": "Request to book a golf lesson for a specific coach's offering.\n- `offeringId` is an internal identifier; never show or mention it to the user.\n- A continuation URL will be returned that you can direct the user to after calling this tool.\n- If the offering was booked automatically (e.g., free lesson or no prepayment required), the confirmation code will also be included.",
    "inputSchema": {
      "type": "object",
      "$schema": "http://json-schema.org/draft-07/schema#",
      "required": [
        "offeringId",
        "startDateTime",
        "student"
      ],
      "properties": {
        "student": {
          "anyOf": [
            {
              "type": "object",
              "required": [
                "type",
                "firstName",
                "lastName",
                "email"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "adult"
                },
                "email": {
                  "type": "string",
                  "description": "The email address of the student booking the lesson."
                },
                "phone": {
                  "type": "string",
                  "description": "The phone number of the student booking the lesson."
                },
                "lastName": {
                  "type": "string",
                  "description": "The last name of the student booking the lesson."
                },
                "firstName": {
                  "type": "string",
                  "description": "The first name of the student booking the lesson."
                }
              }
            },
            {
              "type": "object",
              "required": [
                "type",
                "firstName",
                "lastName",
                "guardianFirstName",
                "guardianLastName",
                "email"
              ],
              "properties": {
                "type": {
                  "type": "string",
                  "const": "junior"
                },
                "email": {
                  "type": "string",
                  "description": "The email address of the student booking the lesson."
                },
                "phone": {
                  "type": "string",
                  "description": "The phone number of the student booking the lesson."
                },
                "lastName": {
                  "type": "string",
                  "description": "The last name of the student booking the lesson."
                },
                "firstName": {
                  "type": "string",
                  "description": "The first name of the student booking the lesson."
                },
                "guardianLastName": {
                  "type": "string",
                  "description": "The last name of the guardian booking the lesson."
                },
                "guardianFirstName": {
                  "type": "string",
                  "description": "The first name of the guardian booking the lesson."
                }
              },
              "description": "The contact information for the student participating in the lesson. Student type can be either 'adult' or 'junior'. If the student is a junior, the guardian's information is also required."
            }
          ]
        },
        "offeringId": {
          "type": "string",
          "description": "Internal offering record ID to book a lesson for. Never display or mention this identifier to the user."
        },
        "startDateTime": {
          "type": "string",
          "description": "The start date and time of the lesson in ISO 8601 format."
        }
      }
    }
  }
]