Skip to content
MCP server

SportAPI

Live and prematch sports odds, scores and statistics, with demo data and no key

Runs locallyStatus and history
Pricing
Freemium
Platforms
CLI, API
Runs
Locally
Version
0.1.0
Listing updated
1 day ago

About SportAPI

SportAPI is a freemium MCP server for sports data. It runs locally on your machine and is started by your AI client.

Despite the name, this server is a thin client for SportAPI, a commercial sportsbook data service whose own site is pitched at building betting products: odds, markets, bet placement and bet slip settlement. The MCP server itself is free and MIT-licensed and exposes 11 read-only tools over the Sport Line API: sports, countries, tournaments, live and prematch match lists, a calendar, full match details, team search, top matches and the key's account status.

Without a key every tool returns example responses from the SportAPI documentation, and each result is labelled as demo data so an assistant does not present it as live. Output is compacted to save tokens, with odds rendered as one line per market and get_match returning 15 markets by default because a detailed match can carry 200 or more. Requests go through a cache that respects the provider's minimum update intervals. Two prompts offer a live betting overview and a market comparison with implied probabilities and bookmaker margin.

It installs with uvx or pip and runs over stdio, with Streamable HTTP optional.

Install

Run in a terminal

claude mcp add sportapi-mcp --env SPORTAPI_KEY='<SPORTAPI_KEY>' -- uvx sportapi-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "sportapi-mcp": {
      "command": "uvx",
      "args": [
        "sportapi-mcp"
      ],
      "env": {
        "SPORTAPI_KEY": "<SPORTAPI_KEY>"
      }
    }
  }
}

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "sportapi-mcp": {
      "command": "uvx",
      "args": [
        "sportapi-mcp"
      ],
      "env": {
        "SPORTAPI_KEY": "<SPORTAPI_KEY>"
      }
    }
  }
}

Add to .vscode/mcp.json

{
  "servers": {
    "sportapi-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "sportapi-mcp"
      ],
      "env": {
        "SPORTAPI_KEY": "<SPORTAPI_KEY>"
      }
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "sportapi-mcp": {
      "command": "uvx",
      "args": [
        "sportapi-mcp"
      ],
      "env": {
        "SPORTAPI_KEY": "<SPORTAPI_KEY>"
      }
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "sportapi-mcp": {
      "command": "uvx",
      "args": [
        "sportapi-mcp"
      ],
      "env": {
        "SPORTAPI_KEY": "<SPORTAPI_KEY>"
      }
    }
  }
}

Configuration

  • SPORTAPI_KEYSportAPI key, sent in the Package header. Leave unset for demo data.
  • SPORTAPI_BASE_URLYour personal SportAPI base URL, e.g. https://YOUR_API_DOMAIN. Leave unset for demo data.
  • SPORTAPI_LANGUAGEResponse language code enabled for your key.

Tools this server provides (4)

Taken from the project documentation; the running server may differ.

list_live_matches
List live matches for a sport
get_match
Full match details with markets and odds
search_matches
Search matches by team text
top_matches
Top matches, optionally with odds

What it does

Eleven read-only tools
Covers sports, leagues, live and prematch matches, details and search.
Demo mode
Runs on documentation examples without a key and labels them.
Compact output
Drops empty fields and prints odds one line per market.
Market filter
Limits get_match to chosen markets such as 1X2 or Total.
Polite caching
Enforces documented update intervals and avoids overlapping requests.
Analysis prompts
Live betting overview and market comparison with fair odds.

Good for

  • Asking which matches are live and who is favoured
  • Comparing prices across the goal-line market for one match
  • Finding a team's next fixture and odds
  • Checking a SportAPI key's status and usage

Pricing

Freemium

Server is free (MIT) and runs on demo data; live data needs a paid SportAPI key (prices not published)

Prices change. Check sportapi.net before you buy.

SportAPI FAQ

Do I need an API key?

Not to try it; demo data is returned without one. Live data needs a personal SportAPI key.

Is the data real-time?

Only with a key. Demo responses say they are not live.

Is the server free?

The MCP server is free and MIT-licensed; the SportAPI data service behind it is commercial.

How do I install it?

claude mcp add sportapi -- uvx sportapi-mcp.

Is SportAPI free?

SportAPI has a free plan, with paid plans for more usage or features.

How do I add SportAPI to Claude Code?

Run this command in your terminal: claude mcp add sportapi-mcp --env SPORTAPI_KEY='<SPORTAPI_KEY>' -- uvx sportapi-mcp

What are the best alternatives to SportAPI?

The closest alternatives to SportAPI are Twenty Clubs, SkorMerkez Live Football Scores, Cast the Water, RacketPlus Badminton and SSTracker free youth training.

Alternatives to SportAPI

  1. Twenty Clubs

    MCP server

    Premier League fixtures, results, table, team news, referees and UK TV from Twenty Clubs

    • 10 tools
    • Remote
    • Free
    • Sports data
  2. Ad-free, betting-free live football scores, fixtures and tables for Super Lig and Europe

    • 5 tools
    • Remote
    • Free
    • Sports data
  3. Cast the Water

    MCP server

    Read-only fish stocking records, waters and conditions for US lakes and rivers

    • 3 tools
    • Remote
    • Free
    • Maps and travel
  4. Search and compare badminton rackets and look up rankings and match results

    Not checked yet
    • Remote
    • Freemium
    • Sports data
  5. Youth sports drills by age, practice plans and answers for parents and coaches

    Not checked yet
    • 4 tools
    • Remote
    • Freemium
    • Sports data