ESPN MCP Server

Real-Time Sports Data for Claude Code, Claude Desktop & MCP-Compatible Assistants

---

What does ESPN MCP Server do?

ESPN MCP Server connects AI assistants like Claude Code, Claude Desktop and ChatGPT directly to ESPN's real-time sports data. It exposes a suite of specialized tools covering scores, standings, team info, rosters, schedules, detailed game analysis, betting odds, athlete profiles, rankings, news and live scoreboards — all accessible through natural language prompts.

Instead of opening ESPN.com and navigating multiple pages, you ask your AI assistant: "What were last night's NBA scores?" or "Give me the full boxscore for the Lakers game." The MCP server fetches the data, formats it for AI consumption, and returns structured results — no ESPN API key required.

Without MCP	With ESPN MCP Server
Open ESPN.com, search for scores	Just ask Claude
Navigate multiple pages for stats	"Who won last night's NBA games?"
Compare tabs for game details	"Give me the full boxscore for the Lakers game"
Manually check odds on betting sites	"What are the odds for tonight's NFL games?"
Search for player career stats	"Show me LeBron's game log and season stats"
Browse different leagues separately	"Compare Premier League and La Liga standings"

One prompt. Every sport. Real-time data.

No ESPN account needed, no API key, no setup. Just connect your AI assistant and ask about any sport.

---

Quick Start — Connect in 2 minutes

Step 1: Get your Apify API Token

Go to Apify Console → Settings → Integrations and copy your API token.

Step 2: Add a custom connector

In Claude Code or Claude Desktop, go to Settings → MCP Servers → Add custom connector and paste:

https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Replace YOUR_APIFY_TOKEN with the token from Step 1.

Step 3: Grant permanent permissions (recommended)

By default, Claude asks for approval every time an MCP tool is called. To allow all ESPN tools permanently:

In Claude Code, run /permissions and add mcp__ESPN__* to the Allow list.

In Claude Desktop, click "Always allow" when prompted for the first tool call.

Step 4: Start asking

"What are today's NBA scores?"

That's it. The ESPN tools are immediately available. Works with Claude Code, Claude Desktop, ChatGPT, Cursor, Windsurf, and any MCP-compatible client.

---

What can ESPN MCP Server do?

• MCP tools — Scores, standings, teams, rosters, schedules, news, game summaries, odds, athlete profiles, rankings, search, and live scoreboards
• 25+ sports & leagues — NFL, NBA, MLB, NHL, WNBA, College Football/Basketball, Premier League, La Liga, Bundesliga, Serie A, Champions League, MLS, UFC, PGA, F1, NASCAR, ATP, WTA, and more
• No ESPN API key — Uses ESPN's public data endpoints, no separate registration required
• Always-on — Runs in Apify Standby mode with ultra-low latency (~200ms response times)
• Smart caching — 3-tier in-memory cache (60s for live data, 5min for standings, 15min for static data)
• LLM-optimized — Formatted text responses designed to minimize token usage while preserving all important data

---

What can you ask your AI assistant?

Live scores & game day

"What are today's NBA scores?"

"Is there a Monday Night Football game tonight? What's the score?"

"Show me all Premier League matches this weekend"

Deep game analysis

"Give me the full boxscore and player stats for last night's Lakers vs Celtics game"

"Who were the top performers in yesterday's NFL games?"

Team intelligence

"Show me the current NFL standings with win-loss records"

"What's the Golden State Warriors roster? Who are their key players?"

"What's the Lakers schedule for the rest of the season?"

Player research

"Show me LeBron James' career stats and this season's game log"

"Compare Patrick Mahomes' splits at home vs away this season"

Betting & odds

"What are the betting odds for tonight's NBA games? Show me the spread and moneyline"

"What was the over/under for the Super Bowl?"

News & rankings

"What's the latest NFL news?"

"Show me the current AP Top 25 college football rankings"

"Get the ATP tennis rankings"

---

What tools are available?

Changed in this release: Game dates and times are now rendered using US Eastern time by default instead of UTC. Outputs containing a clock time include the timezone, such as 7:30 PM EST. Pass timezone to use another IANA timezone.

