mikechao/balldontlie-mcp

Balldontlie MCP Server

An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB.

Tools

• get_teams

  • Gets the list of team from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
  • Inputs:
    • league (enum ['NBA', 'NFL', 'MLB']): The sports league to get teams for

• get_players

  • Gets the list of players from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
  • Inputs:
    • league (enum ['NBA', 'NFL', 'MLB']): The sports league to get players for
    • firstName (string, optional): The first name of the player to search for
    • lastName (string, optional): The last name of the player to search for
    • cursor (number, optional): Cursor for pagination

• get_games

  • Gets the list of games from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
  • Inputs:
    • league (enum ['NBA', 'NFL', 'MLB']): The sports league to get games for
    • dates (string[], optional): Get games for specific dates, format: YYYY-MM-DD
    • teamIds (string[], optional): Get games for specific games
    • cursor (number, optional): Cursor for pagination

• get_game

  • Get a specific game from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
  • Inputs:
    • league (enum ['NBA', 'NFL', 'MLB']): The sports league to get the game for
    • gameId (number): The id of the game from the get_games tool