io.github.Backspace-me/sportscore-mcp
Live scores, standings, top scorers, brackets for football, basketball, cricket, tennis. Free API.
Open source Open in the app JSON README (API)
About
Live scores, standings, top scorers, brackets for football, basketball, cricket, tennis. Free API.
Details
- Kind
- MCP servers
- Topic
- No topic detected
- Publisher
- backspace-me
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 0.1.1
- Stars
- 10
- Last push
- 2026-04-23T21:07:34Z
- Repository state
- ativo
- Language
- JavaScript
- License
- MIT
- Added
- 2026-08-29 03:01:42
- Updated
- 2026-08-29 03:01:42
- Origin id
io.github.Backspace-me/sportscore-mcp
README
# sportscore-mcp
MCP server for [SportScore](https://sportscore.com/) — 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.
[](https://glama.ai/mcp/servers/Backspace-me/sportscore-mcp)
Works in any [Model Context Protocol](https://modelcontextprotocol.io/) 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`
```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:
```json
{ "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/](https://sportscore.com/developers/) · [OpenAPI 3.0 spec](https://sportscore.com/developers/openapi.yaml)
## 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: [api@sportscore.com](mailto:api@sportscore.com). Terms: [sportscore.com/developers/terms/](https://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 [api@sportscore.com](mailto:api@sportscore.com).
## License
MIT — see [LICENSE](./LICENSE).
## Links
- [SportScore](https://sportscore.com/)
- [Developer portal + REST API docs](https://sportscore.com/developers/)
- [OpenAPI 3.0 spec](https://sportscore.com/developers/openapi.yaml)
- [API terms of use](https://sportscore.com/developers/terms/)
- [Report an issue](https://github.com/Backspace-me/sportscore-mcp/issues)