{"openapi":"3.1.0","info":{"title":"BALLDONTLIE NCAAW (BYOK) API","version":"0.1.0","description":"BALLDONTLIE NCAAW (BYOK) lets an AI assistant read your own BALLDONTLIE NCAAW data through the BALLDONTLIE NCAAW API with a key you supply (BALLDONTLIE API key). Read-only: 10 tools (list_conferences, list_teams, get_team, list_players, get_standings, list_games, get_game, get_rankings, list_player_season_stats, list_team_season_stats). The BYOK key travels with each request, is used for that one...\n\nEvery operation is read-only or compute-only. The same tools are available over MCP (streamable HTTP) at https://byok-balldontlie-ncaaw.connectorbay.com/mcp.","contact":{"name":"Unify Dynamics LLC","email":"agent@connectorbay.com","url":"https://connectorbay.com/byok-balldontlie-ncaaw/docs"},"termsOfService":"https://connectorbay.com/byok-balldontlie-ncaaw/terms"},"servers":[{"url":"https://byok-balldontlie-ncaaw.connectorbay.com"}],"externalDocs":{"url":"https://connectorbay.com/byok-balldontlie-ncaaw/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_conferences":{"post":{"operationId":"list_conferences","summary":"List NCAA women's basketball conferences. Use for \"Which conferences exist in NCAA women's basketball\".","description":"List NCAA women's basketball conferences. Use for \"Which conferences exist in NCAA women's basketball\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{},"title":"list_conferencesArguments","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 NCAA women's basketball teams, optionally of one conference. Use for \"Which teams are in NCAA women's basketball co","description":"List NCAA women's basketball teams, optionally of one conference. Use for \"Which teams are in NCAA women's basketball conference 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"conference_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by conference ID.","title":"Conference Id"}},"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":{"post":{"operationId":"get_team","summary":"Get one NCAA women's basketball team by id. Use for \"Show NCAA women's basketball team 1\".","description":"Get one NCAA women's basketball team by id. Use for \"Show NCAA women's basketball team 1\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"team_id":{"description":"Numeric team id as returned by the list endpoint.","title":"Team Id","type":"integer"}},"required":["team_id"],"title":"get_teamArguments","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 NCAA women's basketball players by name, team or position. Use for \"Find the college women's basketball player Pa","description":"Search NCAA women's basketball players by name, team or position. Use for \"Find the college women's basketball player Paige Bueckers\".","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"}},"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/get_standings":{"post":{"operationId":"get_standings","summary":"Show NCAA women's basketball standings for a season, optionally of one conference, with overall and conference records. ","description":"Show NCAA women's basketball standings for a season, optionally of one conference, with overall and conference records. Use for \"What are the NCAA women's basketball standings\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"conference_id":{"description":"Filter by conference ID (required).","title":"Conference Id","type":"integer"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Season year (e.g. 2025 for 2025-26 season).","title":"Season"}},"required":["conference_id"],"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_games":{"post":{"operationId":"list_games","summary":"List NCAA women's basketball games by date, team or season with status and scores. Use for \"What NCAA women's basketball","description":"List NCAA women's basketball games by date, team or season with status and scores. Use for \"What NCAA women's basketball games were played on 2026-03-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 (e.g. 2025 for 2025-26 season). One value.","title":"Season"},"start_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter games after this date (YYYY-MM-DD).","title":"Start Date"},"end_date":{"anyOf":[{"maxLength":200,"type":"string"},{"type":"null"}],"default":null,"description":"Filter games before this date (YYYY-MM-DD).","title":"End Date"}},"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 NCAA women's basketball game by id with teams, score and status. Use for \"Show the details of NCAA women's baske","description":"Get one NCAA women's basketball game by id with teams, score and status. Use for \"Show the details of NCAA women's basketball 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/get_rankings":{"post":{"operationId":"get_rankings","summary":"Show the NCAA women's basketball poll rankings of a season and week with record, points and trend. Use for \"Who is ranke","description":"Show the NCAA women's basketball poll rankings of a season and week with record, points and trend. Use for \"Who is ranked first in the NCAA women's basketball poll\".","tags":["tools"],"requestBody":{"required":true,"content":{"application/json":{"schema":{"properties":{"season":{"description":"Filter by season (e.g. 2025 for 2025-26 season). Required.","title":"Season","type":"integer"},"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"},"week":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by week number. Defaults to the latest available poll. The final poll follows the last regular-season week (week 21 for 2025–26).","title":"Week"}},"required":["season"],"title":"get_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}},"/v1/tools/list_player_season_stats":{"post":{"operationId":"list_player_season_stats","summary":"List season statistics of NCAA women's basketball players for a season. Use for \"What are the 2026 season stats of women","description":"List season statistics of NCAA women's basketball players for a season. Use for \"What are the 2026 season stats of women's college basketball player 1\".","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"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season (e.g. 2025 for 2025-26 season).","title":"Season"},"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"}},"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 season statistics of NCAA women's basketball teams for a season. Use for \"How did women's college basketball team 1","description":"List season statistics of NCAA women's basketball teams for a season. Use for \"How did women's college basketball team 1 shoot this 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"},"season":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by season (e.g. 2025 for 2025-26 season).","title":"Season"},"team_id":{"anyOf":[{"type":"integer"},{"type":"null"}],"default":null,"description":"Filter by team IDs. One value.","title":"Team Id"}},"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}}}}