Use GridIron Data NFL fantasy data in Windsurf (MCP setup)

Server URL

https://api.gridirondata.com/mcp

Config

~/.config/devin/mcp_config.json

Sign-in

API key header

Time

About 2 minutes

What do I need first?

• Windsurf (now Devin Desktop) or a Windsurf plugin for JetBrains and other IDEs.
• Your GridIron Data API key from the dashboard. No account? Sign up free (no credit card).
• On Teams and Enterprise, your admin may limit MCP servers to an allowlist; once one server is allowlisted, others are blocked.

How do I add GridIron Data to Windsurf?

1. Open the MCP config. In a Windsurf plugin: Settings → Tools → Windsurf Settings → Add Server, then open the raw config. Or edit the file directly: ~/.config/devin/mcp_config.json (Windows: %AppData%/devin/mcp_config.json). Older installs used ~/.codeium/windsurf/mcp_config.json.
2. Add GridIron Data. Add this entry, with your key in an environment variable:

   {
     "mcpServers": {
       "gridiron-data": {
         "serverUrl": "https://api.gridirondata.com/mcp",
         "headers": { "Authorization": "Bearer ${env:GRIDIRON_API_KEY}" }
       }
     }
   }

3. Refresh and check. Refresh the MCP server list. gridiron-data should appear with its tools; ask Cascade a question to confirm.

Windsurf also supports OAuth for remote servers. If you leave the headers out and Windsurf shows Needs authentication, click Authenticate and sign in with your GridIron Data account. We document the API key here because we haven't confirmed Windsurf's sign-in return address against GridIron's sign-in yet.

In Devin Desktop, MCP servers are also managed from the Agents window under Customize → MCPs, with a selector for which scope to install them for.

What can I ask Windsurf?

Ask in your own words; the assistant picks the tool. A few that work well:

• "Use gridiron-data to list this week's top 10 WR projections in PPR."
• "Pull this week's QB projections and build a small table component that shows them."
• "How did Justin Jefferson do in 2023, week by week?" (Basic)
• "Any injury news on Malik Nabers this week?" (Basic)
• "What's the probability Drake Maye goes over 245.5 passing yards this week?" (Pro)

A free GridIron Data account answers player lookups and this week's projections. Stats, snap share, news, matchups, rest-of-season projections, the schedule and other weeks need Basic ($5/month or $45/year). Prop probabilities, defense vs position, betting lines, the injury-changes feed, depth charts and inactives need Pro ($29/month or $249/year), the betting plan. A question outside your plan comes back with the plan it needs, and the assistant tells you. See plans. Prop probabilities are a model estimate, not betting advice.

Player names, positions and ids are matched case-insensitively. Scoring is PPR unless you ask for half-PPR or standard. All 21 tools are listed on the AI assistant setup hub.

Troubleshooting

• Server doesn't appear. Check the JSON is valid and that you refreshed the MCP list. Remote servers use serverUrl (or url), not command.
• "unauthorized". Make sure GRIDIRON_API_KEY is set in the environment Windsurf starts from, and that the key is current on your dashboard (regenerating a key retires the old one).
• Blocked by your team. On Teams and Enterprise, an admin allowlist blocks servers that aren't on it. Ask the admin to add GridIron Data.
• "Not available on this account's current plan". That question needs Basic or Pro. The reply names the plan; see plans.

Frequently asked questions

Does Windsurf support remote MCP servers?

Yes. Windsurf (now Devin Desktop) and the Windsurf plugins support stdio, Streamable HTTP and SSE servers. Add GridIron Data with serverUrl https://api.gridirondata.com/mcp in mcp_config.json.

Is Windsurf now called Devin Desktop?

Windsurf's documentation now redirects to docs.devin.ai, where the editor is called Devin Desktop and the JetBrains integration is still Windsurf plugins. The MCP config file moved to ~/.config/devin/mcp_config.json.

Why an API key instead of sign-in?

It works the same everywhere, including Windsurf plugins. OAuth sign-in may also work; if Windsurf shows Needs authentication, click Authenticate.

Where do I get an API key?

Create a free GridIron Data account at https://www.gridirondata.com/pages/signup.html; the key is on your dashboard.

Is it free?

A free GridIron Data account answers player lookups and this week's projections. Stats, snaps, news and other weeks need Basic ($5/month or $45/year); prop probabilities, defense vs position and betting lines need Pro ($29/month or $249/year).

Using a different assistant?

• ChatGPT
• Claude (claude.ai and Desktop)
• Claude Code
• Gemini (Gemini CLI)
• GitHub Copilot (VS Code)
• Cursor
• OpenAI Codex
• Microsoft Copilot Studio
• Run it locally (stdio)

Every assistant connects to the same server, https://api.gridirondata.com/mcp. The AI assistant setup hub compares them.