Marketing

Balldontlie MCP Server

Connect your account, then chat with AI to run tools.

This server provides access to live sports data and analytics, making it a valuable resource for sports enthusiasts, analysts, and developers looking to integrate sports information into their applications.

Agent guide included

Opens MCPBundles Studio with this server selected. After sign-in, chat and run tools from the same thread.

AI Skill
SKILL.md

Domain knowledge for Balldontlie — workflow patterns, data models, and gotchas for your AI agent.

Provides extensive live sports data and analytics for NBA and NFL, offering real-time statistics, game information, player data, and betting odds. Essential for sports applications, analytics dashboards, and fantasy sports platforms.

Core Capabilities

Team & Player Data: Access complete rosters, player profiles, team information with filtering by division, conference, or activity status. Supports pagination for large datasets.

Game Information: Retrieve game schedules, results, and details with filtering by date ranges, seasons, teams, or weeks (NFL). Includes live game tracking and historical data.

Statistics & Analytics: Get player season averages, advanced metrics (V2), box scores, play-by-play data, team standings, and statistical leaders. Covers general stats, clutch performance, shooting metrics, tracking data, hustle stats, and defensive matchups.

Live Data: Real-time box scores for ongoing games, live betting odds, player prop bets, injury reports, and game lineups (NBA 2025+ season).

Financial Data: Player contracts by team or individual, contract aggregates with total values and guarantees.

Betting Integration: Live odds for games and player props with real-time updates.

Data Model

Games link to teams and players. Statistics aggregate by season/game with multiple category breakdowns (general, clutch, shooting, playtype, tracking, hustle). Contract data spans multiple seasons with guarantee details. Play-by-play provides chronological game events.

Key Considerations

Lineup data only available for NBA games from 2025 season onward and once games begin. Player prop betting data is live and frequently updated. Use appropriate date ranges and pagination for large datasets. Some advanced statistics require specific season parameters.

Frequently Asked Questions

What is the Balldontlie MCP server?

This server provides access to live sports data and analytics, making it a valuable resource for sports enthusiasts, analysts, and developers looking to integrate sports information into their applications. It provides tools that AI agents can use through the Model Context Protocol (MCP).

How do I connect Balldontlie to my AI agent?

Add the MCPBundles server URL to your MCP client configuration (Claude Desktop, Cursor, VS Code, etc.). The URL format is: https://mcp.mcpbundles.com/bundle/balldontlie-mcp. Authentication is handled automatically.

What authentication does Balldontlie require?

Balldontlie uses API Key. Balldontlie requires credentials. Connect via MCPBundles and authentication is handled automatically.

Setup Instructions

Connect Balldontlie to any MCP client in minutes

https://mcp.mcpbundles.com/bundle/balldontlie-mcp

One-click install:

The link prefills the Add custom connector dialog — you still review the values and click Add, then Connect to complete OAuth.

Or add manually

  1. Open claude.ai → Settings → Connectors.
  2. Click the + button and choose Add custom connector.
  3. Set Name to Balldontlie and paste the MCP URL into Remote MCP server URL.
  4. Click Add. Balldontlie will appear under Not connected — select it and click Connect to complete OAuth.
Name: Balldontlie
Remote MCP server URL: https://mcp.mcpbundles.com/bundle/balldontlie-mcp
Authentication: OAuth

Custom connectors at claude.ai require a paid Claude plan (Pro, Max, Team, or Enterprise).

Maintain this listing

Operate Balldontlie? You can take over the listing's metadata.

Operate Balldontlie?

Take over this listing's metadata — name, description, category, logo, website, contact email, and skill content. Verification is a 6-digit code we email to one of the maintainer addresses your server already publishes in /.well-known/security.txt or /.well-known/mcpbundles.json. Free, takes about a minute.

Sign up to claim

Ready to use Balldontlie?

Sign in to connect your credentials and start running tools from the chat.

Balldontlie MCP Server & Skill