Balldontlie MCP Server

By mikechao GitHub

An MCP Server implementation that integrates the Balldontlie API, to provide information about players, teams and games for the NBA, NFL and MLB

nba nfl

Overview

What is Balldontlie MCP Server?

Balldontlie MCP Server is an implementation that integrates the Balldontlie API, providing information about players, teams, and games for the NBA, NFL, and MLB.

How to use Balldontlie MCP Server?

To use the Balldontlie MCP Server, you need to sign up for an API key at Balldontlie.io and configure it in your application. You can then use commands to get teams, players, and games from the respective leagues.

Key features of Balldontlie MCP Server?

Access to comprehensive data about NBA, NFL, and MLB players and teams.
Ability to retrieve game schedules and specific game details.
Supports pagination for large datasets.

Use cases of Balldontlie MCP Server?

Fetching team rosters for sports analytics.
Displaying upcoming games for sports applications.
Integrating player statistics into fantasy sports platforms.

FAQ from Balldontlie MCP Server?

Is the Balldontlie MCP Server free to use?

Yes! The free plan at Balldontlie.io is sufficient for this MCP Server.

Can I modify the Balldontlie MCP Server?

Yes! It is licensed under the MIT License, allowing you to modify and distribute it as per the license terms.

Is this project officially associated with Balldontlie?

No, this is a third-party implementation and is not officially associated with balldontlie.io.

Content

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 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

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:

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.

No tools information available.

No content found.