Summary
Pre-match odds from UK and Irish bookmakers with exchange lay prices. Look up sports, events and bookmakers, then read one matched board or one event's prices.
Guided setup
Connect OddsRelay to Gemini in 2 minutes
Start a free trial on AnythingMCP Cloud, connect OddsRelay in the guided setup, then add your MCP URL to Gemini. No code and no server to run.
No credit card · 7-day trial · Self-host alternative available
Try asking
Example prompts for OddsRelay
Click any prompt to copy it. Paste into Claude, ChatGPT, Cursor, Gemini, Copilot or OpenClaw to run it against this connector.
Claude is AI and can make mistakes. Please double-check responses.
💡 No install? Use cloud.anythingmcp.com directly. Sign in, click Connectors → OddsRelay, paste your credentials, mint an MCP API key — done. No Docker, no
git clone, no local server.
OddsRelay + Gemini
Pre-match odds from UK and Irish bookmakers with exchange lay prices. Look up sports, events and bookmakers, then read one matched board or one event's prices.
Prerequisites
See the full setup instructions baked into the connector (visible in the in-app store when you select the connector). The required environment variables for this connector are:
ODDSRELAY_KEY
Step 1 — Get credentials
Setting up takes about 2 minutes. You need an OddsRelay account and an API key from it. For one event's odds, the key must be able to read raw odds.
- Sign in to your account at https://oddsrelay.io and create an API key.
- Paste it into
ODDSRELAY_KEY. It is sent as a Bearer token on every call and is never a tool argument. - Install the connector and run
oddsrelay_get_usage: it shows the key's token balance, when it resets and which boards the key can read. It costs no tokens.
What it reads: pre-match odds from UK and Irish bookmakers with exchange lay prices. A matched board (standard, 2up, dutching, each-way, extra-place or bog) puts bookmaker back prices beside exchange lay prices for one sport at up to five bookmakers. Event odds give one event's prices at every bookmaker and exchange carrying it, market by market. The free tools list competition keys (a sport such as soccer alone covers all its competitions), events with their ids and start times, bookmaker and exchange keys (such as william_hill or betfair_exchange) and which bookmakers have prices on each board now. Every tool only reads.
Asks before it spends tokens: oddsrelay_get_board and oddsrelay_get_event_odds spend tokens from the account behind the key, and the connector has no cap of its own. Before either one, the AI runs oddsrelay_quote_board or oddsrelay_quote_event_odds with the same arguments, tells you the cost and the tokens remaining, and goes ahead only when you agree. All other tools cost nothing. Narrow calls cost less: one competition key rather than a whole sport, only the bookmakers you need, a markets filter (such as h2h) and a start-time window.
Paging and times: sports and events come in pages. The AI passes meta.next_cursor back until it is null, and starts again from the first page when a cursor expires after a few minutes. Times are ISO 8601 in UTC, such as 2026-10-10T12:00:00Z.
Common errors: 401 means the key is missing or wrong. 402 insufficient_tokens means the balance cannot cover the call; oddsrelay_get_usage shows the balance and when it resets. 400 with a valid list means an unknown sport, bookmaker, exchange or market. 403 means the request reaches past what the key may read. 404 unknown_event means the event is no longer listed. 429 means too many calls at once: wait for the Retry-After time, then try once more. 503 means the API is not available right now.
Step 2 — Install the adapter
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
Step 3 — Add the connector in Gemini
Your server URL: in AnythingMCP, open MCP Servers → the server this connector is on, and copy its URL (
https://cloud.anythingmcp.com/mcp/…). Use it wherever this guide showsYOUR_SERVER_ID.
Gemini CLI reads MCP servers from ~/.gemini/settings.json (on Windows %USERPROFILE%\.gemini\settings.json). Add:
{
"mcpServers": {
"anythingmcp": {
"httpUrl": "https://cloud.anythingmcp.com/mcp/YOUR_SERVER_ID",
"headers": { "X-API-Key": "YOUR_MCP_API_KEY" }
}
}
}
- Create an MCP API key in AnythingMCP under MCP Servers → your server → API keys, and paste it in place of
YOUR_MCP_API_KEY. - Save the file and restart
gemini. - Run
/mcpinside Gemini CLI (orgemini mcp listin your shell) —anythingmcpshould show as connected. - Start prompting — Gemini CLI can now call the
OddsRelaytools.
Available tools
| Tool | What it does |
|---|---|
oddsrelay_list_sports | Lists the competition keys for the sport argument of the board and event tools |
oddsrelay_list_events | Lists the events of one sport with their event ids, teams and start times, for oddsrelay_get_event_odds |
oddsrelay_list_bookmakers | Lists the bookmaker and exchange keys (such as william_hill or betfair_exchange) that the board tools take |
oddsrelay_get_coverage | Shows, for each matched board the key can read, which bookmakers and exchanges have prices now and for which sports |
oddsrelay_quote_board | Returns what a matched board request would cost in tokens, and the tokens remaining, without reading the board |
oddsrelay_get_board | Reads one matched board: bookmaker back prices beside exchange lay prices, for one sport at the bookmakers you name |
oddsrelay_quote_event_odds | Returns what one event's odds would cost in tokens, and the tokens remaining, without reading them |
oddsrelay_get_event_odds | Reads one event's prices at every bookmaker and exchange carrying it, market by market |
oddsrelay_get_usage | Shows the key's token balance and when it resets, and which boards the key can read |
FAQ
Where does Gemini CLI look for MCP servers? In ~/.gemini/settings.json for your user, or in .gemini/settings.json inside a project. gemini mcp list shows each server and whether it connects.
Next steps
Was this guide helpful?