@openoddsapi/mcp-server
v0.2.0
Published
MCP server for OpenOddsAPI — live sports odds across bookmakers and prediction markets, as callable tools for Claude, Cursor and other MCP clients.
Maintainers
Readme
@openoddsapi/mcp-server
Live sports odds as callable tools for Claude, Cursor, VS Code and any other MCP client. No SDK, no client code — the agent discovers the endpoints itself.
Covers UFC, boxing, tennis, NFL and golf across bookmakers and prediction markets (Kalshi, Polymarket, SX Bet), with per-bookmaker freshness.
Install
Get a key at openoddsapi.com — the free plan includes the MCP server.
Claude Code
claude mcp add openoddsapi -e OPENODDSAPI_KEY=$OPENODDSAPI_KEY -- npx -y @openoddsapi/mcp-serverCursor / Claude Desktop / VS Code — add to your MCP config:
{
"mcpServers": {
"openoddsapi": {
"command": "npx",
"args": ["-y", "@openoddsapi/mcp-server"],
"env": { "OPENODDSAPI_KEY": "oo_live_..." }
}
}
}Tools
| Tool | What it does |
|---|---|
| list_sports | Sports covered, with live book and event counts |
| get_odds | Every book's price for a sport, matched across sources |
| compare_books | Best price per outcome, plus fair no-vig probabilities |
| find_arbitrage | Guaranteed-profit opportunities, after fees, with stake ceilings |
| get_events | Schedule without prices |
| get_scores | Live and final results |
| get_status | Plan, quota and remaining requests |
Try it
What are the current moneyline odds for the next UFC card, and which book has the best price on each fighter?
Are there any arbitrage opportunities in tennis right now? Only show ones that survive fees with at least $500 of headroom.
Which bookmakers are stale right now, and how far behind are they?
Notes that matter
- Prices are pre-fee. Each source carries a fee model;
find_arbitrageapplies it and reportsmargin_after_fees. - Freshness is explicit. Every source has
last_updateand astaleflag. A stale price shown as live is the worst failure mode in this category. - Arbitrage has a ceiling.
max_stakecomes from the binding leg's limit or depth. A 2% edge capped at $40 is not a trade.
Environment
| Variable | Required | Default |
|---|---|---|
| OPENODDSAPI_KEY | yes | — |
| OPENODDSAPI_BASE_URL | no | https://api.openoddsapi.com/v1 |
MIT · Docs