Once connected, your AI assistant can use these tools:

Tool	Description	Example
espn_scoreboard	Live and recent scores for any sport/league	Today's NBA scores, yesterday's MLB results
espn_standings	Current league standings with W/L records	NFL division standings, Premier League table
espn_teams	List all teams or get detailed team info	All NBA teams, Lakers team details
espn_team_roster	Full team roster with player details	Current Warriors roster with positions
espn_team_schedule	Team game schedule (past & upcoming)	Remaining Celtics schedule
espn_news	Latest sports news headlines and articles	Top NFL headlines this week
espn_game_summary	Most detailed — Full boxscore, player stats, venue, officials, attendance, leaders, scoring summary	Full breakdown of last night's game
espn_game_odds	Betting odds from multiple providers (Consensus, DraftKings, Caesars, Bet365)	Tonight's spread and over/under
espn_athletes	Athlete profiles, game logs, splits, career stats	LeBron's season averages and game log
espn_rankings	College, UFC, and tennis rankings	AP Top 25, UFC pound-for-pound
espn_search	Search ESPN for players, teams, and leagues	Find a player by name
espn_live_scoreboard	CDN-optimized live scoreboard with real-time updates	Live scores right now
espn_play_by_play	Play-by-play for a game, filterable by period or last N plays	Every play of the 4th quarter

---

About the MrBridge MCP fleet

Maintained by MrBridge. Full details on the ESPN MCP server page, or see all MrBridge MCP servers. New to the protocol? Start with What is MCP and why it matters.

Which sports and leagues are supported?

Sport	Leagues	Codes
Football	NFL, College Football	football/nfl, football/college-football
Basketball	NBA, WNBA, Men's College, Women's College	basketball/nba, basketball/wnba, basketball/mens-college-basketball
Baseball	MLB	baseball/mlb
Hockey	NHL	hockey/nhl
Soccer	Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, MLS	soccer/eng.1, soccer/esp.1, soccer/ger.1, soccer/ita.1, soccer/fra.1, soccer/uefa.champions, soccer/usa.1
MMA	UFC	mma/ufc
Golf	PGA Tour, LPGA	golf/pga, golf/lpga
Racing	Formula 1, NASCAR	racing/f1, racing/nascar-premier
Tennis	ATP, WTA	tennis/atp, tennis/wta

Use these codes in the sport and league parameters when calling tools.

---

How do I connect via Claude Desktop?

If you prefer Claude Desktop with a JSON config file, add to your claude_desktop_config.json:

• Windows: %APPDATA%\Claude\claude_desktop_config.json
• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "ESPN": {
      "command": "npx",
      "args": ["-y", "@anthropic/mcp-proxy", "https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN"]
    }
  }
}

Replace YOUR_APIFY_TOKEN with your Apify API token.

Restart Claude Desktop and test with: "What are today's NBA scores?"

Tip: Claude Desktop will ask you to approve each tool the first time it's used. Click "Allow for this chat" or "Always allow" to avoid repeated permission prompts.

---

Connect from Cursor IDE

Add to your Cursor MCP settings (.cursor/mcp.json in your project or global config):

{
  "mcpServers": {
    "ESPN": {
      "url": "https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN"
    }
  }
}

Then ask Cursor's AI: "What are tonight's NBA scores?"

---

Connect from Windsurf

In Windsurf, go to Settings → MCP and add a new server with the URL:

https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

All ESPN tools become available in Windsurf's AI assistant.

---

Connect from VS Code (Copilot, Cline, Continue)

GitHub Copilot (VS Code)

Add to your .vscode/mcp.json:

{
  "servers": {
    "ESPN": {
      "type": "http",
      "url": "https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN"
    }
  }
}

Cline Extension

In Cline settings, go to MCP Servers → Remote Servers and add:

https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

Continue Extension

Add to your .continue/config.yaml:

mcpServers:
  - name: ESPN
    url: https://mrbridge--espn-mcp-server.apify.actor/mcp?token=YOUR_APIFY_TOKEN

---

Integrate with Zapier, Make & n8n

