# Realtime Sports API

> Realtime Sports API is a freemium MCP server for sports data. Live scores, play-by-play, box scores, injuries and news for 29 sports leagues. It runs as a hosted remote server, so there is nothing to install locally.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $29 a month
- **Platforms:** API, Web
- **Website:** https://www.realtimesportsapi.com/docs/mcp
- **MCP Registry name:** io.github.ahunter135/realtime-sports-api
- **Categories:** sports data
- **Listing updated:** 2026-11-16

## About

This hosted server exposes a sports data API to AI clients, covering the NFL, college football, NBA, men's college basketball, MLB, NHL and 23 soccer competitions. Data is aggregated from public sources and typically runs 20 to 30 seconds behind live play, with no SLA, so the vendor says it is not meant for in-play betting or trading.

All fifteen tools are read-only: leagues, live events, scoreboards, single games, paginated play-by-play, box scores, odds, schedules, teams, rosters, athlete search, injuries, college rankings and news. Lists return compact game objects unless full detail is requested. Standings are not available yet.

It uses the same API key as the REST API, sent as a bearer header or, for Claude Desktop custom connectors, a query parameter. Each tool call counts as one API call against the monthly quota, while connecting and listing tools are free. The vendor suggests one well-scoped call over many small ones.

## Features

- **29 leagues:** Covers major US leagues and 23 soccer competitions.
- **Live games:** Returns games in progress with score, clock and status.
- **Play-by-play:** Provides paginated plays for a game.
- **Box scores:** Gives team totals and player stats.
- **Rosters and injuries:** Lists current rosters and injury reports.
- **Schedules and rankings:** Returns date-range or weekly schedules and college polls.
- **Metered calls:** Each tool call counts as one API call.

## Good for

- Ask which NFL games are live right now
- Build a fantasy or alerts bot on current scores
- Summarise a game from its box score
- Check an injury report before a matchup
- Show a college football week's schedule

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http realtime-sports-api https://www.realtimesportsapi.com/api/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://www.realtimesportsapi.com/api/mcp
```

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

```json
{
  "mcpServers": {
    "realtime-sports-api": {
      "url": "https://www.realtimesportsapi.com/api/mcp"
    }
  }
}
```

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

```json
{
  "servers": {
    "realtime-sports-api": {
      "type": "http",
      "url": "https://www.realtimesportsapi.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "realtime-sports-api": {
      "serverUrl": "https://www.realtimesportsapi.com/api/mcp"
    }
  }
}
```

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

```json
{
  "mcpServers": {
    "realtime-sports-api": {
      "type": "http",
      "url": "https://www.realtimesportsapi.com/api/mcp"
    }
  }
}
```

## Tools

- `list_leagues`: Lists the 29 monitored leagues.
- `get_live_events`: Returns games in progress.
- `get_events`: Returns the current scoreboard.
- `get_event`: Returns full details for one game.
- `get_plays`: Returns paginated play-by-play.
- `get_box_score`: Returns team totals and player stats.
- `get_odds`: Returns current spread, moneyline and total.
- `get_schedule`: Returns games for a date range or week.
- `list_teams`: Lists teams in a league.
- `get_team`: Returns one team's record and venue.
- `get_team_roster`: Returns the current roster.
- `search_athletes`: Finds players by name.
- `get_injuries`: Returns the injury report.
- `get_rankings`: Returns college polls.
- `get_news`: Returns league or team headlines.

## FAQ

### How fresh is the data?

Typically 20 to 30 seconds behind live play, with no SLA.

### Is there a free plan?

Yes. A free key gives 1,000 calls in the first 30 days, then 125 a month, and live in-game data needs the trial or a paid plan.

### What does a paid plan cost?

Starter is $29 a month for 10,000 calls; higher plans run up to $299 a month.

### Can I use it commercially?

The pricing page says commercial use is allowed on every plan, but you cannot resell the raw feed.

### Is Realtime Sports API free?

Realtime Sports API has a free plan, with paid plans for more usage or features. Paid plans start at $29 a month.

### How do I add Realtime Sports API to Claude Code?

Run this command in your terminal: claude mcp add --transport http realtime-sports-api https://www.realtimesportsapi.com/api/mcp

### What are the best alternatives to Realtime Sports API?

The closest alternatives to Realtime Sports API 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/realtime-sports-api
