io.github.Backspace-me/sportscore-mcp icon

sportscore-mcp

by Backspace-me

io.github.Backspace-me/sportscore-mcp

Live scores, standings, top scorers, brackets for football, basketball, cricket, tennis. Free API.

Version 0.1.1
Developer Tools
Local
View source

sportscore-mcp · v0.1.1

by Backspace-me

57

sportscore-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: api@sportscore.com. 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 api@sportscore.com.

License

MIT — see LICENSE.

Links