# BallDontLie MCP for AI Agents AI Agent Connect > BallDontLie lets your AI agent grab real-time and historical NBA data. It pulls player stats, team rosters, and game scores so you don't have to dig through sports websites. Use it to build fantasy drafts, analyze season averages, or get instant facts for sports commentary. It's the fastest way to get accurate league data into your workflow. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/ai-agent-connect - **Tags:** nba, basketball, sports-statistics, data-retrieval, player-profiles ## Description Imagine you're trying to build a fantasy basketball lineup and you need to know exactly how a bench player performed in the last three games. Instead of opening five different tabs and squinting at tiny numbers, you just ask your agent. BallDontLie connects your AI to the actual data backbone of the NBA. It handles the heavy lifting of pulling specific player profiles, team technical details, and historical game results. You get the raw numbers for season averages or specific game stats without the friction of manual searching. It's like having a sports data analyst sitting next to you, ready to pull any fact from the league instantly. When you use it through the Vinkius catalog, you're essentially giving your agent a direct line to the league's history and current stats. You can audit every team in the league or deep-dive into a retired legend's career highlights in seconds. You can compare how different teams stack up or find specific stats for a player who hasn't played in years. It turns your AI into a powerhouse for anything involving basketball data, whether you're writing a deep-dive article or building a custom app. You won't have to worry about outdated info or broken links; you just get the numbers you need for your project immediately. ## Tools ### list_teams Provides a full list of all 30 NBA teams. It's great for building out team-based workflows. ### get_game_details Grabs the specific details of a single NBA game. Use it to see the full breakdown of a past matchup. ### get_player_details Pulls specific metadata for individual NBA players. It's the quickest way to get a player's basic profile. ### get_team_details Fetches technical details and identifiers for any of the 30 NBA teams. Use it to audit team rosters quickly. ### list_games Retrieves a list of NBA games including scores and results. You can filter these by specific dates or seasons. ### list_players Lets you search for or list thousands of active and retired players. It's the starting point for any player-centric query. ### list_player_stats Pulls a list of statistics for specific players. Use this to see how a player performed in a particular game. ### get_season_averages Fetches the season averages for a specific player. This is essential for deep performance auditing. ## Prompt Examples **Prompt:** ``` Who were the top scorers in the NBA last night? ``` **Response:** ``` ### Last Night's Top Scorers | Player | Team | Points | | :--- | :--- | :--- | | **Luka Doncic** | Mavericks | 32 | | **Jayson Tatum** | Celtics | 30 | | **Anthony Edwards** | Timberwolves | 28 | *Note: These are the primary scorers from the most recent game results.* ``` **Prompt:** ``` Give me the season averages for Luka Doncic. ``` **Response:** ``` ### Luka Doncic - Season Averages * **Points:** 28.5 PPG * **Rebounds:** 8.3 RPG * **Assists:** 8.2 APG He is currently leading the league in several major statistical categories this season. ``` **Prompt:** ``` List all the teams in the NBA and their IDs. ``` **Response:** ``` ### NBA Team Identifiers Here are the current NBA teams: * **Atlanta Hawks** (ID: 1) * **Boston Celtics** (ID: 2) * **Brooklyn Nets** (ID: 3) * **Chicago Bulls** (ID: 4) * **Dallas Mavericks** (ID: 5) * ... (30 teams total) ``` ## Capabilities ### Search thousands of active and retired players Your agent can find specific player profiles from the league's entire history. ### Fetch technical details for all 30 NBA teams Get team identifiers and roster details for every franchise in the league. ### Pull scores and results for specific dates Retrieve game results and scores filtered by season or specific calendar dates. ### Calculate season averages for performance audits Access aggregated season stats to see a player's overall performance trends. ### Inspect technical identifiers for sports workflows Get the raw metadata needed to build complex sports applications and data models. ## Use Cases ### Optimizing Fantasy Roster Decisions A fantasy manager needs to know if a player's recent scoring is consistent. They ask the agent to compare get_season_averages for the last three games. ### Recapping Last Night's Game Scores A content creator wants to recap last night's scores for a video. They ask the agent to use list_games for yesterday's date to see the winners. ### Populating a Sports App Database A developer is building a sports dashboard. They use list_teams to populate their database with all 30 NBA team identifiers. ### Researching Retired Legends An analyst wants to find a specific retired player's details. They use list_players to search the archive and get_player_details to pull the bio. ## Benefits - Stop manual searching: Use list_players and get_player_details to find stats instantly instead of browsing websites. - Faster fantasy drafts: Use get_season_averages to quickly identify high-performing players for your roster. - Accurate content: Use list_games and get_game_details to pull verified scores for your scripts and commentary. - Clean data for models: Use list_teams and get_team_details to get structured team data for your data science projects. - Instant performance audits: Use list_player_stats to compare player performance across different game types or dates. ## How It Works The bottom line is it turns your AI into a real-time NBA data analyst. 1. Subscribe to the BallDontLie MCP on Vinkius. 2. Paste your BallDontLie API key into your client settings. 3. Ask your agent questions about NBA stats and watch it pull live data. ## Frequently Asked Questions **Can I use BallDontLie MCP to get historical stats?** Yes, you can pull stats for both active and retired players. It allows you to look back at historical game results and player profiles from across the league's history. **Does BallDontLie MCP work for fantasy basketball?** It's a great tool for fantasy basketball. You can use it to audit player performance, check season averages, and find the best stats for your roster decisions. **Can I get scores for specific dates?** Yes, you can ask your agent to list games for any specific date or season. It will pull the scores and results for those games instantly. **Is the data from BallDontLie MCP accurate?** Yes, the data comes directly from the BallDontLie platform, which is a dedicated NBA data source. **Can I use this to find team rosters?** Yes, the Connector can fetch technical details and identifiers for all 30 NBA teams, making it easy to see who is on which team. **Can I get season averages for any player?** Absolutely. Just ask your agent for a specific player's season averages, and it will pull that data directly from the league stats. **Can I search for a specific player by name?** Yes! Use the `list_players` tool and provide the name in the `search` parameter. Your agent will return a list of matching players with their unique IDs and metadata. **How do I see the scores for all games played on a specific date?** Use the `list_games` tool and provide the date in the `dates` parameter (format YYYY-MM-DD). The response will include all games played on that day with their final scores. **Does the integration provide player season averages?** Absolutely. Use the `get_season_averages` tool by providing the specific season year and the player IDs. This will return averaged performance metrics for the requested period.