# Sports Data MCP | ESPN Scores, Standings, Stats & Odds (`trev0n/sports-data-mcp`) Actor

MCP server for AI agents and a batch scraper: live scores, fixtures, standings, rosters, schedules, box scores, player stats, odds and news for NFL, NBA, MLB, NHL, 17 soccer leagues, F1, UFC, golf and tennis.

- **URL**: https://apify.com/trev0n/sports-data-mcp.md
- **Developed by:** [Paweł](https://apify.com/trev0n) (community)
- **Categories:** AI, MCP servers, Integrations
- **Features:** Limited permissions, Single-tenant, Server interface
- **Stats:** 1 total users, 0 monthly users, 0.0% runs succeeded, 0 bookmarks
- **User rating**: No ratings yet

## Pricing

from $4.00 / 1,000 tool calls

This Actor is paid per event and usage. You are charged both the fixed price for specific events and for Apify platform usage.

Learn more: https://docs.apify.com/actors/running/actors-in-store.md#pay-per-event

## What's an Apify Actor?

An Actor is a serverless cloud program that runs on the Apify platform. It has two run modes.
In Batch mode, an Actor accepts a well-defined JSON input, performs an action which can take anything from a few seconds to a few hours,
and optionally produces a well-defined JSON output, datasets with results, or files in key-value store.
In Standby mode, an Actor provides a web server which can be used as a website, API, or an MCP server.

Apify vocabulary and the platform model are defined once, in the agent quickstart at https://apify.com/agents.md.

## How to integrate an Actor?

If asked about integration, you help developers integrate Actors into their projects.
You adapt to their stack and deliver integrations that are safe, well-documented, and production-ready.

Do not guess an integration path. Every one of them is in the agent quickstart at https://apify.com/agents.md: the Apify MCP server, Agent Skills with the Apify CLI, the JavaScript and Python clients, the REST API, and the account-free path for an agent with no human to sign in. It also carries the rule on stating cost before the first paid run.

For examples already wired to this Actor's own input schema, see the [API](#api) section below.

Each client library has reference documentation the quickstart does not restate: [JavaScript/TypeScript](https://docs.apify.com/api/client/js/docs.md) (`npm install apify-client`) and [Python](https://docs.apify.com/api/client/python/docs.md) (`pip install apify-client`).

# README

## 🏆 Sports Data MCP | ESPN Scores, Standings, Stats & Odds

🎯 **Live scores, tables, box scores and player stats for 30 leagues, ready for your AI assistant or your spreadsheet.**

Get **live scores and fixtures, standings, team rosters, season schedules, full box scores, betting lines, player profiles and the latest news** for the NFL, NBA, MLB, NHL, college sports, 17 soccer competitions including the Premier League and Champions League, plus Formula 1, UFC, PGA golf and ATP / WTA tennis. Plug it into Claude, ChatGPT or Cursor as an **MCP server**, or run it as a classic scraper and export the data.

### 🚀 What Does It Do?

This tool collects **structured, ready-to-use sports data** from ESPN's public sports feeds. Ask for today's games, last night's box score, the current league table or a player's season averages and get clean JSON back in about a second. No ESPN account, no API key.

💡 **Two ways to use it:**

1. **🤖 MCP server for AI agents**: connect Claude Desktop, Claude Code, ChatGPT, Cursor, Windsurf or your own bot. Your assistant answers "who won last night?" or "how is Arsenal doing?" with real, current numbers.
2. **📋 Classic run**: pick a tool and a league, hit Start, and download the results as JSON, CSV or Excel.

### 👥 Who Is This For?

| 🏢 Use Case                        | 💬 How It Helps                                                          |
| ---------------------------------- | ------------------------------------------------------------------------ |
| 🤖 **AI chatbot & agent builders** | Give your assistant live scores and stats instead of stale training data |
| 📊 **Fantasy & betting analysts**  | Pull box scores, player stats, odds and injury flags into your models    |
| 📰 **Sports media & newsletters**  | Auto-generate result roundups, tables and previews every morning         |
| 📱 **App & bot developers**        | Power Discord, Slack or Telegram bots with scores and standings          |
| 🎓 **Students & researchers**      | Build datasets of results and player performance across seasons          |
| 🍻 **Sports bars & fan sites**     | Show today's fixtures, TV channels and live scores                       |

### ✨ Features

- 🌍 **30 leagues**: NFL, NCAA football, NBA, WNBA, NCAA basketball, MLB, NHL, 17 soccer leagues, F1, UFC, PGA, ATP, WTA
- ⏱️ **Live scores & fixtures**: today, any past day, or a date range up to 31 days
- 📊 **Standings**: conferences, divisions and league tables with every column ESPN shows
- 📋 **Box scores**: team stats, top performers, key events (goals, cards, scoring plays) and full player lines
- 💵 **Betting lines**: spread, over/under and moneyline where available
- 👥 **Rosters**: jersey, position, age, height, weight, college and injury status
- 🗓️ **Team schedules**: every game of the season with opponents, scores and W / L / D
- 🧑 **Player profiles**: bio, draft info, season averages with league rank and career tables
- 🔎 **Smart search**: find any player or team by name and get the ids you need
- 📰 **News**: latest headlines, previews and recaps per league
- ⚡ **Fast & Scalable**: most answers in about one second
- 📤 **Export Anywhere**: Download results as JSON, CSV, Excel, or push to Google Sheets, Zapier, Make, or your CRM

### 🧰 Tools Your Agent Gets

| Tool                     | What It Does                                         |
| ------------------------ | ---------------------------------------------------- |
| ⏱️ **get_scoreboard**    | Scores and fixtures for a day or a date range        |
| 📊 **get_standings**     | League table / conference standings                  |
| 🏟️ **list_teams**        | Every team in a league with its id                   |
| 🗓️ **get_team_schedule** | A team's season schedule and results                 |
| 👥 **get_roster**        | A team's current roster                              |
| 📋 **get_game_summary**  | Box score, leaders, key events and odds for one game |
| 📰 **get_news**          | Latest headlines for a league                        |
| 🔎 **search_sports**     | Find players and teams by name                       |
| 🧑 **get_athlete**       | Player profile and statistics                        |

### 🔌 Connect Your AI Assistant

Use this server address in any MCP client:

```
https://trev0n--sports-data-mcp.apify.actor/mcp
```

Sign in with your Apify account when your client asks, or send your Apify API token as a Bearer token. Example for Claude Desktop or Cursor:

```json
{
    "mcpServers": {
        "sports-data": {
            "url": "https://trev0n--sports-data-mcp.apify.actor/mcp",
            "headers": { "Authorization": "Bearer YOUR_APIFY_TOKEN" }
        }
    }
}
```

### 🎛️ Filters & Options

| Option                                 | What It Does                                      |
| -------------------------------------- | ------------------------------------------------- |
| 🧭 **Tool**                            | Which data to fetch                               |
| 🏟️ **League**                          | One of 30 supported leagues and tours             |
| 📅 **Date / Date to**                  | Day or date range for scores                      |
| 🔎 **Search name**                     | Player or team name to look up                    |
| 🆔 **Team ID / Event ID / Athlete ID** | Pick a team, game or player                       |
| 🗓️ **Season**                          | Past seasons for standings and schedules          |
| 👥 **Include player box score**        | Full per-player stats in game summaries           |
| 🔢 **Max results**                     | How many games, articles or search hits to return |

### 📦 What You Get (Output Fields)

#### ⏱️ Game

| Field        | Example                        |
| ------------ | ------------------------------ |
| league       | `champions-league`             |
| eventId      | `401915311`                    |
| name         | `VfB Stuttgart at Galatasaray` |
| date         | `2026-11-03T17:45Z`            |
| status       | `post`                         |
| statusDetail | `FT`                           |
| venue        | `RAMS Park`                    |
| broadcasts   | `["Paramount+"]`               |

#### 🆚 Competitors

| Field        | Example       |
| ------------ | ------------- |
| name         | `Galatasaray` |
| abbreviation | `GAL`         |
| homeAway     | `home`        |
| score        | `2`           |
| winner       | `true`        |
| record       | `2-0-2`       |

#### 📊 Standings Row

| Field      | Example              |
| ---------- | -------------------- |
| group      | `Eastern Conference` |
| rank       | `1`                  |
| team       | `Boston Celtics`     |
| wins       | `11`                 |
| losses     | `2`                  |
| winPercent | `0.846`              |
| streak     | `W6`                 |

#### 🧑 Player

| Field         | Example                                                   |
| ------------- | --------------------------------------------------------- |
| name          | `LeBron James`                                            |
| team          | `Philadelphia 76ers`                                      |
| position      | `Forward`                                                 |
| draft         | `2003: Rd 1, Pk 1 (CLE)`                                  |
| seasonSummary | `{"Points Per Game": "15.1", "Rebounds Per Game": "7.2"}` |

### 📊 Example Output

```json
{
    "league": "champions-league",
    "eventId": "401915311",
    "name": "VfB Stuttgart at Galatasaray",
    "shortName": "VFB @ GAL",
    "date": "2026-11-03T17:45Z",
    "endDate": null,
    "status": "post",
    "statusDetail": "FT",
    "completed": true,
    "venue": "RAMS Park",
    "competitors": [
        {
            "id": "432",
            "name": "Galatasaray",
            "abbreviation": "GAL",
            "homeAway": "home",
            "score": "2",
            "winner": true,
            "record": "2-0-2"
        },
        {
            "id": "134",
            "name": "VfB Stuttgart",
            "abbreviation": "VFB",
            "homeAway": "away",
            "score": "0",
            "winner": false,
            "record": "2-1-1"
        }
    ],
    "broadcasts": ["Paramount+"],
    "odds": null,
    "matches": [],
    "url": "https://www.espn.com/soccer/match/_/gameId/401915311/vfb-stuttgart-galatasaray",
    "tool": "get_scoreboard",
    "scrapedAt": "2026-11-16T10:23:24.730Z"
}
```

### 📋 Dataset Views

The Apify Console gives you **3 ready-made table views** to quickly browse your results:

| View                | What It Shows                                             |
| ------------------- | --------------------------------------------------------- |
| ⏱️ **Games**        | Date, matchup, status, teams and scores, venue and TV     |
| 📊 **Standings**    | Rank, team, wins, losses, draws, points, win % and streak |
| 📋 **Full details** | Every single field, the complete dataset                  |

### 💰 Pricing

You pay only for answers. As an MCP server you are charged **per successful tool call that returns data**: calls that find nothing or fail are free. In a classic run you pay **per result** saved to your dataset.

### ❓ FAQ

**🏟️ Which leagues are covered?**
NFL, NCAA Football, NBA, WNBA, NCAA Men's and Women's Basketball, MLB, NHL, Premier League, Championship, LaLiga, Bundesliga, Serie A, Ligue 1, Eredivisie, Primeira Liga, Scottish Premiership, Super Lig, MLS, Liga MX, Brasileirao, Argentine Primera, Champions League, Europa League, FIFA World Cup, Formula 1, UFC, PGA Tour, ATP and WTA.

**⏱️ How live are the scores?**
As live as ESPN's own scoreboard: in-progress games show the current score, period and clock.

**🔑 Do I need an ESPN account or API key?**
No. Only your Apify account.

**🆔 Where do I get team, game and player ids?**
Use **search_sports** or **list_teams** for team and player ids, and **get_scoreboard** or **get_team_schedule** for game ids. AI agents chain these by themselves.

**ℹ️ Is this an official ESPN product?**
No. This is an independent tool that reads ESPN's publicly available sports data. It is not affiliated with or endorsed by ESPN.

### 💬 Need Something Custom?

🛠️ Need another league, play-by-play, historical seasons in bulk, scheduled result exports or alerts when your team scores? **Send me a private message on Apify** and I will build it for you. Feature requests and feedback are always welcome! 🙌

# Actor input Schema

## `tool` (type: `string`):

The data to fetch.

## `league` (type: `string`):

Team tools (standings, teams, schedule, roster) work for team sports only.

## `date` (type: `string`):

Day in YYYY-MM-DD for get_scoreboard. Empty = today.

## `dateTo` (type: `string`):

End of a date range in YYYY-MM-DD.

## `query` (type: `string`):

For search_sports, e.g. LeBron James or Arsenal.

## `teamId` (type: `string`):

ESPN team id for roster / schedule (from list_teams or search_sports), e.g. 13.

## `eventId` (type: `string`):

ESPN event id for get_game_summary (from the scoreboard or a schedule).

## `athleteId` (type: `string`):

ESPN athlete id for get_athlete, e.g. 1966.

## `season` (type: `integer`):

Season year for standings / schedule. Empty = current.

## `includePlayers` (type: `boolean`):

For get_game_summary.

## `limit` (type: `integer`):

For scoreboard, news and search.

## Actor input object example

```json
{
  "tool": "get_scoreboard",
  "league": "nba",
  "includePlayers": true,
  "limit": 50
}
```

# Actor output Schema

## `results` (type: `string`):

No description

## `summary` (type: `string`):

No description

# API

You can run this Actor programmatically using our API. Below are code examples in JavaScript, Python, and CLI, as well as the OpenAPI specification and MCP server setup.

## JavaScript example

```javascript
import { ApifyClient } from 'apify-client';

// Initialize the ApifyClient with your Apify API token
// Replace the '<YOUR_API_TOKEN>' with your token
const client = new ApifyClient({
    token: '<YOUR_API_TOKEN>',
});

// Prepare Actor input
const input = {
    "tool": "get_scoreboard",
    "league": "nba"
};

// Run the Actor and wait for it to finish
const run = await client.actor("trev0n/sports-data-mcp").call(input);

// Fetch and print Actor results from the run's dataset (if any)
console.log('Results from dataset');
console.log(`💾 Check your data here: https://console.apify.com/storage/datasets/${run.defaultDatasetId}`);
const { items } = await client.dataset(run.defaultDatasetId).listItems();
items.forEach((item) => {
    console.dir(item);
});

// 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/js/docs

```

## Python example

```python
from apify_client import ApifyClient

# Initialize the ApifyClient with your Apify API token
# Replace '<YOUR_API_TOKEN>' with your token.
client = ApifyClient("<YOUR_API_TOKEN>")

# Prepare the Actor input
run_input = {
    "tool": "get_scoreboard",
    "league": "nba",
}

# Run the Actor and wait for it to finish
run = client.actor("trev0n/sports-data-mcp").call(run_input=run_input)

# Fetch and print Actor results from the run's dataset (if there are any)
print(f"💾 Check your data here: https://console.apify.com/storage/datasets/{run.default_dataset_id}")
for item in client.dataset(run.default_dataset_id).iterate_items():
    print(item)

# 📚 Want to learn more 📖? Go to → https://docs.apify.com/api/client/python/docs/quick-start

```

## CLI example

```bash
echo '{
  "tool": "get_scoreboard",
  "league": "nba"
}' |
apify call trev0n/sports-data-mcp --silent --output-dataset

```

## MCP server setup

```json
{
    "mcpServers": {
        "apify": {
            "type": "http",
            "url": "https://mcp.apify.com/?tools=fetch-actor-details,trev0n/sports-data-mcp"
        }
    }
}
```

The hosted server signs you in with OAuth on first connect, so no API token belongs in this config. Clients without OAuth support can send an `Authorization: Bearer <APIFY_API_TOKEN>` header instead, using a token from API & Integrations in Apify Console (https://console.apify.com/settings/integrations).

## OpenAPI specification

Download the OpenAPI definition: https://api.apify.com/v2/actors/KAKruoxxYRcZShocO/builds/VB998dOZlUfXXzN7e/openapi.json
