MCP Catalogs
← Homeballdontlie-mcp screenshot

balldontlie-mcp

by mikechao·★ 23·Score 43

MCP server providing NBA, NFL, and MLB player, team, and game data via Balldontlie API.

ai-llmother
11
Forks
0
Open issues
2 mo ago
Last commit
2d ago
Indexed

Overview

This MCP server integrates with the Balldontlie API to provide comprehensive sports information for three major American leagues: NBA (basketball), NFL (football), and MLB (baseball). It offers four main tools for retrieving team data, player information, game lists, and specific game details, along with a prompt for generating interactive schedules. The server supports pagination through cursors and allows filtering by specific dates, teams, and player names.

Try asking AI

After installing, here are 6 things you can ask your AI assistant:

you:Get today's basketball, football or baseball games and schedules
you:Search for specific players by name across major sports leagues
you:Generate interactive sports schedules for specific date ranges
you:What leagues are supported by this MCP server?
you:Is an API key required to use this server?
you:Can I search for specific players?

When to choose this

Choose this server when you need quick access to NBA, NFL, and MLB sports data through an MCP interface without building custom API integrations.

When NOT to choose this

Don't choose this if you need data from international leagues beyond the three supported American sports, or if you require historical data beyond what Balldontlie API provides.

Tools this server exposes

4 tools extracted from the README
  • get_teams

    Gets the list of teams from NBA, NFL, or MLB

  • get_players

    Gets the list of players from NBA, NFL, or MLB

  • get_games

    Gets the list of games from NBA, NFL, or MLB

  • get_game

    Get a specific game by ID from NBA, NFL, or MLB

Comparable tools

sports-data-api-mcpnbadata-mcpespn-api-mcp

Installation

Installation

Getting an API Key

  1. Sign up for account at [Balldontlie.io](https://www.balldontlie.io/)
  2. The free plan is enough for this MCP Server

Installing via 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"
      }
    }
  }
}

Installing using Desktop Extension (DXT)

  1. Download the dxt file from the [Releases](https://github.com/mikechao/balldontlie-mcp/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](https://smithery.ai/server/@mikechao/balldontlie-mcp):

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

FAQ

What leagues are supported by this MCP server?
The server supports data from three major American sports leagues: NBA (National Basketball Association), NFL (National Football League), and MLB (Major League Baseball).
Is an API key required to use this server?
Yes, you need to sign up for a free API key at balldontlie.io to use this MCP server. The free plan is sufficient for basic usage.
Can I search for specific players?
Yes, you can use the get_players tool to search for players by first name, last name, or both across the supported leagues.

Compare balldontlie-mcp with

balldontlie-mcp vs ultimate_mcp_serverballdontlie-mcp vs mcp-server-chartballdontlie-mcp vs everythingballdontlie-mcp vs memoryballdontlie-mcp vs fetch
GitHub →

Last updated · Auto-generated from public README + GitHub signals.