igaming-odds-mcp
This MCP server provides deterministic betting-odds and settlement tools with strict input validation and integer-cent money math.
Convert odds among decimal, fractional, American, and implied probability.
Compute bookmaker overround/margin and fair odds/probabilities for a market.
Combine multiple legs into parlay/accumulator odds.
Settle single bets, returning return and profit in integer cents with floor rounding.
Settle multi-leg accumulators, including lose-all and void-to-1 behavior.
Settle each-way bets as separate win and place parts.
Calculate Kelly-criterion stakes, including fractional Kelly, and recommend no stake for negative edge.
Use strict schemas to return readable errors for invalid odds/probabilities.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@igaming-odds-mcp What's the margin on a 1.90 / 1.90 market?"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
igaming-odds-mcp
An MCP server with a set of exact, deterministic betting-odds tools: format conversions, bookmaker margin, parlay pricing, bet settlement, and Kelly staking. All the money math is integer-cents and floor-rounded, the same discipline a real settlement ledger uses.
It pairs with a companion project, bet-settlement-service, which settles bets on a double-entry ledger.
Tools it exposes
convert_odds converts a price between decimal, fractional, American and implied probability. bookmaker_margin works out the overround of a market and the fair odds once the margin is stripped out. parlay_odds combines several legs into one accumulator price. settle_single returns the return and profit in integer cents for a single bet. settle_accumulator settles a multi-leg accumulator, where any losing leg loses the whole bet and void legs drop to 1. settle_each_way settles an each-way bet, win and place parts separately. kelly_stake works out a Kelly-criterion stake for a given edge; a negative edge just recommends no stake at all.
Every input goes through a strict Zod schema, so bad odds (a decimal at or below 1, a probability outside 0 to 1, American at 0) come back as a readable tool error instead of a crash.
Related MCP server: Betting Method MCP Server
Install
pnpm install
pnpm build
pnpm test # 22 tests: pure math + a real MCP handshake over stdioConnecting a client
Any MCP client that reads an mcpServers config can start it over stdio:
{
"mcpServers": {
"igaming-odds": {
"command": "node",
"args": ["/absolute/path/to/igaming-odds-mcp/dist/index.js"]
}
}
}From there the client can call convert_odds on 3/2, bookmaker_margin on a 1.90 / 1.90 market, or kelly_stake for decimal 2.0 at a true 60% with a $1000 bankroll.
Example
Calling bookmaker_margin with decimalOdds [1.9, 1.9] returns:
{
"overround": 1.052632,
"marginPct": 5.2632,
"fairDecimalOdds": [2, 2],
"fairProbabilities": [0.5, 0.5]
}A couple of implementation notes
All the logic is pure functions in src/odds.ts; the tool layer only validates input and formats output. Money stays as integer cents and rounding always favors the house, which is asserted in the tests, matching the rule a real settlement engine would follow. Odds convert to exact fractions through a bounded continued-fraction approximation, so something like 1.3333 round-trips to 1/3 instead of some ugly exact decimal.
Available Tools
7 toolsbookmaker_marginA
Compute the overround/margin of a market and the fair odds with it removed.
Inputs: decimalOdds (required).
convert_oddsB
Convert a price between decimal, fractional, American and implied probability.
Inputs: odds (required), format (required).
kelly_stakeB
Kelly-criterion stake for an edge; negative edge recommends no stake.
Inputs: decimalOdds (required), probability (required), bankrollCents (required), fraction.
parlay_oddsA
Combine several legs into one accumulator price.
Inputs: legs (required).
settle_accumulatorA
Settle a multi-leg accumulator; any losing leg loses the bet, void legs drop to 1.
Inputs: legs (required), stakeCents (required).
settle_each_wayA
Settle an each-way bet (win + place parts); total staked is 2x stakeCents.
Inputs: result (required), stakeCents (required), decimalOdds (required), placeFraction (required).
settle_singleA
Return and profit in integer cents for a single bet (floor rounding).
Inputs: result (required), stakeCents (required), decimalOdds (required).
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 7 tools
Each tool targets a distinct betting/odds concept: conversion, margin, parlay construction, three settlement types, and stake sizing. The settle_* tools are clearly separated by bet structure, and the others are unambiguously different operations.
Most tools follow a verb_noun pattern (convert_odds, settle_single, parlay_odds), but bookmaker_margin and kelly_stake are noun phrases, breaking the uniformity. The naming is readable and lowercase with underscores, but the pattern is not fully consistent.
Seven tools is well-scoped for an igaming/odds toolkit, covering core operations without redundancy. Each tool serves a clear purpose and the count is comfortably within the ideal range.
The toolset covers the full lifecycle of odds manipulation and bet settlement: conversion, margin calculation, parlay building, single/accumulator/each-way settlement, and stake recommendation. No critical gaps are apparent for the stated domain.
Maintenance
Related MCP Connectors
Hosted MCP for live Pinnacle odds, drops, fair prices and closing lines.
The Odds API MCP — sportsbook odds across 70+ books, 30+ leagues
Sportsbook-derived no-vig fair value with confidence, provenance, and history over REST/MCP.
MCP server for accessing Glypse's prediction market analytics and research.
Related MCP Servers
- AlicenseBqualityDmaintenanceMCP-compatible server that gives AI agents access to alternative sports data across 30+ leagues — odds, events, probabilities, settlement, and futures for prediction markets, DFS platforms, and sportsbooks.2918 PyPIMIT
- AlicenseAqualityDmaintenanceAn MCP server that provides calculations for 11 betting methods including Martingale, Fibonacci, and Kelly Criterion. Enables users to initialize sessions, record wins/losses, and get next bet amounts through natural language.5514 npmMIT
- AlicenseAqualityBmaintenanceAn MCP server providing real-time market data, technical analysis, prediction market odds, and strategy backtesting for crypto, equities, and prediction markets.20MIT

RapidOddsAPI MCPofficial
AlicenseAqualityCmaintenanceLive bookmaker odds from 100+ sportsbooks (AU, US, EU), arbitrage and value bet finders, live game results and player stats for AI assistants. Built on the official RapidOddsAPI Python SDK. Free tier available.5MIT