SockOdds MCP server

sockodds-mcp

Ask Claude "what are the odds on X right now" and get Australian bookmakers' prices, the best price and the no-vig fair price, from the SockOdds sports odds API (v1). The free key covers 3 bookmakers and 6 leagues; paid plans add more (pricing).

Version 1.0 speaks SockOdds API v1. Versions 0.x called the older v2 API, which SockOdds is retiring: once it is switched off, 0.x stops working. Update to 1.0: restart your MCP client so npx -y sockodds-mcp fetches it, and if the server still starts as 0.x, point it at sockodds-mcp@latest once. Your key carries over. See Upgrading from 0.x.

A free, open-source MCP server plus a Claude Code skill, built for the "$1M in 365 Days" series. MIT licence.

30-second demo

This transcript uses demo mode (SOCKODDS_DEMO=1), so the prices are invented samples, not real odds.

You: What are the odds on Lions v Crows?

Claude calls findevent with { "query": "Lions v Crows", "leagueid": "afl" }:

text

1. Brisbane Lions v Adelaide Crows (AFL)

Starts: Sat, 12 Sept 2026, 7:35 pm AEST (09:35 UTC)

Event ID: ev_kqe6aepys23z

You: Is 1.95 on the Lions a fair price?

Claude calls fairodds with { "eventid": "ev_kqe6aepys23z", "market": "h2h" }:

text

No-vig fair odds: Head to head, from 3 bookmakers

Brisbane Lions: fair 2.03 (49.3% chance)

Adelaide Crows: fair 1.97 (50.7% chance)

Per bookmaker (margin, then its own no-vig prices):

Sportsbet: margin 5.3%, 2.03 / 1.97, seen 11 Sept 06:00:12 UTC

TAB: margin 5.0%, 2.01 / 1.99, seen 11 Sept 06:01:40 UTC

Unibet: margin 5.3%, 2.05 / 1.95, seen 11 Sept 05:59:03 UTC

Claude: The best Lions price is 1.95 at Unibet (read 05:59 UTC). With the bookmakers' margins taken out, the Lions come out at about 2.03, so 1.95 is a little shorter than the fair price. Odds change, so check the price at the bookmaker. 18+. Nothing here is a tip. Gamble responsibly: Gambling Help Online 1800 858 858.

Tools

How fair_odds works

For each bookmaker that prices every outcome at the same line, each price becomes an implied chance (1 / price). Those chances add up to more than 100%; the extra is the bookmaker's margin. Dividing each chance by the total removes the margin (the proportional method). The tool then averages each bookmaker's margin-free chances and turns them back into prices (1 / chance). It also shows each bookmaker's margin and the combined margin of the best prices.

The free plan's books are retail bookmakers, so this is an estimate of the chance, not a prediction. SockOdds API v1 publishes each bookmaker's price exactly as shown, margin included, so the fair price is always worked out here from those prices.

No line movement tool

SockOdds API v1 has recorded price history (/v1/odds/history), but history is on the Pro plan and other plans get HTTP 403. The free key cannot read it, so this server does not include a line movement tool.

Get a free SockOdds key

Shortened. The full README is on GitHub.