{"openapi":"3.1.0","info":{"title":"Ansab (Arabian Horse) API","version":"0.1.0","description":"A fully local Arabian horse breed heritage reference: breed characteristics and conformation, the five Al Khamsa foundation strains, the Bedouin oral-pedigree breeding tradition, global influence on the Thoroughbred and other modern breeds, endurance riding and breed shows, general care basics, coat colors, and a glossary.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://ansab.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/ansab/docs"},"termsOfService":"https://connectorbay.com/ansab/terms"},"servers":[{"url":"https://ansab.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/ansab/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_characteristics_info":{"post":{"operationId":"breed_characteristics_info","summary":"The Arabian horse's conformation and physical traits — the dished facial profile, arched neck and","description":"The Arabian horse's conformation and physical traits — the dished facial profile, arched neck and\n    mitbah, level croup, naturally high tail carriage, build and size — plus temperament notes and the\n    verified skeletal trait that many (not all) Arabians carry one fewer vertebra than most other horse\n    breeds. Use for \"what does an Arabian horse look like\", \"how many vertebrae does an Arabian horse have\",\n    \"why do Arabians hold their tail up\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"breed_characteristics_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/foundation_strain_info":{"post":{"operationId":"foundation_strain_info","summary":"One traditional Bedouin breeding strain's name and characteristics — covers the five Al Khamsa","description":"One traditional Bedouin breeding strain's name and characteristics — covers the five Al Khamsa\n    foundation strains: Kuhaylan (Keheilan), Saqlawi (Seglawi), Abayyan (Abeyan), Hamdani, and Hadban. Use for\n    \"what is the Kuhaylan strain\", \"tell me about Saqlawi Arabians\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A traditional Bedouin breeding strain's name or alias.","examples":["Kuhaylan","Saqlawi","Abayyan","Hamdani","Hadban"],"title":"Name","type":"string"}},"required":["name"],"title":"foundation_strain_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/strain_search":{"post":{"operationId":"strain_search","summary":"Search the five traditional Bedouin breeding strains by partial name, alias, or description text. Use","description":"Search the five traditional Bedouin breeding strains by partial name, alias, or description text. Use\n    for \"which strain is known for refinement\", \"strains associated with Najd\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial strain name, alias, or a word from its description.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"strain_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/historical_breeding_tradition_info":{"post":{"operationId":"historical_breeding_tradition_info","summary":"The Bedouin oral, dam-line pedigree ('strain') breeding tradition and its historical significance,","description":"The Bedouin oral, dam-line pedigree ('strain') breeding tradition and its historical significance,\n    factually — how strains were tracked through the maternal line without written stud books, the Al Khamsa\n    foundation-mare tradition, the close human-horse bond, and the rise of modern written breed registries.\n    Use for \"how did Bedouins track horse pedigrees\", \"what is Al Khamsa\", \"why are Arabian mares prized\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"historical_breeding_tradition_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/global_influence_info":{"post":{"operationId":"global_influence_info","summary":"The Arabian horse's global influence on modern breeds — the Thoroughbred's three foundation sires","description":"The Arabian horse's global influence on modern breeds — the Thoroughbred's three foundation sires\n    (Byerley Turk, Darley Arabian, Godolphin Arabian) and their debated Arabian ancestry, and the breed's\n    documented bloodline influence on the Quarter Horse, Morgan, Warmbloods, Lipizzaner and others worldwide.\n    Use for \"which horses founded the Thoroughbred breed\", \"did Arabians influence other horse breeds\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"global_influence_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/modern_sport_and_shows_info":{"post":{"operationId":"modern_sport_and_shows_info","summary":"A factual overview of the Arabian in modern sport — endurance riding (where Arabians dominate","description":"A factual overview of the Arabian in modern sport — endurance riding (where Arabians dominate\n    internationally), halter/breed shows judged on conformation and type, dedicated Arabian flat racing, and\n    other disciplines like dressage and show jumping. Use for \"are Arabians good at endurance riding\", \"what\n    is a halter class\", \"is there Arabian-only horse racing\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"modern_sport_and_shows_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/care_basics_guide":{"post":{"operationId":"care_basics_guide","summary":"General, non-veterinary-diagnostic care, feeding, exercise and handling basics for the Arabian breed —","description":"General, non-veterinary-diagnostic care, feeding, exercise and handling basics for the Arabian breed —\n    always with a note to consult a qualified veterinarian for any actual horse's health or medical concern.\n    Use for \"how do you feed an Arabian horse\", \"do Arabians need a lot of exercise\", \"is an Arabian horse a\n    good first horse\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"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 coat colors in the Arabian breed — bay, grey, chestnut and black — with a brief,","description":"Common coat colors in the Arabian breed — bay, grey, chestnut and black — with a brief,\n    genetics-adjacent note on how each arises, not exhaustive coat-color genetics. Use for \"what colors do\n    Arabian horses come in\", \"why do grey Arabians look white\", \"is chestnut the same as sorrel\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"color":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A coat color to look up, e.g. bay, grey, chestnut, black. Omit to list all.","title":"Color"}},"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/horse_glossary":{"post":{"operationId":"horse_glossary","summary":"Definitions of common Arabian-horse terms (strain, Al Khamsa, dished profile, halter class, endurance","description":"Definitions of common Arabian-horse terms (strain, Al Khamsa, dished profile, halter class, endurance\n    riding, conformation, mitbah, foundation sire, dam line, part-bred Arabian). Use for \"what does mitbah\n    mean\", \"what's a halter class\", \"what is a dam line\".","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":"horse_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}}}}