How do I install Odds Api?

Odds Api is a local plugin. Install it using npm package: odds-api-mcp-server and add the generated configuration snippet to your AI app's MCP config file. Then restart your AI app.

Is Odds Api safe to use?

Yes. Odds Api passed MCP Marketplace's automated security scan with a score of 7.2/10 (low risk). Every server on MCP Marketplace is security-scanned before it's listed; see the full security report on this page for the findings and permissions.

What credentials does Odds Api need?

Odds Api requires the following credentials or environment variables: ODDS_API_KEY. You can find setup instructions on the server detail page.

What AI apps work with Odds Api?

Odds Api uses the Model Context Protocol (MCP) and works with any MCP-compatible AI app, including Claude, ChatGPT / Codex, Gemini, Copilot, Cursor, and more.

Back to Browse

Odds Api MCP Server

by Odds Api Io

Developer ToolsModerate7.2MCP RegistryLocal

Free

Server data from the Official MCP Registry

Live sports betting odds from 265+ bookmakers across 34 sports, with value bets and arbitrage.

About

Live sports betting odds from 265+ bookmakers across 34 sports, with value bets and arbitrage.

Security Report

7.2

Moderate7.2Low Risk

This is a well-structured MCP server for the Odds-API.io sports betting API. The code is clean, properly authenticated via environment variables, and permissions align well with its stated purpose. All 22 tools are properly documented and tested. Minor code quality observations exist but do not indicate security vulnerabilities. Supply chain analysis found 1 known vulnerability in dependencies (0 critical, 1 high severity). Package verification found 1 issue.

4 files analyzed · 5 issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Required

This plugin requests these system permissions. Most are normal for its category.

env_vars

Check that this permission is expected for this type of plugin.

HTTP Network Access

Connects to external APIs or services over the internet.

What You'll Need

Set these up before or after installing:

Odds-API.io API key (free tier available, no credit card)Required

Environment variable: ODDS_API_KEY

How to Install

Add this to your MCP configuration file:

{
  "mcpServers": {
    "io-github-odds-api-io-odds-api-mcp-server": {
      "env": {
        "ODDS_API_KEY": "your-odds-api-key-here"
      },
      "args": [
        "-y",
        "odds-api-mcp-server"
      ],
      "command": "npx"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Odds-API.io MCP Server

Model Context Protocol (MCP) server for Odds-API.io - providing AI tools like Claude, Cursor, and VS Code with direct access to sports betting odds data.

Full AI-tooling docs: docs.odds-api.io/ai-vibe-coding

Features

22 API tools covering the full Odds-API.io v3 surface: sports, events, odds, historical data, value bets, arbitrage, dropping odds, and more
Documentation resources for AI context
Real-time data from 265+ bookmakers across 34 sports

Quick Start

One-Click Install (Claude Desktop)

Download the latest .mcpb file from Releases and open it. Claude Desktop will prompt you for your API key.

Claude Code CLI

claude mcp add odds-api --env ODDS_API_KEY="your-api-key" -- npx -y odds-api-mcp-server

Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

Cursor

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

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

VS Code

Add to your VS Code settings (.vscode/mcp.json):

{
  "servers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "odds-api-mcp-server"],
      "env": {
        "ODDS_API_KEY": "your-api-key"
      }
    }
  }
}

Global Install (alternative)

npm install -g odds-api-mcp-server

Then use odds-api-mcp as the command instead of npx -y odds-api-mcp-server.

Configuration

Variable	Required	Description
`ODDS_API_KEY`	Yes	Your API key from odds-api.io

Available Tools

Sports & Leagues

Tool	Description
`get_sports`	List all available sports with slugs
`get_leagues`	Get leagues for a sport (with optional `all` flag for inactive leagues)

Bookmakers

Tool	Description
`get_bookmakers`	List all supported bookmakers
`get_selected_bookmakers`	Get your currently selected bookmakers
`select_bookmakers`	Add bookmakers to your selection
`clear_selected_bookmakers`	Clear all selected bookmakers (once per 12h)

Events

Tool	Description
`get_events`	Get events with filtering (league, status, date range, participant, bookmaker, pagination)
`get_event`	Get a single event by ID
`get_live_events`	Get currently live events
`search_events`	Search events by team name or text

Odds

Tool	Description
`get_odds`	Get odds for an event from selected bookmakers
`get_multi_odds`	Get odds for up to 10 events in one call
`get_odds_movements`	Get historical line movements for a market
`get_updated_odds`	Get recently changed odds (polling)

Historical

Tool	Description
`get_historical_events`	Get finished events for a sport/league/date range
`get_historical_odds`	Get closing odds and scores for finished events

Betting Analytics

Tool	Description
`get_value_bets`	Get positive EV opportunities for a bookmaker
`get_arbitrage_bets`	Get arbitrage opportunities with optimal stakes
`get_dropping_odds`	Track sharp bookmaker line movements by sport, league, market, and time window

Participants

Tool	Description
`get_participants`	Get teams/participants for a sport
`get_participant`	Get a single participant by ID

Reference

Tool	Description
`get_documentation`	Fetch full API documentation

Resources

Resource URI	Description
`odds-api://documentation`	Complete API documentation
`odds-api://openapi`	OpenAPI/Swagger specification

Example Usage

Once configured, ask your AI assistant things like:

"What sports are available on Odds-API?"
"Show me upcoming Premier League matches"
"Get odds for the next Arsenal match from Bet365 and SingBet"
"Find value bets on Bet365 with event details"
"Are there any arbitrage opportunities between Bet365 and Unibet?"
"Show me how the odds moved for event 12345 on the spread market"
"Get historical results for La Liga in January 2026"
"Show me the biggest dropping odds in football right now"
"What Premier League odds have dropped the most in the last 12 hours?"

Development

git clone https://github.com/odds-api-io/odds-api-mcp-server
cd odds-api-mcp-server
npm install
npm run build
npm test

License

MIT

Reviews

No reviews yet

Be the first to review this server!

More Developer Tools MCP Servers

Git

Free

by Modelcontextprotocol · Developer Tools

Read, search, and manipulate Git repositories programmatically

Fetch

Free

by Modelcontextprotocol · Developer Tools

Web content fetching and conversion for efficient LLM usage

Toleno

Free

by Toleno · Developer Tools

Toleno Network MCP Server — Manage your Toleno mining account with Claude AI using natural language.

mcp-creator-python

Free

by mcp-marketplace · Developer Tools

Create, build, and publish Python MCP servers to PyPI — conversationally.

MCP Marketplace

Free

by mcp-marketplace · Developer Tools

Search and install MCP servers from inside your AI client.

MarkItDown

Free

by Microsoft · Content & Media

Convert files (PDF, Word, Excel, images, audio) to Markdown for LLM consumption

Odds Api MCP Server

About

Security Report

Findings (5)Action required

Permissions Required

What You'll Need

How to Install

Documentation

Odds-API.io MCP Server

Features

Quick Start

One-Click Install (Claude Desktop)

Claude Code CLI

Claude Desktop

Cursor

VS Code

Global Install (alternative)

Configuration

Available Tools

Sports & Leagues

Bookmakers

Events

Odds

Historical

Betting Analytics

Participants

Reference

Resources

Example Usage

Development

License

Links

Reviews

No reviews yet

More Developer Tools MCP Servers

Git

Fetch

Toleno

mcp-creator-python

MCP Marketplace

MarkItDown