{"openapi":"3.1.0","info":{"title":"Saddle API","version":"0.1.0","description":"A hand-curated general equestrian and horsemanship reference: horse breeds across all disciplines, riding disciplines, tack and equipment, horse age/sex terminology, general care basics, coat colors and markings, gaits, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://saddle.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/saddle/docs"},"termsOfService":"https://connectorbay.com/saddle/terms"},"servers":[{"url":"https://saddle.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/saddle/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/breed_info":{"post":{"operationId":"breed_info","summary":"A general horse breed's origin, characteristics and typical use — covers breeds across all","description":"A general horse breed's origin, characteristics and typical use — covers breeds across all\n    disciplines (Thoroughbred, Quarter Horse, Clydesdale, Friesian, Appaloosa, Mustang, Percheron,\n    Warmblood, Shetland Pony, Standardbred, Morgan, Andalusian, Icelandic Horse, Tennessee Walking\n    Horse, Paint Horse, Belgian Draft, Haflinger, Welsh Pony, Lipizzaner, Paso Fino, Missouri Fox\n    Trotter, Akhal-Teke and more). For the Arabian, returns a brief overview pointing to the dedicated\n    `ansab` connector for in-depth breed heritage rather than duplicating it here. Use for \"what is a\n    Clydesdale\", \"tell me about the Quarter Horse\", \"what is a Warmblood\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A horse breed's name or alias.","examples":["Thoroughbred","Clydesdale","Warmblood","Mustang"],"title":"Name","type":"string"}},"required":["name"],"title":"breed_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/breed_search":{"post":{"operationId":"breed_search","summary":"Search horse breeds by partial name, alias, or description text. Use for \"which breeds are draft","description":"Search horse breeds by partial name, alias, or description text. Use for \"which breeds are draft\n    horses\", \"breeds known for a spotted coat\", \"gaited horse breeds\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial breed name, alias, or a word from its description.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"breed_searchArguments","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/discipline_info":{"post":{"operationId":"discipline_info","summary":"One riding discipline explained — Western riding (and its reining/cutting/barrel-racing","description":"One riding discipline explained — Western riding (and its reining/cutting/barrel-racing\n    sub-events), dressage, show jumping, eventing, hunter/equitation, trail riding, driving, and\n    endurance riding — with a factual overview, sub-disciplines, typical tack, and notable breeds. Use\n    for \"what is dressage\", \"what's the difference between hunters and equitation\", \"what is Western\n    pleasure\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A riding discipline's name or alias.","examples":["Western","dressage","show jumping","trail riding"],"title":"Name","type":"string"}},"required":["name"],"title":"discipline_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/tack_guide":{"post":{"operationId":"tack_guide","summary":"Tack and equipment reference — English vs. Western saddles, bridles, bit types (snaffle vs.","description":"Tack and equipment reference — English vs. Western saddles, bridles, bit types (snaffle vs.\n    curb), halters, girths/cinches, stirrups, and general saddle-fit concepts. Use for \"what's the\n    difference between English and Western saddles\", \"what's a snaffle bit\", \"what is a cinch\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"item":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A tack item to look up, e.g. english saddle, western saddle, bridle, bit, halter, girth, stirrups. Omit to list all.","title":"Item"}},"title":"tack_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/horse_terminology_guide":{"post":{"operationId":"horse_terminology_guide","summary":"Horse age and sex terminology explained — foal, weanling, yearling, colt, filly, gelding, mare,","description":"Horse age and sex terminology explained — foal, weanling, yearling, colt, filly, gelding, mare,\n    stallion, broodmare, dam, sire. Use for \"what is a yearling\", \"what's the difference between a colt\n    and a gelding\", \"what does dam mean\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"horse_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/care_basics_guide":{"post":{"operationId":"care_basics_guide","summary":"General, non-veterinary-diagnostic care basics — feeding, hoof care, and grooming — always with a","description":"General, non-veterinary-diagnostic care basics — feeding, hoof care, and grooming — always with a\n    note to consult a qualified veterinarian for any actual horse's health concern and a farrier for\n    hoof-specific issues. Use for \"how much hay does a horse need\", \"how often do horses need their\n    hooves trimmed\", \"basic horse grooming routine\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A care topic to look up: feeding, hoof_care, or grooming. Omit to get all three.","title":"Topic"}},"title":"care_basics_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/color_and_markings_guide":{"post":{"operationId":"color_and_markings_guide","summary":"Common horse coat colors (bay, chestnut, black, grey, palomino, buckskin, dun, grullo, roan,","description":"Common horse coat colors (bay, chestnut, black, grey, palomino, buckskin, dun, grullo, roan,\n    pinto/paint, appaloosa patterns, cremello/perlino) and face/leg marking terminology (star, snip,\n    stripe, blaze, bald face, coronet, pastern, sock, stocking). Use for \"what colors do horses come\n    in\", \"what is a blaze marking\", \"what's the difference between a sock and a stocking\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"color_and_markings_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/gait_guide":{"post":{"operationId":"gait_guide","summary":"The four natural gaits every sound horse performs — walk, trot, canter, gallop — with beat count","description":"The four natural gaits every sound horse performs — walk, trot, canter, gallop — with beat count\n    and typical speed, plus notable breed-specific gaits: the Tennessee Walking Horse's running walk,\n    the Icelandic Horse's tölt and flying pace, the Paso Fino's gaits, the Missouri Fox Trotter's fox\n    trot, and the Standardbred's pace. Use for \"what are the four gaits of a horse\", \"what is a tölt\",\n    \"what's special about a Tennessee Walker's gait\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"gait_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/equestrian_glossary":{"post":{"operationId":"equestrian_glossary","summary":"Definitions of common general equestrian terms (hand, withers, poll, conformation, farrier, tack,","description":"Definitions of common general equestrian terms (hand, withers, poll, conformation, farrier, tack,\n    lead, longeing, cross-tie, gait, green, groundwork, turnout, equitation). Use for \"what does withers\n    mean\", \"what's a hand in horse height\", \"what does green mean for a horse\".","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":"equestrian_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}}}}