Balldontlie MCP Server

Balldontlie MCP Server

Sports data access via Model Context Protocol for LLMs

View on GitHub
18
Stars
10
Forks
18
Watchers
1
Issues
Balldontlie MCP Server provides an MCP-compliant interface to the Balldontlie API, offering NBA, NFL, and MLB data to downstream AI models and applications. It supports retrieving information about teams, players, and games, and includes features like schedule generation for various leagues. The server is easily installable via Claude Desktop, Smithery, or LibreChat, and integrates with LLMs to allow natural-language sports queries.

Key Features

MCP server implementation
Supports NBA, NFL, and MLB leagues
Retrieve teams, players, and games data
Schedule generation prompt
Integration with Claude Desktop and LibreChat
API key authentication with Balldontlie
Smithery installer support
Interactive schedule creation
Sample queries for easy use
Pagination and search filtering for players and games

Use Cases

Getting up-to-date lists of teams across major US sports leagues
Finding specific players by name in NBA, NFL, or MLB
Querying daily game schedules across leagues
Generating interactive sports calendars within AI chat clients
Enabling sports-related natural-language queries for LLM users
Integrating sports data into chatbots and virtual assistants
Creating custom sports dashboards powered by Balldontlie
Researching player stats for fantasy sports applications
Enriching AI model context with real-time sports event data
Automating sports information retrieval for conversational AI interfaces

README

Balldontlie MCP Server

smithery badge

Verified on MseeP

MseeP.ai Security Assessment Badge

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

    • Gets the list of team from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
    • Inputs:
      • league (enum ['NBA', 'NFL', 'MLB']): The sports league to get teams for

  • get_players

    • Gets the list of players from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
    • 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 from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
    • 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 (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)
    • 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

Sample queries

With this MCP Server installed you can ask Claude or other LLM questions like the following.

Show me today's baseball games.
Can you find football players with the last name Purdy?
How many NBA players have the last name Ming?

Configuration

Getting an API Key

  1. Sign up for account at Balldontlie.io
  2. The free plan is enough for this MCP Server

Installing using Desktop Extension (DXT)

  1. Download the dxt file from the 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:

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

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

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

Usage with LibreChat

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

Star History

Star History Chart

Repository Owner

mikechao
mikechao

User

Repository Details

Language JavaScript
Default Branch main
Size 241 KB
Contributors 4
License MIT License
MCP Verified Nov 12, 2025

Programming Languages

JavaScript
71.95%
TypeScript
25.44%
Dockerfile
2.61%

Tags

sports data llm-integration natural language queries

Topics

mcp-server mlb model-context-protocol nba nfl

Join Our Newsletter

Stay updated with the latest AI tools, news, and offers by subscribing to our weekly newsletter.

We respect your privacy. Unsubscribe at any time.

Related MCPs

Discover similar Model Context Protocol servers

  • AFL MCP Server

    AFL MCP Server

    MCP-compatible server for comprehensive AFL data and analytics

    AFL MCP Server is a Model Context Protocol-compatible backend that serves detailed Australian Football League data via the Squiggle API. It offers standardized access to live scores, historical match results, team information, rankings, tips, projections, and advanced analytics. Designed for integration with MCP clients such as Claude for Desktop, it exposes a suite of tools for retrieving game, standings, and team data. The server streamlines AFL data retrieval through automated protocols, facilitating robust AI-powered workflows.

    • ⭐ 14
    • MCP
    • willvelida/mcp-afl-server
  • Teamwork MCP Server

    Teamwork MCP Server

    Seamless Teamwork.com integration for Large Language Models via the Model Context Protocol

    Teamwork MCP Server is an implementation of the Model Context Protocol (MCP) that enables Large Language Models to interact securely and programmatically with Teamwork.com. It offers standardized interfaces, including HTTP and STDIO, allowing AI agents to perform various project management operations. The server supports multiple authentication methods, an extensible toolset architecture, and is designed for production deployments. It provides read-only capability for safe integrations and robust observability features.

    • ⭐ 11
    • MCP
    • Teamwork/mcp
  • Weblate MCP Server

    Weblate MCP Server

    Seamlessly connect AI assistants to Weblate for translation management via the Model Context Protocol.

    Weblate MCP Server enables AI assistants and clients to directly manage Weblate translation projects through the Model Context Protocol (MCP). It integrates with the Weblate REST API, allowing natural language interaction for project and translation management. The tool offers multiple transport options including HTTP, SSE, and STDIO, and is optimized for large language model workflows. Full support for project, component, and translation operations is provided, with a focus on type safety and flexible environment configuration.

    • ⭐ 9
    • MCP
    • mmntm/weblate-mcp
  • mcp-graphql

    mcp-graphql

    Enables LLMs to interact dynamically with GraphQL APIs via Model Context Protocol.

    mcp-graphql provides a Model Context Protocol (MCP) server that allows large language models to discover and interact with GraphQL APIs. The implementation facilitates schema introspection, exposes the GraphQL schema as a resource, and enables secure query and mutation execution based on configuration. It supports configuration through environment variables, automated or manual installation options, and offers flexibility in using local or remote schema files. By default, mutation operations are disabled for security, but can be enabled if required.

    • ⭐ 319
    • MCP
    • blurrah/mcp-graphql
  • Campertunity MCP Server

    Campertunity MCP Server

    Model Context Protocol server for AI-driven camping and outdoor recreation data

    Implements the Model Context Protocol (MCP) to provide AI models with structured access to camping and outdoor recreation data. Offers tools for searching, filtering, and booking campgrounds and sites based on a wide range of criteria. Enhances data accuracy with AI and aggregates information from multiple sources, enabling dynamic, real-time queries and bookings. Ideal for integrating intelligent camping experiences into AI-driven applications.

    • ⭐ 11
    • MCP
    • campertunity/mcp-server
  • mcp-national-rail

    mcp-national-rail

    Access live National Rail train data via MCP for AI agents.

    mcp-national-rail is a Model Context Protocol (MCP) server designed to enable AI agents to retrieve real-time and scheduled train information from National Rail using the Realtime Trains API. It facilitates live and historical lookups of departures and arrivals by exposing a set of tools through a standardized MCP interface. The server can be installed via Smithery or manually and configured for use with AI clients like Claude Desktop. Secure authentication with the Realtime Trains API is supported through user-provided credentials.

    • ⭐ 1
    • MCP
    • lucygoodchild/mcp-national-rail
    • View all Alternatives

    Didn't find tool you were looking for?

    Be as detailed as possible for better results