BallDontLie Connector for AI agents.
8 live capabilities
Get real-time NBA stats and game results for your sports data projects.
Waiting for input…
Why people use BallDontLie
BallDontLie NBA Stats: Stop Scraping Sports Sites for Player Data
This Connector changes that by giving your AI agent a direct line to the BallDontLie database. Instead of clicking through menus, you just ask for the data you need. Your agent pulls the stats, gives you the numbers, and lets you get back to the actual analysis.
What Vinkius changes
It turns your AI into a real-time NBA data analyst.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 6,100+ Connectors
- Real-world use case 01
Optimizing Fantasy Roster Decisions
A fantasy manager needs to know if a player's recent scoring is consistent.
- Real-world use case 02
Recapping Last Night's Game Scores
A content creator wants to recap last night's scores for a video.
- Real-world use case 03
Populating a Sports App Database
A developer is building a sports dashboard.
Complete set · 8capabilities
The complete BallDontLie capability set.
These are the exact actions your AI can choose when you ask it to work with BallDontLie.
01—04
4 capabilities in this set.
Part of 8 available through BallDontLie.
- 01 Capability
List teams
Provides a full list of all 30 NBA teams. It's great for building out team-based workflows.
- 02 Capability
Get game details
Grabs the specific details of a single NBA game. Use it to see the full breakdown of a past matchup.
- 03 Capability
Get player details
Pulls specific metadata for individual NBA players. It's the quickest way to get a player's basic profile.
- 04 Capability
Get team details
Fetches technical details and identifiers for any of the 30 NBA teams. Use it to audit team rosters quickly.
05—08
4 capabilities in this set.
Part of 8 available through BallDontLie.
- 05 Capability
List games
Retrieves a list of NBA games including scores and results. You can filter these by specific dates or seasons.
- 06 Capability
List players
Lets you search for or list thousands of active and retired players. It's the starting point for any player-centric query.
- 07 Capability
List player stats
Pulls a list of statistics for specific players. Use this to see how a player performed in a particular game.
- 08 Capability
Get season averages
Fetches the season averages for a specific player. This is essential for deep performance auditing.
Set up in minutes
One URL. Then ask BallDontLie to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use BallDontLie from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it BallDontLie, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable BallDontLie for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the BallDontLie URL.
- Step 03
Save and start
Save the connection and enable BallDontLie in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"balldontlie": {
"url": "https://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp"
}
}
}- Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using BallDontLie
Open Agent mode in chat and ask: "Using BallDontLie, help me...". 8 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"balldontlie": {
"url": "https://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp"
}
}
}- Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using BallDontLie
Ask Copilot: "Using BallDontLie, help me...". 8 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"balldontlie": {
"url": "https://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp"
}
}
}- Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using BallDontLie
Open Cascade and ask: "Using BallDontLie, help me...". 8 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"balldontlie": {
"url": "https://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp"
}
}
}- Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using BallDontLie
Ask Cline: "Using BallDontLie, help me...". 8 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add balldontlie --transport http "https://edge.vinkius.com/vk_preview_pcgFJCe55aFZmndb8Txemc9YruBjSoeTiltCYEXM/mcp"- Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using BallDontLie
Ask Claude: "Using BallDontLie, show me...". 8 tools are ready
Where the request belongs
Work BallDontLie can move forward.
This is for the sports enthusiasts and data nerds who live in the numbers. If you're tired of manual data entry for your projects or need instant facts for your content, this is for you.
Fantasy Basketball Manager
Audits player performance and season averages to optimize rosters and win weekly matchups.
Sports Content Creator
Retrieves historical game data and player metadata for scripts and social media production.
Data Scientist
Integrates clean NBA technical data into analysis models and visualizations for research.
Sports Analyst
Instantly pulls exact player stats and game results through natural language for reports.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsMySportsFeeds
Access real-time and historical sports data for NFL, MLB, NBA, NHL, and more—get standings, player stats, and game boxscores directly.
FantasyData (SportsDataIO)
Access real-time sports data via FantasyData (SportsDataIO). track players, scores, and schedules for NFL, NBA, and MLB.
TheRundown
Access real-time sports data, betting odds, and schedules for NFL, NBA, MLB, and more directly from your AI agent.
TheSportsDB Global Sports Database
The definitive sports metadata server. search teams, players, leagues, and live results via AI.
NHL
Access real-time NHL scores, schedules, standings, and player statistics directly from your AI agent.
Broadage Sports
Access real-time sports data via Broadage. track scores, matches, and lineups directly from any AI agent.
Bring your own AI
Change the model, client or framework. Keep BallDontLie connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about BallDontLie.
The practical details behind the request, access and result.
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 capability 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 capability 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 capability 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 capability by providing the specific season year and the player IDs. This will return averaged performance metrics for the requested period.
One connection away
Give your agent a direct line to BallDontLie.
Connect BallDontLie once. Keep it beside 6,100+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available