# The Odds API — MCP server on mcp.ai
> Connect your The Odds API account and use 8 tools for gaming straight from your AI agent. Connect with your own API key. The Odds API provides real-time sports betting odds data from various bookmakers worldwide, covering multiple sports and betting markets.

By: mcp.ai · official
Page: https://mcp.ai/the_odds_api

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_the_odds_api?ms=1787293560000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/the_odds_api/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/the_odds_api/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/the_odds_api/skill.md
Postman collection (v2.1): https://mcp.ai/the_odds_api/postman.json

## Tools
- the_odds_api_get_event_markets(sport: string, eventId: string, regions: string, bookmakers?: string, dateFormat?: string) — Tool to retrieve available market keys for each bookmaker for a specific event. Returns only recently seen markets - not a comprehensive list. More markets become available as the event's commence tim
- the_odds_api_get_event_odds(sport: string, eventId: string, markets?: string, regions?: string, bookmakers?: string, dateFormat?: string, oddsFormat?: string) — Tool to retrieve odds for a specific event. Use after confirming sport key via THE_ODDS_API_GET_SPORTS and event ID via THE_ODDS_API_GET_EVENTS; mismatched values return empty payloads rather than err
- the_odds_api_get_events(sport: string, markets?: string[], regions?: string[], bookmakers?: string[], dateFormat?: string, oddsFormat?: string) — Tool to fetch live and upcoming events for a specified sport. Use when you need event listings including odds. All timestamps are UTC. Avoid high-frequency polling; batch requests and implement backof
- the_odds_api_get_odds(sport: string, markets?: string[], regions: string[], eventIds?: string[], bookmakers?: string[], dateFormat?: string, oddsFormat?: string) — Tool to fetch live and upcoming event odds for a specified sport, including bookmakers, regions, and markets. Use after retrieving sports via GET_SPORTS; filter by region, market, or event IDs. Respon
- the_odds_api_get_participants(sport: string) — Tool to fetch list of participants (teams or players) for a specified sport. Use after confirming you have a valid sport key.
- the_odds_api_get_scores(sport: string, daysFrom?: integer, dateFormat?: string) — Tool to return live and recently completed event scores for a sport. Use after selecting a sport key to inspect current and recent game scores. Missing results may indicate unsupported competitions, n
- the_odds_api_get_sports(all?: boolean) — Tool to retrieve a list of in-season sports. Use when you need sports data; set 'all' to true to include out-of-season sports. Sport keys returned here must be passed to downstream tools like THE_ODDS
- the_odds_api_get_v3_odds(mkt?: string, sport: string, region: string, dateFormat?: string, oddsFormat?: string) — Tool to fetch odds using the legacy V3 API endpoint. Returns upcoming and live games with odds for a given sport, region, and market. Use for legacy integrations; V4 API is recommended for new impleme

## Example prompts
- "What can I do in The Odds API?"
- "Show me a summary of my The Odds API account"

## Links
Docs: https://mcp.ai/docs/mcps/the_odds_api
Website: https://mcp.ai/mcps/the_odds_api