Balldontlie MCP Server

1# Balldontlie MCP Server
2 
3[![smithery badge](https://smithery.ai/badge/@mikechao/balldontlie-mcp)](https://smithery.ai/server/@mikechao/balldontlie-mcp)
4 
5[![Verified on MseeP](https://mseep.ai/badge.svg)](https://mseep.ai/app/07e29bcd-3fb7-46e6-b4b9-8908b3ef18f2)
6 
7[![MseeP.ai Security Assessment Badge](https://mseep.net/pr/mikechao-balldontlie-mcp-badge.png)](https://mseep.ai/app/mikechao-balldontlie-mcp)
8 
9<a href="https://glama.ai/mcp/servers/@mikechao/balldontlie-mcp">
10  <img width="380" height="200" src="https://glama.ai/mcp/servers/@mikechao/balldontlie-mcp/badge" alt="balldontlie-mcp MCP server" />
11</a>
12 
13An 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.
14 
15## Tools
16 
17- **get_teams**
18 
19  - Gets the list of team from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
20  - Inputs:
21    - `league` (enum ['NBA', 'NFL', 'MLB']): The sports league to get teams for
22 
23- **get_players**
24 
25  - Gets the list of players from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
26  - Inputs:
27    - `league` (enum ['NBA', 'NFL', 'MLB']): The sports league to get players for
28    - `firstName` (string, optional): The first name of the player to search for
29    - `lastName` (string, optional): The last name of the player to search for
30    - `cursor` (number, optional): Cursor for pagination
31 
32- **get_games**
33 
34  - Gets the list of games from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
35  - Inputs:
36    - `league` (enum ['NBA', 'NFL', 'MLB']): The sports league to get games for
37    - `dates` (string[], optional): Get games for specific dates, format: YYYY-MM-DD
38    - `teamIds` (string[], optional): Get games for specific games
39    - `cursor` (number, optional): Cursor for pagination
40 
41- **get_game**
42 
43  - Get a specific game from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
44  - Inputs:
45    - `league` (enum ['NBA', 'NFL', 'MLB']): The sports league to get the game for
46    - `gameId` (number): The id of the game from the get_games tool
47 
48## Prompts
49 
50- **schedule_generator**
51 
52Given a league (NBA, MLB, NFL), a starting date and ending date generates an interactive schedule in Claude Desktop.
53 
54![claude desktop example](https://mikechao.github.io/images/schedule_geneartor_prompt.webp)
55 
56## Sample queries
57 
58With this MCP Server installed you can ask Claude or other LLM questions like the following.
59 
60```
61Show me today's baseball games.
62Can you find football players with the last name Purdy?
63How many NBA players have the last name Ming?
64```
65 
66## Configuration
67 
68### Getting an API Key
69 
701. Sign up for account at [Balldontlie.io](https://www.balldontlie.io/)
712. The free plan is enough for this MCP Server
72 
73### Installing using Desktop Extension (DXT)
74 
751. Download the `dxt` file from the [Releases](https://github.com/mikechao/balldontlie-mcp/releases)
762. Open it with Claude Desktop
77   or
78   Go to File -> Settings -> Extensions and drag the .DXT file to the window to install it
79 
80### Installing via Smithery
81 
82To install balldontlie-mcp for Claude Desktop automatically via [Smithery](https://smithery.ai/server/@mikechao/balldontlie-mcp):
83 
84```bash
85npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude
86```
87 
88### Usage with Claude Desktop
89 
90Add this to your `claude_desktop_config.json`:
91 
92```json
93{
94  "mcp-servers": {
95    "balldontlie": {
96      "command": "npx",
97      "args": [
98        "-y",
99        "balldontlie-mcp"
100      ],
101      "env": {
102        "BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
103      }
104    }
105  }
106}
107```
108 
109### Usage with LibreChat
110 
111```yaml
112mcpServers:
113  balldontlie:
114    command: sh
115    args:
116      - -c
117      - BALLDONTLIE_API_KEY=your-api-key-here npx -y balldontlie-mcp
118```
119 
120## License
121 
122This 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.
123 
124## Disclaimer
125 
126This library is not officially associated with balldontlie.io. It is a third-party implementation of the balldontlie api with a MCP Server.
127