Give your agent real odds, not a guess.

OddsLink runs an MCP server so an AI agent can call live odds tools directly, the same data the JSON API returns, without scraping a page or filling in a number from training data.

Get a free API key Read the docs

Connect

A hosted endpoint for most clients, or run the server yourself next to your own process.

Hosted, streamable HTTP

Point your client at this URL with your API key as a bearer token. Nothing to install or run.

https://api.oddslink.app/mcp

Local, stdio

Run the server as a subprocess. It reads your key from ODDSLINK_API_KEY in the environment.

python -m odds.mcp

Configure your client

The same shape each of these tools already reads for its other MCP servers, filled in for OddsLink.

Hosted (recommended)

claude_desktop_config.json

{
  "mcpServers": {
    "oddslink": {
      "type": "streamable-http",
      "url": "https://api.oddslink.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ODDSLINK_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "oddslink": {
      "type": "http",
      "url": "https://api.oddslink.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ODDSLINK_API_KEY"
      }
    }
  }
}

{
  "mcpServers": {
    "oddslink": {
      "url": "https://api.oddslink.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ODDSLINK_API_KEY"
      }
    }
  }
}

[mcp_servers.oddslink]
url = "https://api.oddslink.app/mcp"
bearer_token_env_var = "ODDSLINK_API_KEY"

{
  "servers": {
    "oddslink": {
      "type": "http",
      "url": "https://api.oddslink.app/mcp",
      "headers": {
        "Authorization": "Bearer YOUR_ODDSLINK_API_KEY"
      }
    }
  }
}

Local (stdio)

claude_desktop_config.json

{
  "mcpServers": {
    "oddslink": {
      "command": "python",
      "args": ["-m", "odds.mcp"],
      "env": { "ODDSLINK_API_KEY": "YOUR_ODDSLINK_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "oddslink": {
      "command": "python",
      "args": ["-m", "odds.mcp"],
      "env": { "ODDSLINK_API_KEY": "YOUR_ODDSLINK_API_KEY" }
    }
  }
}

{
  "mcpServers": {
    "oddslink": {
      "command": "python",
      "args": ["-m", "odds.mcp"],
      "env": { "ODDSLINK_API_KEY": "YOUR_ODDSLINK_API_KEY" }
    }
  }
}

[mcp_servers.oddslink]
command = "python"
args = ["-m", "odds.mcp"]
env = { "ODDSLINK_API_KEY" = "YOUR_ODDSLINK_API_KEY" }

{
  "servers": {
    "oddslink": {
      "command": "python",
      "args": ["-m", "odds.mcp"],
      "env": { "ODDSLINK_API_KEY": "YOUR_ODDSLINK_API_KEY" }
    }
  }
}

Seven tools, nothing else to learn

Every price is American odds; every timestamp is UTC.

list_sportsEvery sport key the API serves, with its display name.
list_bookmakersAll 46 bookmakers, with their key and kind (sportsbook, exchange or prediction market).
list_marketsThe market keys available (moneyline, spreads, totals, period markets, alternate lines, team totals).
list_events(sport, date?)Upcoming fixtures for a sport, optionally filtered to one date.
get_odds(sport, event_id?, markets?, bookmakers?)Current prices for one fixture or a whole sport, scoped to the markets and bookmakers you name.
get_props(sport, event_id)Player-prop prices for one fixture.
get_history(sport, event_id, kind)A price series, an opening line, or a closing line for one fixture, depending on kind.

Paste this into your agent's system prompt

A short brief that keeps the agent honest about where a price came from.

You have access to OddsLink's MCP tools for sports odds.
Only report odds you obtained from a successful tool call in this conversation.
Never fill in or guess odds from memory or training data.
Always state the bookmaker name and the last_update timestamp alongside any price you quote.
All prices are American odds. All timestamps are UTC.

Connect an agent in one request.

Free plan API key, no setup beyond the config above.

Get a free API key Read the docs