{"openapi":"3.1.0","info":{"title":"Sportmonks Cricket (BYOK) API","version":"0.1.0","description":"Sportmonks Cricket (BYOK) lets an AI assistant read your own Sportmonks Cricket data through the Sportmonks Cricket API with a key you supply (Sportmonks API token). Read-only: 12 tools (list_leagues, list_seasons, list_stages, list_fixtures, get_fixture, list_livescores, list_teams, get_team_squad, list_players, list_venues, get_season_standings, get_team_rankings). The BYOK key travels with...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-sportmonks-cricket.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-sportmonks-cricket/docs"},"termsOfService":"https://connectorbay.com/byok-sportmonks-cricket/terms"},"servers":[{"url":"https://byok-sportmonks-cricket.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-sportmonks-cricket/docs"},"security":[{"upstreamKey":[]}],"components":{"securitySchemes":{"bearer":{"type":"http","scheme":"bearer","description":"Optional. A Pro API key raises rate limits; no credentials are required."},"upstreamKey":{"type":"apiKey","in":"header","name":"X-Upstream-Key","description":"Your own key for the service this connector wraps (bring your own key). Used for that one call only; never stored, logged or cached."}},"schemas":{"Error":{"type":"object","properties":{"ok":{"const":false},"error":{"type":"object"}}}}},"paths":{"/v1/tools/list_leagues":{"post":{"operationId":"list_leagues","summary":"List cricket leagues and tournaments with id, name, code, type and current season id. Use for \"Which cricket leagues doe","description":"List cricket leagues and tournaments with id, name, code, type and current season id. Use for \"Which cricket leagues does the API cover\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_leaguesArguments","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/list_seasons":{"post":{"operationId":"list_seasons","summary":"List cricket seasons with id, league id, name and code. Use for \"Which seasons exist for the Indian Premier League\".","description":"List cricket seasons with id, league id, name and code. Use for \"Which seasons exist for the Indian Premier League\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_seasonsArguments","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/list_stages":{"post":{"operationId":"list_stages","summary":"List cricket stages (rounds, groups, finals) with id, league, season, name and type. Use for \"What stages does season 52","description":"List cricket stages (rounds, groups, finals) with id, league, season, name and type. Use for \"What stages does season 525 have\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_stagesArguments","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/list_fixtures":{"post":{"operationId":"list_fixtures","summary":"List cricket fixtures with teams, start time, status, result note, venue, toss and winner; filter by league, season, sta","description":"List cricket fixtures with teams, start time, status, result note, venue, toss and winner; filter by league, season, status or a date range. Add include=localteam,visitorteam to get team names. Use for \"Which cricket matches are played between 2026-03-01 and 2026-03-15\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"league_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only fixtures of this league id.","title":"League Id"},"season_id":{"anyOf":[{"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"Only fixtures of this season id.","title":"Season Id"},"starts_between":{"anyOf":[{"maxLength":21,"type":"string"},{"type":"null"}],"default":null,"description":"Only fixtures starting in this range, two dates separated by a comma: YYYY-MM-DD,YYYY-MM-DD.","title":"Starts Between"},"status":{"anyOf":[{"maxLength":20,"type":"string"},{"type":"null"}],"default":null,"description":"Only fixtures with this status text, for example Finished or NS.","title":"Status"},"include":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Extra data to attach, comma separated, for example 'localteam,visitorteam,venue'. Options: balls runs bowling batting venue stage season league visitorteam localteam scoreboards firstumpire secondumpire referee manofseries manofmatch tosswon lineup.","title":"Include"},"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_fixturesArguments","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/get_fixture":{"post":{"operationId":"get_fixture","summary":"Get one cricket fixture by id with teams, start time, status, result note, venue, toss and winner; add include for score","description":"Get one cricket fixture by id with teams, start time, status, result note, venue, toss and winner; add include for scoreboards or batting detail. Use for \"What was the result of fixture 3\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"fixture_id":{"description":"Fixture id as returned by list_fixtures, for example 3.","title":"Fixture Id","type":"integer"},"include":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Extra data to attach, comma separated, for example 'localteam,visitorteam,venue'. Options: balls runs bowling batting venue stage season league visitorteam localteam scoreboards firstumpire secondumpire referee manofseries manofmatch tosswon lineup.","title":"Include"}},"required":["fixture_id"],"title":"get_fixtureArguments","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/list_livescores":{"post":{"operationId":"list_livescores","summary":"List the cricket matches in play now with teams, status and result note. Add include=localteam,visitorteam,runs for team","description":"List the cricket matches in play now with teams, status and result note. Add include=localteam,visitorteam,runs for teams and runs. Use for \"Which cricket matches are live right now\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"include":{"anyOf":[{"maxLength":120,"type":"string"},{"type":"null"}],"default":null,"description":"Extra data to attach, comma separated, for example 'localteam,visitorteam,venue'. Options: balls runs bowling batting venue stage season league visitorteam localteam scoreboards firstumpire secondumpire referee manofseries manofmatch tosswon lineup.","title":"Include"}},"title":"list_livescoresArguments","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/list_teams":{"post":{"operationId":"list_teams","summary":"List cricket teams with id, name, code, country and whether it is a national team. Use for \"Which national cricket teams","description":"List cricket teams with id, name, code, country and whether it is a national team. Use for \"Which national cricket teams are listed\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_teamsArguments","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/get_team_squad":{"post":{"operationId":"get_team_squad","summary":"Get a cricket team's squad for one season: the team record with its players and their roles. Use for \"Who is in team 47'","description":"Get a cricket team's squad for one season: the team record with its players and their roles. Use for \"Who is in team 47's squad for season 10\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team_id":{"description":"Team id as returned by list_teams, for example 47.","title":"Team Id","type":"integer"},"season_id":{"description":"Season id as returned by list_seasons, for example 10.","title":"Season Id","type":"integer"}},"required":["team_id","season_id"],"title":"get_team_squadArguments","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/list_players":{"post":{"operationId":"list_players","summary":"List cricket players with name, country, gender, batting and bowling style and role. Use for \"Which cricket players are ","description":"List cricket players with name, country, gender, batting and bowling style and role. Use for \"Which cricket players are in the database\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_playersArguments","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/list_venues":{"post":{"operationId":"list_venues","summary":"List cricket venues with name, city, country, capacity and floodlight flag. Use for \"Which cricket grounds have floodlig","description":"List cricket venues with name, city, country, capacity and floodlight flag. Use for \"Which cricket grounds have floodlights\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"page":{"anyOf":[{"maximum":10000,"minimum":1,"type":"integer"},{"type":"null"}],"default":1,"description":"Page number, starting at 1.","title":"Page"}},"title":"list_venuesArguments","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/get_season_standings":{"post":{"operationId":"get_season_standings","summary":"Get a cricket season's league table: position, points, matches played, won, lost, net run rate and recent form per team.","description":"Get a cricket season's league table: position, points, matches played, won, lost, net run rate and recent form per team. Use for \"What is the table for season 525\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season_id":{"description":"Season id as returned by list_seasons, for example 525.","title":"Season Id","type":"integer"}},"required":["season_id"],"title":"get_season_standingsArguments","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/get_team_rankings":{"post":{"operationId":"get_team_rankings","summary":"Get the global international cricket team rankings: for each format and gender the ranked teams with position, matches, ","description":"Get the global international cricket team rankings: for each format and gender the ranked teams with position, matches, points and rating. Use for \"Which team is ranked first in Test cricket\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"get_team_rankingsArguments","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}}}}