ESPN MCP Server runs on Apify, which integrates natively with popular automation platforms. Use it to build automated sports alerts, daily briefings, or data pipelines.

Zapier

Use the Apify Zapier integration to trigger workflows:

1. Add "Apify" as a trigger app in your Zap
2. Select "Run Actor" action with Actor ID OS9xgGMTqfof7z05J
3. Connect to Gmail, Slack, Google Sheets, or 5,000+ other apps

Example Zap: Every morning at 8am → Run ESPN MCP Server → Get NBA standings → Send Slack message to #sports channel

Make (Integromat)

Use the Apify Make integration:

1. Add "Apify" module → "Run an Actor"
2. Actor ID: OS9xgGMTqfof7z05J
3. Route outputs to Google Sheets, email, Telegram, or any Make module

n8n

Use n8n's HTTP Request node to call the Apify API:

POST https://api.apify.com/v2/acts/mrbridge~espn-mcp-server/runs?token=YOUR_APIFY_TOKEN

Or use the Apify n8n node for a no-code setup.

---

Use via Apify API

Call ESPN MCP Server programmatically without an MCP client:

JavaScript / TypeScript

import { ApifyClient } from 'apify-client';

const client = new ApifyClient({ token: 'YOUR_APIFY_TOKEN' });

const run = await client.actor('mrbridge/espn-mcp-server').call({
    sport: 'basketball',
    league: 'nba'
});

const { items } = await client.dataset(run.defaultDatasetId).listItems();
console.log(items);

Python

from apify_client import ApifyClient

client = ApifyClient("YOUR_APIFY_TOKEN")

run = client.actor("mrbridge/espn-mcp-server").call(
    run_input={"sport": "basketball", "league": "nba"}
)

for item in client.dataset(run["defaultDatasetId"]).iterate_items():
    print(item)

cURL

curl -X POST "https://api.apify.com/v2/acts/mrbridge~espn-mcp-server/runs?token=YOUR_APIFY_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{"sport": "basketball", "league": "nba"}'

Note: For real-time AI conversations, use the MCP connection (see Quick Start). The Apify API is best for batch jobs, scheduled runs, and automation pipelines.

---

How does it work?

Claude Code / Claude Desktop / ChatGPT
        |
        |  MCP (Streamable HTTP)
        v
+-----------------------------+
|   ESPN MCP Server (Apify)   |
|   +---------------------+   |
|   |  MCP Tools           |   |
|   |  3-Tier Cache        |   |
|   |  Retry + Backoff     |   |
|   +---------------------+   |
+-------------+---------------+
              |  HTTP GET (JSON)
              v
        ESPN Public API
     (site, web, CDN endpoints)

Key design decisions:

• Stateless transport — Each request gets a fresh MCP server instance, eliminating session issues during Standby container restarts
• Concise formatting — No raw JSON dumps; structured text optimized for LLM consumption
• Graceful errors — Every tool returns human-readable error messages, never crashes

---

Is my data safe?

• No ESPN account required — The server uses ESPN's public data endpoints. No API key, no registration
• No data stored — All data is fetched in real-time and never persisted
• Read-only — The server only reads public sports data. No write operations
• Apify token — Only used for MCP authentication with Apify's platform, never shared with ESPN

---

How much does it cost?

This MCP server uses Apify's pay-per-event pricing. Two things are billed to you:

• Tool calls, priced per event. Current prices are on the Pricing tab, which is always up to date.
• Platform usage for the running container. In Standby mode the server stays warm so it can answer instantly, and it shuts down after 300 seconds of inactivity. That warm time is billed as platform usage, on top of the tool-call events.

Start with $5 free credits.

---

Troubleshooting

Problem	Solution
"Tools not showing up"	Verify your Apify token is correct. Check that the URL includes /mcp path
"Empty results"	Some endpoints require specific sport/league codes. Check the Supported Sports table
"Connection timeout"	The server starts in ~2 seconds on first request (cold start). Retry once. Subsequent requests are instant
"Game summary returns error"	Game summaries require a valid eventId. Use espn_scoreboard first to find game IDs
"Session not found"	The Standby container may have restarted. Disconnect and reconnect the MCP server in your settings

