Skip to main content The #1 agentic semantic tool search: 91.6% first-try accuracy on S1 Search Bench Explore Tool Discovery
Live 30 Actions

BALLDONTLIE MCP Server
for AI Agents

Connect your AI agent to StackOne's BALLDONTLIE MCP server and give it 30 MCP tools out of the box. Auth, tool execution, and security all managed.

BALLDONTLIE logo
BALLDONTLIE MCP Server
Built by StackOne StackOne
DrataGPLocalyzeFlipMindtoolsScreenloop

Coverage

30 Agent Actions

Create, read, update, and delete across BALLDONTLIE — and extend your agent's capabilities with custom actions.

Authentication

Agent Tool Authentication

Per-user OAuth in one call. Your BALLDONTLIE MCP server gets session-scoped tokens with zero credentials stored on your infra.

Agent Auth →

Security

Agent Protection

Every BALLDONTLIE tool response scanned for prompt injection in milliseconds — 88.7% accuracy, all running on CPU.

Prompt Injection Defense →

Performance

Max Agent Context. Min Cost.

Free up to 96% of your agent's context window to enhance reasoning and reduce cost, on every BALLDONTLIE call.

Tools Discovery →

What is the BALLDONTLIE MCP Server?

A BALLDONTLIE MCP server lets AI agents read and write BALLDONTLIE data through the Model Context Protocol — Anthropic's open standard for connecting LLMs to external tools. StackOne's BALLDONTLIE MCP server ships with 30 pre-built actions, fully extensible via the Connector Builder — plus managed authentication, prompt injection defense, observability, and agent execution runtime. Connect it from MCP clients like Claude Desktop, Claude Code, Cursor, Goose, and VS Code, or from agent frameworks like OpenAI Agents SDK, LangChain, and Vercel AI SDK.

All BALLDONTLIE MCP Tools

Every action from BALLDONTLIE's API, ready for your agent. Create, read, update, and delete — scoped to exactly what you need.

Other (30)

  • Get Current User

    Retrieve the authenticated account's profile, including email, overall tier, and per-sport subscription status.

  • Get Team Contracts

    Retrieve every player contract on a single NBA team for a season.

  • Get Player Contracts

    Retrieve a single player's contracts, optionally narrowed to specific seasons.

  • Get Player Contract Aggregates

    Retrieve multi-year contract totals for a single player, including total value and guaranteed money.

  • List DFS Slates

    Retrieve provider-neutral daily fantasy sports slates, with their format, event window, salary cap and single or multi-game scope.

  • Get DFS Slate Details

    Retrieve a single DFS slate with its included real-game events and lineup roster slots.

  • List DFS Draftables

    Retrieve the players or teams selectable for a DFS slate roster slot, with position, salary and availability.

  • Get All Games

    Retrieve NBA games filtered by date, date range, season, season type or team.

  • Get A Specific Game

    Retrieve a single NBA game by its BALLDONTLIE game ID.

  • Get Box Scores

    Retrieve complete box scores for every NBA game played on a specific date.

  • Get Live Box Scores

    Retrieve live box scores for NBA games currently in progress.

  • Get Game Lineups

    Retrieve starting lineups and bench players for one or more NBA games.

  • Get Play-by-Play Data

    Retrieve the full chronological play-by-play feed for a single NBA game.

  • Get Betting Odds

    Retrieve current game-level betting odds — moneyline, spread and over/under — for NBA games by date or game ID.

  • Get Opening Betting Odds

    Retrieve the historical opening game-level betting odds for NBA games by date or game ID.

  • Get Player Props

    Retrieve live player prop betting lines for a single NBA game, optionally narrowed by player, prop type or sportsbook.

  • Get Opening Player Props

    Retrieve the historical opening player prop betting lines for a single NBA game.

  • Get All Players

    Retrieve NBA players with optional name search and team or player ID filters. Includes historical players.

  • Get A Specific Player

    Retrieve a single NBA player by their BALLDONTLIE player ID.

  • Get All Active Players

    Retrieve only players currently on an NBA roster, with the same search and filter options as Get All Players.

  • Get All Player Injuries

    Retrieve current NBA injury reports, optionally filtered by team or player.

  • Get Averages

    Retrieve player season averages for a statistical category — general, clutch, defense or shooting — with a specific split selected by type.

  • Get All Stats

    Retrieve per-game player statistics filtered by player, game, date, date range or season.

  • Get All Advanced Stats (V2)

    Retrieve advanced per-game player statistics including efficiency ratings, tracking data, hustle stats, defensive matchups and usage.

  • Get Leaders

    Retrieve the NBA league leaders for a single statistic in a given season.

  • Get All Teams

    Retrieve all NBA teams, optionally narrowed to a single division or conference.

  • Get A Specific Team

    Retrieve a single NBA team by its BALLDONTLIE team ID.

  • Get Team Standings

    Retrieve NBA team standings for a season, including conference and division records.

  • Get Team Season Averages

    Retrieve team-level season averages for a statistical category, such as general, clutch, shooting, playtype, tracking, hustle or shot dashboard splits.

  • Season Averages

    Retrieve a single player's per-game season averages for one season.

