{"openapi":"3.1.0","info":{"title":"Riyada (Sport) API","version":"0.1.0","description":"A fully local reference on traditional and popular sports across the Arab world: camel racing (with robotic jockeys), horse racing heritage, dhow racing, traditional wrestling and stick games, falconry as a sport, football culture by country, and factual major-tournament hosting history.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://riyada.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/riyada/docs"},"termsOfService":"https://connectorbay.com/riyada/terms"},"servers":[{"url":"https://riyada.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/riyada/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/traditional_sport_info":{"post":{"operationId":"traditional_sport_info","summary":"One traditional or heritage sport's description, history and basic format — falconry as a sport, camel","description":"One traditional or heritage sport's description, history and basic format — falconry as a sport, camel\n    racing, horse racing heritage, dhow/traditional sailing racing, Sudanese Nuba wrestling, and the Egyptian\n    tahtib stick game. Use for \"what is tahtib\", \"tell me about Nuba wrestling\", \"is falconry a sport\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"name":{"description":"A traditional or heritage sport's name or alias.","examples":["camel racing","falconry","tahtib","dhow racing","nuba wrestling","horse racing"],"title":"Name","type":"string"}},"required":["name"],"title":"traditional_sport_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/sport_search":{"post":{"operationId":"sport_search","summary":"Search traditional sports, glossary terms and football-culture country notes by partial name, alias,","description":"Search traditional sports, glossary terms and football-culture country notes by partial name, alias,\n    region or keyword. Use for \"sports involving camels\", \"which country hosted the Asian Cup\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial name, alias, region, or a word from a sport's description, a glossary term, or a country's football notes.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"sport_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/camel_racing_guide":{"post":{"operationId":"camel_racing_guide","summary":"A deep dive on camel racing: history, race format and classes, the well-documented shift since the","description":"A deep dive on camel racing: history, race format and classes, the well-documented shift since the\n    mid-2000s to remote-controlled robot jockeys (which replaced human child jockeys), and the Gulf regions\n    where it is practiced today. Use for \"how does camel racing work\", \"why do camels have robot jockeys\",\n    \"when did camel racing switch to robots\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"camel_racing_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_racing_heritage_info":{"post":{"operationId":"horse_racing_heritage_info","summary":"A brief factual overview of Arabian-horse racing heritage — the furusiyya horsemanship tradition — and","description":"A brief factual overview of Arabian-horse racing heritage — the furusiyya horsemanship tradition — and\n    modern Gulf thoroughbred racing (Dubai's Meydan/Dubai World Cup, Saudi Arabia's Saudi Cup). The planned\n    `ansab` connector will cover Arabian-horse breed and heritage content in depth. Use for \"what is furusiyya\",\n    \"is horse racing popular in the Gulf\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"horse_racing_heritage_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/football_culture_info":{"post":{"operationId":"football_culture_info","summary":"Factual notes on football's (soccer's) popularity, top-league names and club/fan culture by country —","description":"Factual notes on football's (soccer's) popularity, top-league names and club/fan culture by country —\n    league names, historical tournament hosting, and notable participation facts. Never ranks any club, team or\n    country. Use for \"what's Egypt's top football league\", \"is football popular in Saudi Arabia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"country":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A country name, e.g. Saudi Arabia, Egypt, Morocco, Qatar, UAE, Tunisia, Algeria, Jordan, Iraq. Omit for the general overview and full country list.","title":"Country"}},"title":"football_culture_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/major_tournament_history_info":{"post":{"operationId":"major_tournament_history_info","summary":"Factual notes on Arab nations hosting and participating in major football tournaments — the FIFA World","description":"Factual notes on Arab nations hosting and participating in major football tournaments — the FIFA World\n    Cup (Qatar 2022, the first Arab/Middle Eastern host; Saudi Arabia confirmed for 2034), the AFC Asian Cup,\n    the FIFA Arab Cup, and the Africa Cup of Nations — framed as neutral historical record, never as a ranking\n    of any team or nation. Use for \"which Arab country hosted the World Cup\", \"has Qatar hosted the Asian Cup\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"major_tournament_history_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/dhow_racing_guide":{"post":{"operationId":"dhow_racing_guide","summary":"Traditional Gulf dhow (wooden sailing boat) racing — history, race classes and courses, and the annual","description":"Traditional Gulf dhow (wooden sailing boat) racing — history, race classes and courses, and the annual\n    Al Gaffal race. Use for \"what is dhow racing\", \"what is the Al Gaffal race\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"dhow_racing_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/modern_sports_landscape_info":{"post":{"operationId":"modern_sports_landscape_info","summary":"A factual, non-editorializing note on the growth of sports investment and major recurring events across","description":"A factual, non-editorializing note on the growth of sports investment and major recurring events across\n    the Arab world — Formula 1 races, horse-racing meetings, tennis tournaments and camel festivals — naming\n    the events without commentary on the reasons behind the investment. Use for \"what major sports events does\n    the Gulf host\", \"is there a Formula 1 race in Saudi Arabia\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"modern_sports_landscape_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/sport_glossary":{"post":{"operationId":"sport_glossary","summary":"Definitions of common Arab-sports terms (hijin, midmar, meydan, furusiyya, al gaffal, robot jockey,","description":"Definitions of common Arab-sports terms (hijin, midmar, meydan, furusiyya, al gaffal, robot jockey,\n    tahtib, ultras, mazayin). Use for \"what does hijin mean\", \"what is a robot jockey\", \"what does mazayin\n    mean\".","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":"sport_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}}}}