How to Use the BallDontLie MCP in Cursor

Q: How do I configure BallDontLie for Cursor?

Create an mcp.json file in your project root directory. Paste the BallDontLie endpoint details inside the mcpServers block and turn on Agent mode in your chat panel.

Inject real NBA box scores and player stats directly into your sports app codebase using Cursor Agent mode.

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 Cursor

Create your Vinkius account to connect BallDontLie to Cursor 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 Cursor

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build Sports Apps Faster in Cursor

Mocking up sports data is a massive waste of time. When you enable Agent mode, Cursor calls `list_teams` and `list_games` to populate your React components with actual NBA franchises and recent schedules. Your UI gets tested against the real shape of the API response immediately. The editor uses `get_game_details` to grab nested quarter-by-quarter scoring, ensuring your frontend logic handles complex JSON structures correctly.

Code with Live Player Statistics

Writing a fantasy basketball algorithm means you need accurate player metrics. Cursor finds your target athletes using `list_players` and pulls their exact historical performance via `get_season_averages`. Instead of guessing how to calculate a moving average for points per game, the AI client writes the python script while checking the real numbers. It verifies the math against the actual output from `list_player_stats`.

Automate NBA Data Pipelines

Setting up an automated scraper or daily cron job requires knowing exactly what the endpoints return. You can tell the editor to scaffold a database schema based on the output of `get_player_details` and `get_team_details`. Because this MCP Server feeds live data straight into your workspace, you never have to tab out to read API documentation. Cursor maps the database fields exactly to the sports data you requested.

Setup guide

Set up BallDontLie MCP in Cursor

Prerequisites

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

1

Open MCP Settings

Go to Cursor Settings → MCP or open the Command Palette (Cmd+Shift+P / Ctrl+Shift+P) and search for "MCP: Add Server".
2

Add the BallDontLie MCP

Cursor will create or open .cursor/mcp.json in your project root. Paste the JSON snippet on the right. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Enable Agent mode

Open Composer (Cmd+I / Ctrl+I) and switch to Agent mode using the dropdown at the top. MCP tools are only available in Agent mode.
4

Verify the connection

Ask Cursor something like "List my recent BallDontLie transactions." If the MCP tools are loaded correctly, Cursor will call the BallDontLie tools automatically. You can also check Settings → MCP for a green status indicator.

.cursor/mcp.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 Cursor

Create an `mcp.json` file in your project root directory. Paste the BallDontLie endpoint details inside the `mcpServers` block and turn on Agent mode in your chat panel.

The agent handles this perfectly. You just ask the editor to pull a hundred active players and generate the SQL insert statements automatically. It runs the API calls and writes the code in one step.

Requesting too many seasons at once will hit rate limits. Tell your agent to filter the dates tightly when asking for historical matchups.

You have to use Agent mode for tool execution. Standard chat cannot trigger the external requests needed to fetch basketball statistics.

Your codebase remains entirely on your machine. This MCP connection only transmits outgoing requests for public basketball metrics like player averages and box scores, running inside an ephemeral sandbox.

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

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript