balldontlie-mcp is an MCP (Model Context Protocol) server implementation that integrates the Balldontlie API to provide player, team, and game information for the NBA (National Basketball Association), NFL (National Football League), and MLB (Major League Baseball). This implementation is provided by a third party and is not officially affiliated with balldontlie.io.
Main capabilities:
- get_teams: Get the list of teams for a specified league. Input parameter league (enum ['NBA', 'NFL', 'MLB']), indicating the sports league for which to get teams.
- get_players: Get the list of players for a specified league. Input parameters: league (enum ['NBA', 'NFL', 'MLB']), indicating the sports league for which to get players; firstName (string, optional), the player's first name to search for; lastName (string, optional), the player's last name to search for; cursor (number, optional), the cursor used for pagination.
- get_games: Get the list of games for a specified league. Input parameters: league (enum ['NBA', 'NFL', 'MLB']), indicating the sports league for which to get games; dates (string array, optional), get games on specific dates, in the format YYYY-MM-DD; teamIds (string array, optional), get games for specific teams; cursor (number, optional), the cursor used for pagination.
- get_game: Get a specific game in a specified league. Input parameters: league (enum ['NBA', 'NFL', 'MLB']), indicating the sports league for which to get the game; gameId (number), the game id from the get_games tool.
- schedule_generator: Given a league (NBA, MLB, NFL), a start date, and an end date, generate an interactive schedule in Claude Desktop.
Usage:
After installing this MCP server, you can ask Claude or other LLMs related questions. Before installation, you need to obtain an API Key: register an account at Balldontlie.io; the free plan is sufficient for the needs of this MCP server.
Installation methods include:
- Install using the desktop extension (DXT): from Releases download the dxt file, open it with Claude Desktop, or go to File -> Settings -> Extensions and drag the .DXT file into the window to install.
- Install via Smithery: automatically install balldontlie-mcp for Claude Desktop via Smithery.
- Use with Claude Desktop: add the configuration to claude_desktop_config.json.
- Use with LibreChat.
A hosted deployment is also available on Fronteir AI.
Applicable scenarios: When you need to query NBA, NFL, or MLB team, player, or game information or generate schedules through an LLM, you can use this MCP server to connect to the Balldontlie API to obtain data.
Limitations: This library is not officially affiliated with balldontlie.io; it is a third-party implementation of the balldontlie api and MCP Server. The project uses the MIT license and can be freely used, modified, and distributed; see the LICENSE file for specific terms. More limitations of the API free plan, whether charges or pricing are involved, and the specific usage results are not provided in the materials.
