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

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.

Install Server

HTTP connection URL

security – no known vulnerabilities

license - permissive license

quality - confirmed to work

How are these scores calculated?

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.

Related Resources

Reddit Discussion about this server

Related MCP Servers

cfbd-mcp-server
lenwood
A
security
A
license
A
quality
An MCP server providing access to college football statistics sourced from the College Football Data API within Claude Desktop.
Last updated -
9
9
Python
MIT License
mcp-server-datadog
winor30
A
security
A
license
A
quality
The MCP server provides an interface to the Datadog API, enabling seamless management of incidents, monitoring, logs, dashboards, metrics, traces, and hosts. Its extensible design allows easy integration of additional Datadog APIs for future expansions.
Last updated -
14
748
77
TypeScript
Apache 2.0
Unstructured API MCP Serverofficial
Unstructured-IO
A
security
F
license
A
quality
An MCP server implementation that enables interaction with the Unstructured API, providing tools to list, create, update, and manage sources, destinations, and workflows.
Last updated -
39
28
Fantasy Premier League MCP Server
rishijatia
-
security
A
license
-
quality
A Model Context Protocol server that provides access to Fantasy Premier League data, allowing users to compare players, find team information, view gameweek data, and get FPL-related advice through Claude for Desktop and other MCP-compatible clients.
Last updated -
7
Python
MIT License

View all related MCP servers

Appeared in Searches

Understanding and Using the Browser Console