Advertise
MCP.so
Sign In

Balldontlie MCP Server

@mikechao

Repository

Basic information

Category

Other

License

MIT

Transports

stdio

Author

mikechao

About 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

#nba#nfl#mlb#model-context-protocol#mcp-server

Balldontlie MCP Server config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "balldontlie-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "@mikechao/balldontlie-mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Balldontlie MCP Server tools

4

Gets the list of team from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)

Gets the list of players from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)

Gets the list of games from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)

Get a specific game from one of the following leagues NBA (National Basketball Association), MLB (Major League Baseball), NFL (National Football League)

Overview

What is Balldontlie MCP Server?

An MCP server that integrates the Balldontlie API to provide information about players, teams, and games for the NBA, MLB, and NFL. It enables AI assistants like Claude to query live sports data via natural language.

How to use Balldontlie MCP Server?

Install via Smithery (npx -y @smithery/cli install @mikechao/balldontlie-mcp --client claude), a Desktop Extension (DXT) file, or manual configuration in claude_desktop_config.json with the command npx -y balldontlie-mcp and environment variable BALLDONTLIE_API_KEY. LibreChat users can add a YAML configuration.

Key features of Balldontlie MCP Server?

  • Get teams for NBA, MLB, or NFL leagues
  • Search players with optional first/last name filters
  • Retrieve games by date(s), team IDs, and pagination cursor
  • Fetch details of a single game by its ID
  • Interactive schedule generator prompt for Claude Desktop

Use cases of Balldontlie MCP Server?

  • Ask “Show me today’s baseball games” to get live MLB schedules
  • Find football players with a specific last name (e.g., Purdy)
  • Count NBA players with a given surname (e.g., Ming)
  • Generate an interactive game schedule for a date range in Claude Desktop

Frequently asked questions

1

What leagues are supported?

NBA (National Basketball Association), MLB (Major League Baseball), and NFL (National Football League).

2

Do I need an API key to use Balldontlie MCP Server?

Yes. You must sign up at balldontlie.io and set the `BALLDONTLIE_API_KEY` environment variable. The free plan is sufficient.

3

Is this server officially associated with balldontlie.io?

No. It is a third-party MCP Server implementation and is not officially associated with balldontlie.io.

4

How can I install Balldontlie MCP Server?

You can install it via Smithery, by downloading a Desktop Extension (DXT) file from the GitHub releases, or by manually adding it to `claude_desktop_config.json`.

5

Can I filter players by name?

Yes. The `get_players` tool accepts optional `firstName` and `lastName` parameters for searching.

Comments

More Other MCP servers

FastMCP v2 🚀

jlowin

🚀 The fast, Pythonic way to build MCP servers and clients.

26.0K

Senso MCP for Joomla

sensomedia

Senso MCP turns a Joomla 5 or 6 site into a remote MCP server. It runs inside Joomla itself (no extra server, no Node.js bridge) and is secured with OAuth 2.1 and Joomla's own ACL. The free pack lets an AI assistant crea

Yuppsy

Yuppsy MCP: build and publish real estate websites from your AI assistant. Yuppsy lets your AI assistant create live websites for real estate agents and individual property listings. You don't need a designer or any code

Handl

Handl speaks the Model Context Protocol. Your whole billing operation — projects, invoices, clients, reports, approvals — as tools any AI assistant can call, inside your autonomy rules.

Health by Dr Brad

Dr Brad Stanfield

Health by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one

Advertise