The balldontlie-mcp server integrates the Balldontlie API to provide sports data for NBA, NFL, and MLB leagues. With this server, you can:
- Retrieve lists of teams for a specified league
- Fetch player lists with optional filters for name and pagination
- Obtain game lists with filters for dates, teams, seasons, and pagination
- Access specific game details using game ID and league
- Generate interactive league schedules within Claude Desktop for a given date range
Enables access to MLB information through the Balldontlie API, allowing retrieval of team data, player profiles, and game statistics including specific games or games filtered by dates and teams.
Provides access to NBA information through the Balldontlie API, allowing retrieval of team data, player profiles, and game statistics including specific games or games filtered by dates and teams.
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
- Get a list of teams for the NBA, NFL or MLB
- Inputs:
league
(enum ['NBA', 'NFL', 'MLB']): The sports league to get teams for
- get_players
- Gets a list of players for the NBA, NFL or MLB
- Inputs:
league
(enum ['NBA', 'NFL', 'MLB']): The sports league to get players forfirstName
(string, optional): The first name of the player to search forlastName
(string, optional): The last name of the player to search forcursor
(number, optional): Cursor for pagination
- get_games
- Gets the list of games for the NBA, NFL or MLB
- Inputs:
league
(enum ['NBA', 'NFL', 'MLB']): The sports league to get games fordates
(string[], optional): Get games for specific dates, format: YYYY-MM-DDteamIds
(string[], optional): Get games for specific gamescursor
(number, optional): Cursor for pagination
- get_game
- Get a specific game from one of the following leagues NBA, MLB, NFL
- Inputs:
league
(enum ['NBA', 'NFL', 'MLB']): The sports league to get the game forgameId
(number): The id of the game from the get_games tool
Prompts
- schedule_generator
Given a league (NBA, MLB, NFL), a starting date and ending date generates an interactive schedule in Claude Desktop.
Configuration
Getting an API Key
- Sign up for account at Balldontlie.io
- The free plan is enough for this MCP Server
Installing via Smithery
To install balldontlie-mcp for Claude Desktop automatically via Smithery:
Usage with Claude Desktop
Add this to your claude_desktop_config.json
:
Usage with LibreChat
License
This MCP server is licensed under the MIT License. This means you are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.
Disclaimer
This library is not officially associated with balldontlie.io. It is a third-party implementation of the balldontlie api with a MCP Server.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB.
Related Resources
Related MCP Servers
- -securityAlicense-qualityAn open-source MCP server that connects to the SoccerDataAPI to deliver up-to-date football match information via natural language interactions.Last updated -16PythonMIT License
- -securityFlicense-qualityAn MCP server that enables interaction with MLB (Major League Baseball) v3 projections through the SportsData.io API, allowing access to baseball statistics and projections through natural language.Last updated -Python
- -securityFlicense-qualityAn MCP Server that enables interaction with MLB scores and statistics via the SportsData.io MLB V3 Scores API, allowing users to access baseball data through natural language queries.Last updated -Python
- -securityAlicense-qualityPython MCP server that provides comprehensive access to MLB statistics and baseball data through a FastAPI-based interface. Acts as a bridge between AI applications and MLB data sources, enabling seamless integration of baseball statistics, game information, player data, and more.Last updated -16PythonMIT License