How to Use the The Odds API MCP in Windsurf

Q: How do I check live data using The Odds API with windsurf?

Simply call getscores and provide the sport ID. Windsurf's agent will process the result, giving you structured access to both completed scores and real-time updates.

Q: Can I use The Odds API to compare different sport markets in windsurf?

Absolutely. Use listsports first to get a full list, then iterate through the IDs calling getodds for comparative analysis across multiple sports.

Calculate predictive models directly in your code with windsurf and The Odds API.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers — Included with Plan

Connect The Odds API MCP to Windsurf

Create your Vinkius account to connect The Odds API to Windsurf — we handle the hosting, security, and runtime updates so you don't have to. No server setup required.

GDPR Included with Plan

Setup The Odds API with Windsurf

Ask AI about this MCP

ChatGPT

Claude

Perplexity Vinkius runs on Gemini

Gemini

Grok

Get real-time odds for any sport.

Call `get_odds` to fetch current betting lines for specific sports. This tool takes a sport ID and returns structured data containing the market's predicted probabilities. You can immediately plug this into your model, letting Cascade handle the complex parsing so you don't have to write boilerplate code.

List available sports via MCP Server.

Use `list_sports` whenever you need to know what data is available. It returns a list of all supported sports categories, saving you the headache of manually tracking endpoints. This discovery function makes it simple for your agent to figure out which markets are active before running any other analysis.

Fetch live and past scoring data.

`get_scores` pulls historical match results or real-time updates. You pass in a sport ID, and the server sends back scores for both completed games and those currently in progress. This lets your agent build context around recent performance trends to feed into more accurate predictive models.

Setup guide

Set up The Odds API 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 The Odds API 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 The Odds API payment history." If connected, Cascade will call the The Odds API tools directly. You will see a green dot next to the server name in the MCP panel.

mcp_config.json

{
  "mcpServers": {
    "the-odds-api-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 The Odds API. 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 The Odds API 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 The Odds API MCP in Windsurf

Simply call `get_scores` and provide the sport ID. Windsurf's agent will process the result, giving you structured access to both completed scores and real-time updates.

Yes, the MCP Server design allows your AI client to connect to this server alongside other external services. You can chain calls to build a complete picture of the market.

The server handles publicly available sports betting odds and scores. It only touches non-personal, aggregated statistical data types. You don't need to worry about user identifiers.

Absolutely. Use `list_sports` first to get a full list, then iterate through the IDs calling `get_odds` for comparative analysis across multiple sports.

Since it's an MCP Server, you get direct access to the toolset. Latency is minimal because your AI client invokes the function directly rather than relying on slow HTTP polling.

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