Skip to main content
Glama

balldontlie-mcp

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

Prompts

  • schedule_generator

Given a league (NBA, MLB, NFL), a starting date and ending date generates an interactive schedule in Claude Desktop.

claude desktop example

Configuration

Getting an API Key

  1. Sign up for account at 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:

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.

Install Server
A
security – no known vulnerabilities
A
license - permissive license
A
quality - confirmed to work

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.

  1. Tools
    1. Prompts
      1. Configuration
        1. Getting an API Key
        2. Installing via Smithery
        3. Usage with Claude Desktop
        4. Usage with LibreChat
      2. License
        1. Disclaimer

          Related MCP Servers

          • -
            security
            A
            license
            -
            quality
            An open-source MCP server that connects to the SoccerDataAPI to deliver up-to-date football match information via natural language interactions.
            Last updated -
            16
            Python
            MIT License
            • Apple
          • -
            security
            F
            license
            -
            quality
            An 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
          • -
            security
            F
            license
            -
            quality
            An 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
          • -
            security
            A
            license
            -
            quality
            Python 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 -
            16
            Python
            MIT License
            • Apple

          View all related MCP servers

          MCP directory API

          We provide all the information about MCP servers via our MCP API.

          curl -X GET 'https://glama.ai/api/mcp/v1/servers/mikechao/balldontlie-mcp'

          If you have feedback or need assistance with the MCP directory API, please join our Discord server