# SportAPI

> SportAPI is a freemium MCP server for sports data. Live and prematch sports odds, scores and statistics, with demo data and no key. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://sportapi.net
- **Repository:** https://github.com/sportapi-net/sportapi-mcp
- **MCP Registry name:** io.github.SportApi-net/sportapi-mcp
- **Categories:** sports data
- **Listing updated:** 2026-11-16

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

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

### Claude Desktop (claude_desktop_config.json)

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

### Cursor (~/.cursor/mcp.json)

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

### VS Code (.vscode/mcp.json)

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

### Windsurf (~/.codeium/windsurf/mcp_config.json)

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

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `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

## 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

- [Twenty Clubs](https://ai-powered.com/mcp/twenty-clubs): Twenty Clubs is a free MCP server for sports data.
- [SkorMerkez Live Football Scores](https://ai-powered.com/mcp/skormerkez-live-football-scores): SkorMerkez Live Football Scores is a free MCP server for sports data.
- [Cast the Water](https://ai-powered.com/mcp/cast-the-water): Cast the Water is a free MCP server for maps and travel.
- [RacketPlus Badminton](https://ai-powered.com/mcp/racketplus-badminton): RacketPlus Badminton is a freemium MCP server for sports data.
- [SSTracker free youth training](https://ai-powered.com/mcp/sstracker-free-youth-training): SSTracker free youth training is a freemium MCP server for sports data.
- [ArenaCalc Race Pace & Endurance Split Calculator](https://ai-powered.com/mcp/arenacalc-race-pace-and-endurance-split-calculator): ArenaCalc Race Pace & Endurance Split Calculator is a free MCP server for sports data.
- [Monday Miracle: Fantasy Football](https://ai-powered.com/mcp/monday-miracle-fantasy-football): Monday Miracle: Fantasy Football is a freemium MCP server for sports data.
- [Marathon Scout](https://ai-powered.com/mcp/marathon-scout): Marathon Scout is a free MCP server for sports data.

---
Source: https://ai-powered.com/mcp/sportapi
