About sportscore-mcp
sportscore-mcp is an MCP server for SportScore, giving AI assistants access to football, basketball, cricket, and tennis data. It covers live scores, standings, player statistics, and knockout brackets without requiring an API key.
Key features
- 01Query live and recent matches
- 02Retrieve match details and lineups
- 03View team schedules and standings
- 04Query player stats and top scorers
- 05Get brackets and live tracker data
Use cases
- 01Check scores for ongoing matches
- 02Look up league standings and top scorers
- 03Find a team's next fixture
- 04Follow knockout brackets and match progress
MCP support
The project exposes SportScore match, team, league, and player data as tools to MCP clients. Each tool result includes SportScore attribution.
Configuration
Local server config is the same for every client. Copy it into your client’s MCP config file.
npx -y sportscore-mcpSPORTSCORE_API_BASEOverride the API base URL (default: https://sportscore.com). Useful for staging or self-hosted.SPORTSCORE_UAOverride the User-Agent string sent to the SportScore API.Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.
Tools
8Saved tool list · updated 2w ago
| Parameter | Type | Required | Description |
|---|---|---|---|
| limit | integer | No | |
| sport | enum | Yes | Sport to query. One of football, basketball, cricket, tennis.football | basketball | cricket | tennis |
Details
From the project READMEsportscore-mcp
MCP server for SportScore — live scores, match details, standings, top scorers, brackets and player stats across football, basketball, cricket and tennis. Free public API, CORS-open, no API key.
Works in any Model Context Protocol host: Claude Desktop, Cursor, Continue, Zed, and custom MCP clients.
What it gives your AI assistant
- Live + recent matches by sport
- Single match detail (score, status, timeline, lineups)
- Team schedules
- League / competition standings
- Top scorers / top assisters
- Player statistics and metadata
- Knockout tournament brackets
- Live match tracker data
Install in Claude Desktop
Add this to claude_desktop_config.json:
macOS — ~/Library/Application Support/Claude/claude_desktop_config.json
Windows — %APPDATA%\Claude\claude_desktop_config.json
{
"mcpServers": {
"sportscore": {
"command": "npx",
"args": ["-y", "sportscore-mcp"]
}
}
}
Restart Claude Desktop. You should see the SportScore tools in the tools menu. Ask things like:
- "What Premier League matches are live right now?"
- "Show me the NBA standings."
- "Who are the top scorers in La Liga?"
- "What's Barcelona's next fixture?"
Install in Cursor / Continue / Zed
Any MCP host that accepts a stdio command works. The npx -y sportscore-mcp invocation is the same — consult your host's MCP docs for the exact config file.
Configuration
Environment variables (optional):
| Variable | Default | Purpose |
|---|---|---|
SPORTSCORE_API_BASE | https://sportscore.com | Override the API base URL (useful for staging / self-hosted) |
SPORTSCORE_UA | sportscore-mcp/0.3 (+https://sportscore.com/developers/) | Override the User-Agent string |
SPORTSCORE_HTTP_PORT | (unset) | If set, run as a Streamable HTTP server on this port instead of stdio |
SPORTSCORE_HTTP_HOST | 127.0.0.1 | Bind address when running in HTTP mode |
SPORTSCORE_NO_TELEMETRY | (unset) | Set to 1 to disable the opt-out install-ping (see below) |
Anonymous install-ping (opt-out)
On startup the server fires one fire-and-forget POST to https://sportscore.com/api/mcp/ping/ with this payload:
{ "client": "sportscore-mcp", "version": "0.3.0", "transport": "stdio", "host": "darwin", "node": "20.11.0" }
That's the whole payload — no user id, no IP, no cookies, no fingerprint. We use it to see rough weekly-active-installs and Node/OS spread so we know what to support. Opt out with SPORTSCORE_NO_TELEMETRY=1.
Tools
| Tool | Purpose | Required args |
|---|---|---|
get_matches | Live + recent matches | sport |
get_match_detail | Single match by slug | sport, slug |
get_team_schedule | Team fixtures | sport, slug |
get_standings | League table | sport, slug |
get_top_scorers | Top scorers / assisters | sport, slug |
get_player | Player stats | sport, slug |
get_bracket | Knockout bracket | sport, slug |
get_tracker | Live tracker data | sport, id |
Full parameter docs and response shapes: sportscore.com/developers/ · OpenAPI 3.0 spec
Attribution
This MCP server surfaces a Powered by SportScore attribution with every tool result. The free-tier API requires that attribution to remain visible in end-user-facing output — so please don't strip it from your prompts or post-processing.
Commercial / white-label use that needs to remove the attribution: [email protected]. Terms: sportscore.com/developers/terms/.
Rate limits
Free tier: approximately 1000 requests / 24h / IP, with 60-second edge caching. Sensible for any MCP workflow — a user driving a chat session will not approach the limit. Bulk / production / higher-volume use: contact [email protected].
License
MIT — see LICENSE.
Links
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.