Set Up Your BALLDONTLIE MCP Server in Minutes

One endpoint. Any framework. Your agent is talking to BALLDONTLIE in under 10 lines of code.

Agent Frameworks

Claude Desktop
{
  "mcpServers": {
    "stackone": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote@latest",
        "https://api.stackone.com/mcp?x-account-id=<account_id>",
        "--header",
        "Authorization: Basic <YOUR_BASE64_TOKEN>"
      ]
    }
  }
}

BALLDONTLIE MCP Server FAQ

Does StackOne have a BALLDONTLIE MCP server?
Yes. StackOne offers a hosted BALLDONTLIE MCP server with 30 pre-built actions, and every action is tested and QA'd by StackOne. Connect it to Claude, Cursor, and any other MCP client, or to any agent framework through the AI Action SDK. It ships with managed agent authentication, prompt injection defense, and tool discovery with server-side execution that preserve your agent's context window and keep reasoning performance.
BALLDONTLIE MCP server vs direct API integration — what's the difference?
A BALLDONTLIE MCP server and direct API integration serve different use cases. Direct API integration is for software-to-software — backend code calling BALLDONTLIE. A BALLDONTLIE MCP server is for AI agents — MCP clients like Claude and Cursor, plus framework agents built with OpenAI, LangChain, or Vercel AI — discovering and calling BALLDONTLIE at runtime. StackOne provides both.
How does BALLDONTLIE authentication work for AI agents?
BALLDONTLIE authentication for AI agents works through a StackOne Connect Session. Create one via the dashboard or the SDK — you get an auth link and ready-to-paste config for Claude Desktop, Cursor, and other MCP clients. Your user authenticates their own BALLDONTLIE account; StackOne handles token exchange, storage, and refresh. Credentials never reach the LLM, and each user is isolated via origin_owner_id.
Are BALLDONTLIE MCP tools vulnerable to prompt injection?
Yes — BALLDONTLIE MCP tools can be vulnerable to indirect prompt injection. Any tool that reads user-written content — documents, messages, tickets, records, or free-text fields — is a potential vector. StackOne Defender scans every tool response before it enters the agent's context — regex patterns in ~1ms, then a MiniLM classifier in ~4ms. 88.7% accuracy, CPU-only.
What is the context bloat of a BALLDONTLIE agent and how do I avoid it?
Context bloat happens when BALLDONTLIE tool schemas and API responses eat your BALLDONTLIE agent's memory, preventing it from reasoning effectively. A single BALLDONTLIE query can return a massive JSON response, and connecting multiple tools compounds the problem. Tools Discovery and Code Mode reduce context bloat — loading only relevant tools per query and keeping raw responses out of the agent's context.
Can I limit which actions my BALLDONTLIE agent can access?
Yes — you can limit which actions your BALLDONTLIE agent can access directly from the StackOne dashboard. Toggle actions on or off, or restrict them to specific accounts, with no code changes to your agent. Session tokens can be scoped to exact actions so if one leaks, exposure stays contained.
Can I create custom agent actions for my BALLDONTLIE MCP server?
Yes — you can create custom agent actions for your BALLDONTLIE MCP server using Connector Builder. It's an integration agent your coding assistant (Claude Code, Cursor, or Copilot) can invoke to research BALLDONTLIE's API, generate production-ready connector YAML, test against the live API, and validate before you ship.
When should I NOT use a BALLDONTLIE MCP server?
Skip a BALLDONTLIE MCP server if your integration is purely software-to-software — direct BALLDONTLIE API integration is simpler when no AI agent is involved. For deterministic, compliance-critical operations (financial transactions, regulatory reporting), direct API gives you predictable behavior without agent-driven decision-making. MCP shines when AI agents need to dynamically discover and call BALLDONTLIE actions at runtime.
What AI frameworks and AI clients does the StackOne BALLDONTLIE MCP server support?
The StackOne BALLDONTLIE MCP server supports both. MCP clients (paste-and-go apps): Claude Desktop, Claude Code, Cursor, VS Code, Goose. Agent frameworks (code SDKs you build with): OpenAI Agents SDK, Anthropic, Vercel AI, Google ADK, CrewAI, Pydantic AI, LangChain, LangGraph, Azure AI Foundry.

Put your AI agents to work

All the tools you need to build and scale AI agent integrations, with best-in-class connectivity, execution, and security.