Balldontlie MCP Server
About
An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB
Details
- License
- MIT
Explore
- Get teams for NBA, MLB, or NFL leagues
- Search players with optional first/last name filters
- Retrieve games by date(s), team IDs, and pagination cursor
- Fetch details of a single game by its ID
- Interactive schedule generator prompt for Claude Desktop
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Balldontlie MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
1. Sign up for account at Balldontlie.io
2. The free plan is enough for this MCP Server
1. Download the dxt file from the Releases
2. Open it with Claude Desktop
or
Go to File -> Settings -> Extensions and drag the .DXT file to the window to install it
To install balldontlie-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude
Add this to your claude_desktop_config.json:
{
"mcp-servers": {
"balldontlie": {
"command": "npx",
"args": [
"-y",
"balldontlie-mcp"
],
"env": {
"BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
}
}
}
}
mcpServers:
balldontlie:
command: sh
args:
- -c
- BALLDONTLIE_API_KEY=your-api-key-here npx -y balldontlie-mcp
A hosted deployment is available on Fronteir AI.
league
(enum ['NBA', 'NFL', 'MLB']): The sports league to get teams 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
dates
(string[], optional): Get games for specific dates, format: YYYY-MM-DD
teamIds
(string[], optional): Get games for specific games
gameId
(number): The id of the game from the get_games tool
- 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
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"balldontlie mcp server": {
"balldontlie-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mikechao/balldontlie-mcp",
"--client",
"claude"
]
}
}
}
}McpServers
{
"balldontlie-mcp": {
"command": "npx",
"args": [
"-y",
"@smithery/cli",
"install",
"@mikechao/balldontlie-mcp",
"--client",
"claude"
]
}
}
<a href="https://glama.ai/mcp/servers/@mikechao/balldontlie-mcp">
</a>
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
Prompts
- schedule_generator
Given a league (NBA, MLB, NFL), a starting date and ending date generates an interactive schedule in Claude Desktop.
Sample queries
With this MCP Server installed you can ask Claude or other LLM questions like the following.
Show me today's baseball games.
Can you find football players with the last name Purdy?
How many NBA players have the last name Ming?
Configuration
Getting an API Key
1. Sign up for account at Balldontlie.io
2. The free plan is enough for this MCP Server
Installing using Desktop Extension (DXT)
1. Download the dxt file from the Releases
2. Open it with Claude Desktop
or
Go to File -> Settings -> Extensions and drag the .DXT file to the window to install it
Installing via Smithery
To install balldontlie-mcp for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude
Usage with Claude Desktop
Add this to your claude_desktop_config.json:
{
"mcp-servers": {
"balldontlie": {
"command": "npx",
"args": [
"-y",
"balldontlie-mcp"
],
"env": {
"BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
}
}
}
}
Usage with LibreChat
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.
Hosted deployment
A hosted deployment is available on Fronteir AI.
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
