[Integrations](https://spiral.ai/integrations) › [Windsurf](https://spiral.ai/integrations/windsurf) › [ESPN team schedule](https://spiral.ai/integrations/windsurf/espn-team-schedule)

# How to Use ESPN team schedule in Windsurf

Get a team's fixtures and results, with opponents, start times, scores and game status. Use it to build a game calendar or compare recent results after identifying the team.

|  |  |
| --- | --- |
| Model | ESPN team schedule |
| Available through | Alexandria |
| Category | Sports |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with ESPN team schedule in Windsurf

- Use ESPN team schedule to fetch the Boston Celtics' upcoming games and add opponents and start times to this project's calendar view.
- Use ESPN team schedule to retrieve Chelsea's last five completed Premier League games and render the opponents and scores in this project's results table.
- Use ESPN team schedule to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from ESPN team schedule and tell me what changed since last week.
- Check ESPN team schedule and summarize what you find in three bullet points.

## How to set up ESPN team schedule in Windsurf

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Open the Customize page from the Agents window and click MCPs. Under This computer, open the config file, or edit it directly: `~/.config/devin/mcp_config.json` on macOS and Linux, `%APPDATA%\devin\mcp_config.json` on Windows. Add this:

```json
{
  "mcpServers": {
    "spiral": {
      "url": "https://api.spiral.ai/mcp"
    }
  }
}
```

2. **Sign in**: Click Authenticate on the Spiral server in Customize › MCPs, or let the agent call Spiral once: your browser opens. Sign in to Spiral, pick the organization and click Authorize. No API key.

```bash
devin mcp login spiral
```

3. **Check it**: Spiral is listed under This computer in Customize › MCPs. From the terminal:

```bash
devin mcp list
```

### Use the Spiral skill

1. **Send Windsurf this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run ESPN team schedule**: One request; the result comes back by polling or a webhook.

```bash
curl https://api.spiral.ai/v1/runs \
  -H "Authorization: Bearer $SPIRAL_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "provider": "alexandria",
    "model": "espn-com/sports-data/team_schedule",
    "input": {
      "sport": "<sport>",
      "league": "<league>",
      "team_id": "<team_id>"
    }
  }'
```

Then paste one of the prompts above: Windsurf finds ESPN team schedule on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/windsurf

## ESPN team schedule tools and prices

- [ESPN · Team schedule](https://spiral.ai/tools/alexandria/espn-com/sports-data/team_schedule) (Alexandria): $0.00873 per call.

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 200 | 50 | Page size (default 50, max 200). |
| offset | 0 to … | 0 | Zero-based offset into the full upstream list. |
| season | 1900 to 2100 | — | ESPN season year, as ESPN labels it: the start year for soccer and the NFL (2025 = 2025-26 Premier League, 2026 = 2026 NFL season), the end year for US leagues spanning two calendar years such as the NHL and NBA (2027 = 2026-27). Omit for the current season. Past seasons are supported. |
| seasontype | 1, 2, 3 | — | 1 preseason, 2 regular season (ESPN's default for US leagues), 3 postseason. |

## What can you do with ESPN team schedule in Windsurf?

Build a personal sports app with a league team selector and a game calendar. A coding agent can connect ESPN team identities to fixtures, scores and explicit game status in your project's views.

### Personal game calendar

Match the Boston Celtics in the NBA directory, then turn their upcoming fixtures into a personal calendar with opponents and start times.

### Weekly basketball workload

Enumerate NBA teams, retrieve their schedules and count games in the coming week. Identify teams playing on consecutive dates for a fantasy basketball planning sheet.

### Recent results comparison

Resolve Arsenal and Chelsea within the Premier League, then compare their last five completed league games using opponents and scores.

### Schedule change checks

Keep a watchlist tied to ESPN team identities, then compare successive schedule responses for changed start times or game status.

### Personal sports app prototype

Populate a league team selector with names and abbreviations, then show the selected team's fixtures and completed results.

### Multi-team viewing plan

Identify the New York Knicks and Brooklyn Nets in the NBA directory, then compare upcoming start times to find overlapping games.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Windsurf guides](https://spiral.ai/integrations/windsurf)

## ESPN team schedule in other agents

- [Amp](https://spiral.ai/integrations/amp/espn-team-schedule)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/espn-team-schedule)
- [Claude](https://spiral.ai/integrations/claude-desktop/espn-team-schedule)
- [Claude Code](https://spiral.ai/integrations/claude-code/espn-team-schedule)
- [Cline](https://spiral.ai/integrations/cline/espn-team-schedule)
- [Codex](https://spiral.ai/integrations/codex/espn-team-schedule)
- [Cursor](https://spiral.ai/integrations/cursor/espn-team-schedule)
- [Devin](https://spiral.ai/integrations/devin/espn-team-schedule)
- [dots](https://spiral.ai/integrations/dots/espn-team-schedule)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/espn-team-schedule)
- [Gemini](https://spiral.ai/integrations/gemini/espn-team-schedule)
- [Gemini CLI](https://spiral.ai/integrations/gemini-cli/espn-team-schedule)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/espn-team-schedule)
- [goose](https://spiral.ai/integrations/goose/espn-team-schedule)
- [Grok](https://spiral.ai/integrations/grok/espn-team-schedule)
- [Grok Build](https://spiral.ai/integrations/grok-build/espn-team-schedule)
- [Hermes](https://spiral.ai/integrations/hermes/espn-team-schedule)
- [Instinct](https://spiral.ai/integrations/instinct/espn-team-schedule)
- [Manus](https://spiral.ai/integrations/manus/espn-team-schedule)
- [Muse](https://spiral.ai/integrations/muse/espn-team-schedule)
- [Muse Code](https://spiral.ai/integrations/muse-code/espn-team-schedule)
- [n8n](https://spiral.ai/integrations/n8n/espn-team-schedule)
- [Notion](https://spiral.ai/integrations/notion/espn-team-schedule)
- [OpenClaw](https://spiral.ai/integrations/openclaw/espn-team-schedule)
- [opencode](https://spiral.ai/integrations/opencode/espn-team-schedule)
- [Perplexity](https://spiral.ai/integrations/perplexity/espn-team-schedule)
- [Raycast](https://spiral.ai/integrations/raycast/espn-team-schedule)
- [VS Code](https://spiral.ai/integrations/vscode/espn-team-schedule)
- [Zapier](https://spiral.ai/integrations/zapier/espn-team-schedule)

## More Windsurf guides

- [ESPN team roster](https://spiral.ai/integrations/windsurf/espn-team-roster)
- [FFToday season projections](https://spiral.ai/integrations/windsurf/fftoday-season-projections)
- [ESPN team directory](https://spiral.ai/integrations/windsurf/espn-team-directory)
- [FFToday weekly projections](https://spiral.ai/integrations/windsurf/fftoday-weekly-projections)
- [ESPN team details](https://spiral.ai/integrations/windsurf/espn-team-details)
- [FFToday weekly rankings](https://spiral.ai/integrations/windsurf/fftoday-weekly-rankings)

## Questions about ESPN team schedule in Windsurf

**Can Windsurf use ESPN team schedule?**

Yes. Add Spiral to Windsurf as an MCP server, and Windsurf can find and run ESPN team schedule like any built-in tool.

**How much does ESPN team schedule cost in Windsurf?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Windsurf plan is separate.

**Do I need an Alexandria account to use ESPN team schedule in Windsurf?**

No. Spiral runs ESPN team schedule on its own Alexandria account. You sign in to Spiral once and never paste a key.

**How long does it take to set up ESPN team schedule in Windsurf?**

About two minutes: add the server, then sign in, then check it.

**Does Windsurf wait while ESPN team schedule runs?**

ESPN team schedule runs in the background. Windsurf starts the run, checks on it and gives you the json when it's ready.

**Is ESPN's coverage limited to US sports?**

No. The documented coverage includes US and international sports, including the NFL, NBA, MLB and NHL. Its boundary is what ESPN exposes, so it is not a promise of every league worldwide.

**Where does this ESPN data come from?**

It comes from ESPN's public site and core JSON APIs. The team directory identifies clubs within a league, while the schedule data describes their games.

**Can two ESPN teams have the same name?**

Yes. ESPN's documented example includes Arsenal in both the Premier League and the Women's Super League. Match the competition as well as the club name before comparing records.

**Does ESPN guarantee this data will always be available?**

Disney's terms covering ESPN supply the products as is and as available. That is a limit on the source's warranty, not a guarantee of uninterrupted data availability.

**Does public access permit commercial reuse?**

Disney's terms prohibit commercial or business uses except as expressly licensed. Public accessibility alone does not establish permission to redistribute ESPN content commercially.

