https://github.com/mikechao/balldontlie-mcp
An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB
https://github.com/mikechao/balldontlie-mcp
mcp-server mlb model-context-protocol nba nfl
Last synced: 6 months ago
JSON representation
An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB
- Host: GitHub
- URL: https://github.com/mikechao/balldontlie-mcp
- Owner: mikechao
- License: mit
- Created: 2025-04-08T17:55:06.000Z (6 months ago)
- Default Branch: main
- Last Pushed: 2025-04-15T21:38:05.000Z (6 months ago)
- Last Synced: 2025-04-15T22:27:46.422Z (6 months ago)
- Topics: mcp-server, mlb, model-context-protocol, nba, nfl
- Language: JavaScript
- Homepage:
- Size: 77.1 KB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
- awesome-mcp-servers - Balldontlie Mcp - An MCP Server implementation that integrates the Balldontlie API, providing information about NBA, NFL, and MLB players, teams, and games. ([Read more](/details/balldontlie-mcp.md)) `mcp` `sports` `api-integration` `nba` (API Integration MCP Servers)
- awesome-mcp-zh - mikechao/balldontlie-mcp
- awesome-mcp-servers - mikechao/balldontlie-mcp - balldontlie APIと統合してNBA、NFL、MLBの選手、チーム、試合情報を提供するMCPサーバー (サーバー実装 / 🏃 <a name="sports"></a>スポーツ)
- mcp-index - Balldontlie Sports Data Server - Provides up-to-date information about players, teams, and games for the NBA, NFL, and MLB. Queries detailed sports data dynamically to enhance applications or agents with real-time sports insights. (Data Analytics)
README
# Balldontlie MCP Server
[](https://smithery.ai/server/@mikechao/balldontlie-mcp)
An MCP Server implementation that integrates the [Balldontlie API](https://www.balldontlie.io/), 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 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 for the NBA, NFL or MLB
- 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, MLB, NFL
- 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
## Configuration
### Getting an API Key
1. Sign up for account at [Balldontlie.io](https://www.balldontlie.io/)
2. The free plan is enough for this MCP Server
### Installing via Smithery
To install balldontlie-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mikechao/balldontlie-mcp):
```bash
npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude
```
### Usage with Claude Desktop
Add this to your `claude_desktop_config.json`:
```json
{
"mcp-servers": {
"balldontlie": {
"command": "npx",
"args": [
"-y",
"balldontlie-mcp"
],
"env": {
"BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
}
}
}
}
```
### Usage with LibreChat
```yaml
mcpServers:
balldontlie:
command: sh
args:
- "-c"
- "BALLDONTLIE_API_KEY=your-api-key-here npx -y balldontlie-mcp"
```
## 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.