---

FAQ

What is an ESPN MCP Server?

An MCP (Model Context Protocol) server that bridges AI assistants and ESPN sports data. It exposes tools that AI assistants can call to retrieve scores, standings, stats, news, odds, and more — all through natural language prompts.

Do I need an ESPN account or API key?

No. This server uses ESPN's publicly available data endpoints. No ESPN account, no API key, no registration. You only need an Apify account (free tier available).

Does this work with ChatGPT, Cursor, or VS Code?

Yes. Any MCP-compatible client can connect. Works with Claude Code, Claude Desktop, ChatGPT, Cursor, Windsurf, and other AI tools that support the Model Context Protocol.

How real-time is the data?

Live game data is cached for 60 seconds. Standings and rosters refresh every 5 minutes. Static data (team info) refreshes every 15 minutes. For live games, you get near-real-time updates.

Which sports are supported?

25+ leagues across football (NFL, college), basketball (NBA, WNBA, college), baseball (MLB), hockey (NHL), soccer (Premier League, La Liga, Bundesliga, Serie A, Ligue 1, Champions League, MLS), MMA (UFC), golf (PGA), racing (F1, NASCAR), and tennis (ATP, WTA).

Can I get betting odds?

Yes. The espn_game_odds tool returns odds from multiple providers including Consensus, DraftKings, Caesars, and Bet365 — spreads, moneylines, over/unders, and win percentages.

Is my data secure?

This server only reads publicly available ESPN data. No personal accounts are accessed. Your Apify API token is used solely for authentication with Apify's platform.

How much does it cost?

You pay per tool call, plus the platform usage of the running container. See the full pricing breakdown.

Can I use it for fantasy sports research?

Absolutely. Use espn_athletes for player stats, game logs, and splits. Use espn_team_schedule to check upcoming matchups. Use espn_game_summary for detailed performance data. Ideal for weekly fantasy lineup decisions.

How do I find game IDs for the summary tool?

Use espn_scoreboard first to get today's games — each game includes an eventId. You can also find game IDs in ESPN URLs: espn.com/nba/game/_/gameId/401584793 → eventId is 401584793.

---

What does the output look like?

Here's a sample response from the espn_scoreboard tool for NBA scores:

NBA Scoreboard — Mar 14, 2026

Boston Celtics 112 - 105 Milwaukee Bucks (Final)
  Top: J. Tatum 32pts/8reb/6ast | G. Antetokounmpo 28pts/12reb/5ast

Los Angeles Lakers 98 - 101 Golden State Warriors (Final)
  Top: L. James 25pts/7reb/9ast | S. Curry 31pts/4reb/6ast

Dallas Mavericks 119 - 115 Phoenix Suns (Final/OT)
  Top: L. Doncic 38pts/10reb/8ast | K. Durant 35pts/6reb/4ast

And a sample from espn_game_summary with detailed boxscore:

Boston Celtics 112 - 105 Milwaukee Bucks
Venue: TD Garden, Boston, MA | Attendance: 19,156

SCORING BY QUARTER:
  BOS: 28 | 30 | 25 | 29 = 112
  MIL: 22 | 31 | 27 | 25 = 105

LEADERS:
  BOS — J. Tatum: 32pts 8reb 6ast | J. Brown: 24pts 5reb 3ast
  MIL — G. Antetokounmpo: 28pts 12reb 5ast | D. Lillard: 22pts 3reb 8ast

Other MCP servers by mrbridge

Server	Category	Tools	Best for
LoL MCP Server	Gaming	26 tools	League of Legends AI coaching & live data
TFT MCP Server	Gaming	19 tools	Teamfight Tactics comp analysis & coaching
Latest News MCP	News	14 tools	Real-time news from 27 free APIs
Todoist AI Assistant	Productivity	35 tools	Smart task management & AI prioritization

All servers use pay-per-event pricing.

---

Changelog

Release notes are available in the Actor's Changelog.

---

Resources

• Apify MCP Documentation
• MCP Protocol Specification
• Get your Apify API Token
• Claude Code
• Claude Desktop MCP Setup

---

Built for sports fans who want AI to do the research.