How to Use the BallDontLie MCP in Windsurf

Get real-time NBA stats and game results directly inside Windsurf to build sports tools without writing API boilerplate.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect BallDontLie MCP to Windsurf

Create your Vinkius account to connect BallDontLie to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup BallDontLie with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Pull live NBA stats into Windsurf

The `list_player_stats` tool lets your agent query historical performance data directly inside your active workspace. Windsurf uses this MCP Server to grab exact box scores and feed them straight into your local scripts. You don't need to copy-paste stats from sports sites anymore. Cascade reads the output of your queries to build custom analytical charts on the fly.

Auto-generate player comparison profiles

The `get_season_averages` tool gives Cascade the power to calculate year-over-year player progression during a coding session. Cascade chains this tool with other queries to build complex data structures without manual intervention. Ask Windsurf to write a comparison script for two guards, and it will fetch their averages, write the logic, and test the output in one run.

Analyze team records through Cascade pipelines

The `list_teams` tool lets Windsurf scan the entire league structure to populate database tables or application dropdowns. This MCP Server exposes team details so your agent knows exactly which franchises to pull. When you ask Cascade to build an NBA dashboard, it grabs the team list first and then queries individual schedules without you prompting each step.

Setup guide

Set up BallDontLie MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the BallDontLie MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my BallDontLie payment history." If connected, Cascade will call the BallDontLie tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "balldontlie-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by BallDontLie. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect BallDontLie now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about BallDontLie MCP in Windsurf

You configure the server in your local MCP config file. Once added, Cascade automatically detects the tools and calls them when you ask NBA-related questions.

Yes, Cascade can chain season averages and player lists to write, test, and run a draft script in your terminal.

Yes, Vinkius runs the server in a secure sandbox. Your player search queries and game statistic requests are processed ephemerally without being stored.

No, Vinkius handles the underlying authentication for this MCP Server. You only need to add the server endpoint to your configuration.

Cascade reads the tools directly, executing steps sequentially to resolve your prompt without asking for permission at each turn.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python