oddsrelay/oddsrelay-mcp

An MCP server that gives an AI assistant read access to OddsRelay: matched boards, the prices for one event, and
the sport, event, bookmaker and coverage lists behind them. It is read-only, and every call that spends tokens is
priced first and refused above a per-call cap (maxtokens). The assistant is told to ask you before raising it.
It works with Claude Desktop, Claude Code, Cursor and any other client that starts MCP servers over stdio, and it is
built on the oddsrelay TypeScript client.
API docs: https://oddsrelay.io/docs
## Get a key
Sign up at app.oddsrelay.io/signup and copy your key from the dashboard.
Free gives you 50,000 tokens for 14 days from sign-up, with no card, then no tokens until you choose a plan, on the same key. Plans and token prices.
Paid plans are for your own use. A product that serves other people runs on Enterprise.
## Set up
You need an OddsRelay API key (Get a key, above). The server reads the key from ODDSRELAYKEY. The bundle sets it for you; the other routes set it in your MCP client's config and need
Node 18 or later.
### Claude Desktop (one-click bundle)
Download oddsrelay-mcp.mcpb from the latest release
and double-click it to install it in Claude Desktop, which asks for one setting: your API key. The setting is marked
sensitive, so Claude Desktop masks it, and it passes the key to the server as ODDSRELAYKEY. The bundle carries
everything the server needs and runs on the Node built into Claude Desktop, so you need no Node of your own.
### Claude Code
sh
claude mcp add --transport stdio oddsrelay --env ODDSRELAYKEY=yourkeyhere -- npx -y oddsrelay-mcp
### Claude Desktop (config file)
Settings, Developer, Edit Config opens claudedesktopconfig.json. Add the server, then restart Claude Desktop:
json
"mcpServers": {
"oddsrelay": {
"command": "npx",
"args": ["-y", "oddsrelay-mcp"],
"env": { "ODDSRELAYKEY": "yourkeyhere" }
### Cursor
Add the same mcpServers block to ~/.cursor/mcp.json (every project) or .cursor/mcp.json (one project).
The key sits in that config file as plain text, so keep the file out of anything you commit.
## First questions
Ask your assistant:
> Using OddsRelay, which bookmakers carry tennis on the standard board?
That calls coverage, which costs no tokens. Then:
> Show the OddsRelay standard board for soccer at Ladbrokes and William Hill, first five events.
The assistant finds the bookmaker keys with bookmakers, then calls odds, which is priced before it runs.
## Agent Skill
skills/oddsrelay/SKILL.md is an Agent Skill for assistants that load skills (Claude
Code, Claude.ai and other skill-aware clients): when to reach for OddsRelay, how to quote a call before it spends
tokens, and how to read the boards. It works with this server or with plain HTTPS.
## Tools
| Tool | What it reads | Tokens |
| sports | Sport and competition keys, paged | none |
| events | The events of one sport, with their ids, paged | none |
| bookmakers | Bookmaker and exchange keys | none |
| coverage | Which bookmakers carry which sports on one product, and the product's market keys | none |
| odds | A matched board (standard, 2up, dutching, each-way, extra-place or bog) for one sport at the bookmakers you name | priced first, capped |