How to Use the Football-Data.org MCP in Windsurf

Q: Can Windsurf query live scores using Football-Data.org?

Yes. Windsurf uses the listmatches tool to fetch live scores across leagues. Cascade can automatically schedule these checks or update your UI components in real time.

Get live league tables and match updates directly inside Windsurf without writing a single API fetch.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Football-Data.org MCP to Windsurf

Create your Vinkius account to connect Football-Data.org to Windsurf and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Football-Data.org with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Build live league tables in Windsurf

Let Windsurf use Cascade to build your sports dashboards. When you ask Windsurf to show current league standings, it calls `get_competition_standings` to grab the real-time table, then automatically parses the data to render a clean UI. Windsurf chains these tools in the background. It will use `list_competitions` to find the correct league ID, then immediately grab the standings without asking you for permission.

Deep squad performance analysis with Cascade

Windsurf doesn't just fetch raw JSON; it analyzes team forms. By coupling `get_team` with `list_team_matches`, Windsurf builds a historical performance profile of any club you query. If you need player-specific stats, Windsurf triggers `get_player` and `list_player_matches` in a single execution chain. This turns a complex multi-step data gathering chore into a simple, single-prompt request inside your IDE.

Automate matchday updates via this MCP Server

Keep your app updated during live matchdays. Windsurf uses `list_matches` and `get_match` to track active fixtures across global leagues. You can also pull the top goalscorers using `list_competition_scorers` to keep your Windsurf fantasy football components accurate. The entire loop runs locally through the secure Vinkius MCP gateway.

Setup guide

Set up Football-Data.org MCP in Windsurf

Prerequisites

Windsurf IDE installed (macOS, Windows, or Linux)
Active Vinkius subscription with a valid endpoint token

1

Open MCP configuration

Click the Cascade assistant icon in the sidebar, then click the hammer icon (🔨) at the top of the panel. Select "Configure" to open ~/.codeium/windsurf/mcp_config.json.
2

Add the Football-Data.org MCP

Paste the JSON snippet shown on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Refresh MCPs

Go back to the hammer icon (🔨) in Cascade and click "Refresh". Windsurf will detect the new server. No full restart is needed — the connection is hot-reloaded.
4

Verify in Cascade

Start a new Cascade conversation and ask something like "Show my Football-Data.org payment history." If connected, Cascade will call the Football-Data.org tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "football-dataorg-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Football-Data.org. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Football-Data.org now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Football-Data.org MCP in Windsurf

Open your Windsurf settings and add the server to your config file under the mcpServers key. Windsurf will instantly discover all 14 MCP tools.

Yes. Windsurf uses the `list_matches` tool to fetch live scores across leagues. Cascade can automatically schedule these checks or update your UI components in real time.

Yes, you can ask Windsurf to fetch details for any player. It will use `get_player` and `list_player_matches` to build a complete profile of their recent performances.

You can query all major global leagues supported by the API. Use `list_competitions` to see what is available, then drill down into specific fixtures or standings.

Vinkius runs the server in a secure, isolated sandbox. Your API token is stored securely and never exposed to the LLM, keeping your football match, league, standings, and player data queries private.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript