{"openapi":"3.1.0","info":{"title":"BALLDONTLIE WNBA (BYOK) API","version":"0.1.0","description":"BALLDONTLIE WNBA (BYOK) lets an AI assistant read your own BALLDONTLIE WNBA data through the BALLDONTLIE WNBA API with a key you supply (BALLDONTLIE API key). Read-only: 10 tools (list_teams, list_players, list_active_players, list_games, get_game, list_player_stats, list_player_season_stats, list_team_season_stats, get_standings, list_player_injuries). The BYOK key travels with each request, is...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-balldontlie-wnba.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-balldontlie-wnba/docs"},"termsOfService":"https://connectorbay.com/byok-balldontlie-wnba/terms"},"servers":[{"url":"https://byok-balldontlie-wnba.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-balldontlie-wnba/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_teams":{"post":{"operationId":"list_teams","summary":"List the WNBA teams with city, conference and abbreviation; optionally only one conference. Use for \"Which teams play in","description":"List the WNBA teams with city, conference and abbreviation; optionally only one conference. Use for \"Which teams play in the WNBA Eastern conference\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"conference":{"anyOf":[{"enum":["Eastern","Western"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter by conference.","title":"Conference"}},"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/list_players":{"post":{"operationId":"list_players","summary":"Search WNBA players by name or team with position, height, weight, jersey number, college and age. Use for \"Find the WNB","description":"Search WNBA players by name or team with position, height, weight, jersey number, college and age. Use for \"Find the WNBA player A'ja Wilson\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"player_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by player IDs. One value.","title":"Player Id"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Search by player name.","title":"Search"},"first_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by first name.","title":"First Name"},"last_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by last name.","title":"Last Name"}},"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_active_players":{"post":{"operationId":"list_active_players","summary":"List players currently on WNBA rosters, filterable by team or name. Use for \"Who is on the active roster of team 1 in th","description":"List players currently on WNBA rosters, filterable by team or name. Use for \"Who is on the active roster of team 1 in the WNBA\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"player_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by player IDs. One value.","title":"Player Id"},"search":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Search by player name.","title":"Search"},"first_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by first name.","title":"First Name"},"last_name":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by last name.","title":"Last Name"}},"title":"list_active_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_games":{"post":{"operationId":"list_games","summary":"List WNBA games by date, date range, team, season or season type, with status, period and scores. Use for \"What were the","description":"List WNBA games by date, date range, team, season or season type, with status, period and scores. Use for \"What were the WNBA game scores on 2025-09-01\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by dates (YYYY-MM-DD). One value.","title":"Date"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by seasons. One value.","title":"Season"},"start_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter games after this date.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter games before this date.","title":"End Date"},"season_type":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by season type.","title":"Season Type"}},"title":"list_gamesArguments","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_game":{"post":{"operationId":"get_game","summary":"Get one WNBA game by id with teams, score, period, status and time. Use for \"Show the details of WNBA game 1\".","description":"Get one WNBA game by id with teams, score, period, status and time. Use for \"Show the details of WNBA game 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"game_id":{"description":"Numeric game id as returned by the list endpoint.","title":"Game Id","type":"integer"}},"required":["game_id"],"title":"get_gameArguments","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_player_stats":{"post":{"operationId":"list_player_stats","summary":"List per-game box score lines of WNBA players, filterable by player, team, game, date or season. Use for \"How many point","description":"List per-game box score lines of WNBA players, filterable by player, team, game, date or season. Use for \"How many points and rebounds did WNBA player 1 have in recent games\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"player_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by player IDs. One value.","title":"Player Id"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"game_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by game IDs. One value.","title":"Game Id"},"date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter by dates (YYYY-MM-DD). One value.","title":"Date"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by seasons. One value.","title":"Season"},"start_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter stats after this date.","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter stats before this date.","title":"End Date"}},"title":"list_player_statsArguments","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_player_season_stats":{"post":{"operationId":"list_player_season_stats","summary":"List season totals or averages of WNBA players for a season, filterable by player and team. Use for \"What were the seaso","description":"List season totals or averages of WNBA players for a season, filterable by player and team. Use for \"What were the season stats of WNBA player 1 in 2025\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"player_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by player IDs. One value.","title":"Player Id"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season.","title":"Season"},"season_type":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season type.","title":"Season Type"}},"title":"list_player_season_statsArguments","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_team_season_stats":{"post":{"operationId":"list_team_season_stats","summary":"List WNBA team season totals such as shooting percentages, rebounds and games played. Use for \"How did WNBA team 1 shoot","description":"List WNBA team season totals such as shooting percentages, rebounds and games played. Use for \"How did WNBA team 1 shoot over the 2025 season\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season.","title":"Season"},"season_type":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season type.","title":"Season Type"}},"title":"list_team_season_statsArguments","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_standings":{"post":{"operationId":"get_standings","summary":"Show WNBA standings for a season with wins, losses, win percentage, games behind and home and away records. Use for \"Wha","description":"Show WNBA standings for a season with wins, losses, win percentage, games behind and home and away records. Use for \"What are the current WNBA standings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season.","title":"Season"},"conference":{"anyOf":[{"enum":["Eastern","Western"],"type":"string"},{"type":"null"}],"default":null,"description":"Filter by conference.","title":"Conference"}},"title":"get_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/list_player_injuries":{"post":{"operationId":"list_player_injuries","summary":"List reported WNBA player injuries with status, expected return date and comment. Use for \"Which WNBA players are curren","description":"List reported WNBA player injuries with status, expected return date and comment. Use for \"Which WNBA players are currently injured\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"cursor":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Pagination cursor: pass the next_cursor value from the previous answer to get the following page.","title":"Cursor"},"per_page":{"anyOf":[{"maximum":100,"minimum":1,"type":"integer"},{"type":"null"}],"default":null,"description":"How many results to return per page (1 to 100).","title":"Per Page"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"},"player_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by player IDs. One value.","title":"Player Id"}},"title":"list_player_injuriesArguments","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}}}}