Back to MCP Directory
Balldontlie
Model Context Protocol low risk

Balldontlie

Provides access to NBA, NFL, and MLB data via the Balldontlie API, enabling retrieval of information on teams, players, and games.

Connections & Capabilities

Connects To

GitHub

Capabilities

read

Quickstart

Install

npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude

Config

{
  "mcp-servers": {
    "balldontlie": {
      "command": "npx",
      "args": [
        "-y",
        "balldontlie-mcp"
      ],
      "env": {
        "BALLDONTLIE_API_KEY": "YOUR API KEY HERE"
      }
    }
  }
}

Exposed MCP Tools (4)

safe
get_teams

Retrieves a list of sports teams for a specified league.

Read-only operation; no data modification.

safe
get_players

Retrieves a list of players for a specified league, with optional filtering by first and last name.

Read-only operation; no data modification.

safe
get_games

Retrieves a list of games for a specified league, with optional filtering by dates and team IDs.

Read-only operation; no data modification.

safe
get_game

Retrieves a specific game from a specified league by its ID.

Read-only operation; no data modification.

Safety Assessment

This MCP server is relatively safe due to its read-only nature and reliance on an external API. However, users should ensure they securely manage their Balldontlie API key and be aware of potential rate limits and API availability issues.

  • Read-only operations
  • No direct system access
  • Relies on a third-party API for data
  • No user data stored or managed
  • Dependence on external API availability and security
  • Potential for API key exposure if not handled securely
  • Rate limiting by the external API could impact performance
  • Limited error handling documented