{"openapi":"3.1.0","info":{"title":"Divot API","version":"0.1.0","description":"A hand-curated golf rules, scoring, and handicap reference: the World Handicap System's handicap-index concept, score-to-par terminology, common rules situations, scoring formats, club types, course terminology, and etiquette basics — all local.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://divot.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/divot/docs"},"termsOfService":"https://connectorbay.com/divot/terms"},"servers":[{"url":"https://divot.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/divot/docs"},"security":[{},{"bearer":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/handicap_index_explainer":{"post":{"operationId":"handicap_index_explainer","summary":"Explains the World Handicap System's Handicap Index concept: the Score Differential formula, how the","description":"Explains the World Handicap System's Handicap Index concept: the Score Differential formula, how the\n    best 8 of a golfer's most recent 20 rounds are averaged (with the sliding scale for fewer rounds), the\n    soft/hard caps on upward movement, and how a Course Handicap is derived from it. A general explainer of the\n    concept, not an official calculator. Use for \"how does golf handicap work\", \"how is a handicap index\n    calculated\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"handicap_index_explainerArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/score_term_info":{"post":{"operationId":"score_term_info","summary":"The exact relationship to par for a golf scoring term — birdie, eagle, albatross/double eagle, condor,","description":"The exact relationship to par for a golf scoring term — birdie, eagle, albatross/double eagle, condor,\n    bogey, double bogey, and beyond — plus how rare it is. Use for \"what's an eagle in golf\", \"what does\n    albatross mean\", \"is a condor a real thing in golf\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"description":"A score-to-par term.","examples":["birdie","eagle","albatross","bogey","condor","hole in one"],"title":"Term","type":"string"}},"required":["term"],"title":"score_term_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/rules_situation_guide":{"post":{"operationId":"rules_situation_guide","summary":"A general explanation of a common rules situation — out of bounds, penalty area/water hazard,","description":"A general explanation of a common rules situation — out of bounds, penalty area/water hazard,\n    unplayable lie, provisional ball, or lost ball — with the applicable rule and typical penalty. Always\n    includes a reminder to consult the official Rules of Golf or a rules official for an actual ruling. Use for\n    \"what happens if my ball lands in a water hazard\", \"what's the penalty for an unplayable lie\", \"how does a\n    provisional ball work\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"situation":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"out_of_bounds | penalty_area | unplayable_lie | provisional_ball | lost_ball. Omit to list all.","title":"Situation"}},"title":"rules_situation_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/club_info":{"post":{"operationId":"club_info","summary":"Typical loft range and use for a golf club — driver, fairway woods, hybrid, numbered irons, the","description":"Typical loft range and use for a golf club — driver, fairway woods, hybrid, numbered irons, the\n    pitching/gap/sand/lob wedges, and the putter. General figures, not manufacturer-specific. Use for \"what loft\n    is a 7-iron\", \"what's a hybrid club for\", \"when do you use a sand wedge\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A club name or common short code.","examples":["driver","3-wood","hybrid","7-iron","sand wedge","putter"],"title":"Name","type":"string"}},"required":["name"],"title":"club_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/course_terminology_guide":{"post":{"operationId":"course_terminology_guide","summary":"A golf course-features glossary — fairway, rough, green, apron, dogleg, penalty area, cart path, and","description":"A golf course-features glossary — fairway, rough, green, apron, dogleg, penalty area, cart path, and\n    more. Use for \"what's a dogleg\", \"what's the apron on a golf green\", \"what's a stroke index\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A course-features term to look up; omit to list all.","title":"Term"}},"title":"course_terminology_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/etiquette_guide":{"post":{"operationId":"etiquette_guide","summary":"Basic golf etiquette — pace of play, repairing divots and ball marks, flagstick handling, the honor","description":"Basic golf etiquette — pace of play, repairing divots and ball marks, flagstick handling, the honor\n    system, bunker raking, and staying quiet during another player's swing. Use for \"how do I fix a ball mark\",\n    \"who tees off first in golf\", \"golf etiquette for beginners\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A golf etiquette topic to look up; omit to list all.","title":"Topic"}},"title":"etiquette_guideArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/scoring_format_info":{"post":{"operationId":"scoring_format_info","summary":"How a golf scoring format works — stroke play, match play, or Stableford — including the Stableford","description":"How a golf scoring format works — stroke play, match play, or Stableford — including the Stableford\n    points table. Use for \"how does match play scoring work\", \"what is stableford scoring\", \"what's the\n    difference between stroke play and match play\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format_name":{"description":"stroke play | match play | stableford","title":"Format Name","type":"string"}},"required":["format_name"],"title":"scoring_format_infoArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/par_and_scoring_reference":{"post":{"operationId":"par_and_scoring_reference","summary":"The par-3/4/5(/6) concept, typical yardage ranges for each, a typical 18-hole course's total par, and","description":"The par-3/4/5(/6) concept, typical yardage ranges for each, a typical 18-hole course's total par, and\n    round-scoring terms (over/under/even par). Use for \"how long is a par 5\", \"what makes a hole a par 3\", \"what\n    does 2 under par mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"par_and_scoring_referenceArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}},"/v1/tools/golf_glossary":{"post":{"operationId":"golf_glossary","summary":"Definitions of general golf gameplay terms — lie, loft, slice, hook, draw, fade, mulligan, gimme, fore,","description":"Definitions of general golf gameplay terms — lie, loft, slice, hook, draw, fade, mulligan, gimme, fore,\n    stance, grip, scratch golfer, honor, and more. Use for \"what does gimme mean in golf\", \"what's the\n    difference between a draw and a hook\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"term":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A specific term to look up; omit to list all.","title":"Term"}},"title":"golf_glossaryArguments","type":"object"}}}},"responses":{"200":{"description":"Tool result. `ok: true` on success; `ok: false` with a structured `error` (provider_unavailable, upstream_error, bad_input) when the tool could not answer.","content":{"application/json":{"schema":{"type":"object","additionalProperties":true}}}},"422":{"description":"Arguments failed validation","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}},"429":{"description":"Rate limit exceeded (see Retry-After)","content":{"application/json":{"schema":{"$ref":"#/components/schemas/Error"}}}}},"x-read-only":true}}}}