Config is the same across clients — only the file and path differ.
{
"mcpServers": {
"balldontlie-api": {
"url": "https://mcp.balldontlie.io/mcp",
"headers": {
"Authorization": "<YOUR_BALLDONTLIE_API_KEY>"
},
"transport": "http"
}
}
}Are you the author?
Add this badge to your README to show your security score and help users find safe servers.
A Model Context Protocol (MCP) server that provides access to comprehensive sports data from the BALLDONTLIE API, including NBA, WNBA, NFL, MLB, EPL, NHL, NCAAF, NCAAB, MMA, CS2, League of Legends, Dota 2, FIFA World Cup 2026, La Liga, Serie A, UEFA Champions League, Bundesliga, and Ligue 1 statistics, player information, game data, and more.
Run this in your terminal to verify the server starts. Then let us know if it worked — your result helps other developers.
npx -y '@balldontlie/mcp-server' 2>&1 | head -1 && echo "✓ Server started successfully"
After testing, let us know if it worked:
Five weighted categories — click any category to see the underlying evidence.
No known CVEs.
Checked @balldontlie/mcp-server against OSV.dev.
Be the first to review
Have you used this server?
Share your experience — it helps other developers decide.
Sign in to write a review.
Others in analytics
MCP server that enables AI agents to perform comprehensive web audits using Google Lighthouse with 13+ tools for performance, accessibility, SEO, and security analysis.
MCP server for Dynatrace Managed to access logs, events, and metrics.
An MCP server that provides [describe what your server does]
MCP server for Yandex.Direct API — campaigns, ads, statistics, keywords. Bearer token auth.
MCP Security Weekly
Get CVE alerts and security updates for io.balldontlie/mcp and similar servers.
Start a conversation
Ask a question, share a tip, or report an issue.
Sign in to join the discussion.
A Model Context Protocol (MCP) server that provides access to comprehensive sports data from the BALLDONTLIE API, including NBA, WNBA, NFL, MLB, EPL, NHL, NCAAF, NCAAB, MMA, CS2, League of Legends, Dota 2, FIFA World Cup 2026, La Liga, Serie A, UEFA Champions League, Bundesliga, and Ligue 1 statistics, player information, game data, and more.
npm install @balldontlie/mcp-server
Sign up at BALLDONTLIE to get your free API key.
Add to your MCP client configuration (e.g., the agent Desktop) to use the hosted server:
{
"mcpServers": {
"balldontlie-api": {
"url": "https://mcp.balldontlie.io/mcp",
"transport": "http",
"headers": {
"Authorization": "<YOUR_BALLDONTLIE_API_KEY>"
}
}
}
}
Replace <YOUR_BALLDONTLIE_API_KEY> with your actual API key from BALLDONTLIE.
Clone and run from source code:
git clone https://github.com/balldontlie-api/mcp-server.git
cd mcp-server
npm install
npm run build
npm start
Configure your MCP client to connect to the local server:
{
"mcpServers": {
"balldontlie-api": {
"url": "http://localhost:3000/mcp",
"transport": "http",
"headers": {
"Authorization": "<YOUR_BALLDONTLIE_API_KEY>"
}
}
}
}
The server will automatically provide all available tools. You can ask your AI assistant things like:
| Variable | Default | Description |
|---|---|---|
PORT | 3000 | Server port when running locally |
BACKEND_API_URL | https://api.balldontlie.io | BALLDONTLIE API base URL |
API_TIMEOUT | 30000 | Request timeout in milliseconds |
LOG_LEVEL | info | Logging level (error, warn, info, debug) |
NODE_ENV | development | Environment (development, production, test) |
ENABLE_DEBUG | false | Enable debug logging |
ENABLE_TRACING | false | Enable DataDog APM tracing (requires DD_AGENT_HOST) |
DD_AGENT_HOST | - | DataDog agent hostname for APM tracing |
DD_PROFILING_ENABLED | false | Enable DataDog profiling |
SERVICE_VERSION | 1.0.0 | Service version for tracing |