@pipeworx/odds-api
Connect: https://gateway.pipeworx.io/odds-api/mcp · Install: one-click buttons
Tools: 6
The Odds API MCP — sportsbook odds across 70+ books for 30+ sports leagues (NFL, NBA, MLB, NHL, soccer, MMA, golf, tennis, esports, cricket, …).
Tools
list_sports(all?)— list available sports/leaguesget_odds(sport_key, regions?, markets?, odds_format?, date_format?, bookmakers?, events?)— current oddsget_event_odds(sport_key, event_id, regions?, markets?)— odds for a specific event (allows more markets like player props)get_scores(sport_key, days_from?)— live + recent final scoresget_events(sport_key, date_format?, event_ids?)— list upcoming + live eventsodds_api_quota()— credits left and used this month on the key serving the call (free; costs no upstream credit)
Auth
- Platform key: gateway env
PLATFORM_ODDS_API_KEY - BYO:
?_apiKey=<key>after registering at https://the-odds-api.com/
Free tier: 500 requests/month. Each odds-payload market counts as 1 request. list_sports,
get_events and odds_api_quota are free — measured 2026-09-01, they do not draw down the
balance.
When the month’s credits are spent, the metered tools (get_odds, get_event_odds, get_scores)
return upstream_throttled and a hint to bring your own key. Upstream answers an exhausted balance
with HTTP 401, the same status as a bad key, so read the message rather than the status:
odds_api_quota tells the two apart. Credits reset on the plan anniversary, not on the 1st of the
month, and nothing announces the reset.
odds_api_quota also adds error: "account_limited" and a plain-English message once the
balance hits zero. That is what makes a spent plan visible: the monitor’s platform-key board probes
this pack through odds_api_quota precisely because it is free to call and able to fail. The
board previously probed get_events, which keeps answering 200 on a zero balance — so the four
metered tools were dark for eleven days in August 2026 with nothing reporting it. The wording of
that message is a contract with workers/monitor; tests/odds-api-quota-visibility.test.ts
holds the two together.
Data source
https://api.the-odds-api.com/v4/ — ?apiKey= query.
Tools
- list_sports — List available sports/leagues. By default returns only in-season; pass all=true to include out-of-season.
- get_odds — Current odds for upcoming + live events in a league. Each market type costs 1 quota credit per region per call — pick markets carefully.
- get_event_odds — Odds for a single event — allows richer markets (player props, alt lines). Higher quota cost per call.
- get_scores — Live + recent final scores. Costs 2 requests per call.
- get_events — Upcoming + live events for a league (without odds — useful to discover event IDs).
- odds_api_quota — Monthly request credits left and used on the key serving this call, read from The Odds API usage headers. Says whether the odds and scores tools can return data right now and how large the plan is.
Tools
-
get_event_odds— Odds for a single event — allows richer markets (player props, alt lines). Higher quota cost per call. -
get_events— Upcoming + live events for a league (without odds — useful to discover event IDs). -
get_odds— Current odds for upcoming + live events in a league. Each market type costs 1 quota credit per region per call — pick markets carefully. -
get_scores— Live + recent final scores. Costs 2 requests per call. -
list_sports— List available sports/leagues. By default returns only in-season; pass all=true to include out-of-season. -
odds_api_quota— Monthly request credits left and used on the key serving this call, read from The Odds API usage headers. Says whether the odds and scores tools can return data right now and how large the plan is.