{"openapi":"3.1.0","info":{"title":"Gully API","version":"0.1.0","description":"A hand-curated Indian cricket reference: IPL champions and franchise records, ICC World Cup/T20 World Cup/Champions Trophy winners, venues, rules, glossary and a trivia quiz.\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://gully.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"hr@unifydynamics.com","url":"https://connectorbay.com/gully/docs"},"termsOfService":"https://connectorbay.com/gully/terms"},"servers":[{"url":"https://gully.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/gully/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/ipl_champions":{"post":{"operationId":"ipl_champions","summary":"The IPL champion and runner-up for one season, or every season since the league began in 2008. Use for \"who","description":"The IPL champion and runner-up for one season, or every season since the league began in 2008. Use for \"who\n    won the IPL in 2016\", \"list every IPL champion\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"year":{"anyOf":[{"maximum":2100,"minimum":2008,"type":"integer"},{"type":"null"}],"default":null,"description":"A specific IPL season; omit for the full list.","title":"Year"}},"title":"ipl_championsArguments","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/franchise_info":{"post":{"operationId":"franchise_info","summary":"One IPL franchise's profile: city, home ground, founding year, total titles and the years won, notable","description":"One IPL franchise's profile: city, home ground, founding year, total titles and the years won, notable\n    captains, and a short history note. Use for \"tell me about Mumbai Indians\", \"what's RCB's history\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team":{"description":"Team name, short code, or city.","examples":["Chennai Super Kings","CSK","Mumbai"],"title":"Team","type":"string"}},"required":["team"],"title":"franchise_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/team_search":{"post":{"operationId":"team_search","summary":"Search IPL franchises by partial name, short code, or city. Use for \"which team is based in Lucknow\".","description":"Search IPL franchises by partial name, short code, or city. Use for \"which team is based in Lucknow\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"query":{"description":"Partial team name, short code, or city.","minLength":1,"title":"Query","type":"string"}},"required":["query"],"title":"team_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/most_titles":{"post":{"operationId":"most_titles","summary":"IPL franchises ranked by total titles won, with the years each title came. Use for \"who has won the most","description":"IPL franchises ranked by total titles won, with the years each title came. Use for \"who has won the most\n    IPL titles\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"most_titlesArguments","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/world_cup_winners":{"post":{"operationId":"world_cup_winners","summary":"Winners and runners-up of the ODI Cricket World Cup, T20 World Cup, or ICC Champions Trophy — one edition, the","description":"Winners and runners-up of the ODI Cricket World Cup, T20 World Cup, or ICC Champions Trophy — one edition, the\n    full list, or a title-count ranking by team. Use for \"who won the 2011 World Cup\", \"how many T20 World Cups has\n    India won\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"description":"odi | t20 | champions_trophy","title":"Format","type":"string"},"year":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"A specific edition's year; omit for the full list.","title":"Year"},"rankings":{"default":false,"description":"If true, return the title-count ranking instead of the year-by-year list.","title":"Rankings","type":"boolean"}},"required":["format"],"title":"world_cup_winnersArguments","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/venue_info":{"post":{"operationId":"venue_info","summary":"A cricket ground's city, seating capacity, IPL home team (if any), and a notable fact. Use for \"how big is","description":"A cricket ground's city, seating capacity, IPL home team (if any), and a notable fact. Use for \"how big is\n    the Narendra Modi Stadium\", \"which IPL team plays at Eden Gardens\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"venue":{"description":"Ground name or city.","examples":["Eden Gardens","Wankhede","Mumbai"],"title":"Venue","type":"string"}},"required":["venue"],"title":"venue_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/format_explainer":{"post":{"operationId":"format_explainer","summary":"How Test, ODI and T20I cricket differ (overs, innings, duration). Use for \"what's the difference between","description":"How Test, ODI and T20I cricket differ (overs, innings, duration). Use for \"what's the difference between\n    ODI and T20\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"format":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"test | odi | t20i; omit to list all three.","title":"Format"}},"title":"format_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/rules_explainer":{"post":{"operationId":"rules_explainer","summary":"Plain-language explanations of specific cricket rules (powerplay, DRS, DLS/rain rule, super over, follow-on,","description":"Plain-language explanations of specific cricket rules (powerplay, DRS, DLS/rain rule, super over, follow-on,\n    LBW, no-ball/wide, Mankading). Use for \"what's DRS\", \"explain the follow-on rule\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"topic":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"A rule, e.g. powerplay, drs, dls, super_over, follow_on, lbw, no_ball_wide, mankading. Omit to list all.","title":"Topic"}},"title":"rules_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/cricket_glossary":{"post":{"operationId":"cricket_glossary","summary":"Definitions of common cricket terms (googly, yorker, maiden over, duck, strike rate, Orange/Purple Cap, ...).","description":"Definitions of common cricket terms (googly, yorker, maiden over, duck, strike rate, Orange/Purple Cap, ...).\n    Use for \"what does a googly mean\", \"what's the Orange Cap\".","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":"cricket_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}},"/v1/tools/trivia_quiz":{"post":{"operationId":"trivia_quiz","summary":"A fresh multiple-choice cricket trivia question, generated from this connector's own verified data (never a","description":"A fresh multiple-choice cricket trivia question, generated from this connector's own verified data (never a\n    separate, harder-to-verify question bank). Use for \"quiz me on cricket\", \"give me an IPL trivia question\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"category":{"anyOf":[{"type":"string"},{"type":"null"}],"default":null,"description":"ipl_champion | ipl_titles | world_cup | venue; omit for a random category.","title":"Category"},"seed":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Optional seed for a reproducible question.","title":"Seed"}},"title":"trivia_quizArguments","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}}}}