Australian Racing and Sports Odds MCP Server

A Model Context Protocol server for Australian horse racing, greyhound, harness and sports odds. Point Claude Desktop, Claude Code, Cursor, Windsurf or any MCP client at a live Australian odds feed and ask it what is racing next, what every bookmaker is paying, which runners are firming, and who won.

Racing data MCP · sports odds MCP server · horse racing MCP server · Australian odds for Claude · sports data for Cursor.

You: What's the next race at Randwick and who's favourite?

→ racing_next_to_go(num_races=3, country="AU")
← Wiesners Maiden Plate R1 — 11 runners, 8 bookmakers, data 38s old
  Favourite: <runner> at $2.40 (sportsbet) / $2.55 (tab) / $2.35 (neds)

15 Australian bookmakers on racing (measured 19 Oct 2026; live count at https://puntersedge.online/coverage-report.json). AU thoroughbred, greyhound and harness; NZ thoroughbred and harness; British, Irish and South African racing on smaller panels. AFL, NRL, NBA, NFL, tennis, cricket and more on sports. Free tier: 3,000 credits a month, no card.

---

There are two PuntersEdge MCP servers. You probably want the Python one.

Being straight about this, because the difference is large.

	puntersedge-mcp on PyPI (Python)	This repo (TypeScript)
Tools	26	9
Credit cost stated per tool	yes, all 26	no
Works before you have an API key	yes — two keyless demo tools	no
Form, premierships, closing lines, track conditions, feed health	yes	no
Install	uvx puntersedge-mcp	npx -y github:Propertyscout001/puntersedge-mcp
Docs	https://puntersedge.online/developers/mcp-server	this file

If you just want the odds inside your assistant, use the Python server. It is the fuller server, it is the one the documentation describes, and it will show you live prices before you sign up for anything.

This TypeScript server is a smaller, dependency-light implementation of the five core racing tools and four sports tools. It is real and it works — the install below is verified — but it is a subset.

{
  "mcpServers": {
    "puntersedge": {
      "command": "uvx",
      "args": ["puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

Full instructions: https://puntersedge.online/developers/mcp-server?utm_source=github&utm_medium=readme

---

Install this server

Not published to npm. There is no npm package called puntersedge-mcp — install straight from this repo, which builds itself on install:

npx -y github:Propertyscout001/puntersedge-mcp

First run clones the repo and compiles it with tsc, so it takes a while and needs git plus a working Node toolchain. Node ≥18.

Get a free API key at https://puntersedge.online/api?utm_source=github&utm_medium=readme — 3,000 credits a month, no credit card.

Claude Desktop

Edit claude_desktop_config.json, then fully quit and reopen Claude Desktop:

OS	Path
macOS	~/Library/Application Support/Claude/claude_desktop_config.json
Windows	%APPDATA%\Claude\claude_desktop_config.json
Linux	~/.config/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "puntersedge": {
      "command": "npx",
      "args": ["-y", "github:Propertyscout001/puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

Claude Code

One command, from the project directory:

claude mcp add puntersedge \
  -e PUNTERSEDGE_API_KEY=your_key_here \
  -- npx -y github:Propertyscout001/puntersedge-mcp

Add -s user to make it available in every project instead of just this one. Claude Code writes project servers to .mcp.json in the project root, which you can commit and edit by hand — keep the key out of it and use an environment variable if you do.

Cursor

.cursor/mcp.json for one project, ~/.cursor/mcp.json for all of them:

{
  "mcpServers": {
    "puntersedge": {
      "command": "npx",
      "args": ["-y", "github:Propertyscout001/puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

Windsurf

~/.codeium/windsurf/mcp_config.json — same mcpServers shape as Cursor.

VS Code / GitHub Copilot

.vscode/mcp.json in the workspace. VS Code uses a servers key rather than mcpServers:

{
  "servers": {
    "puntersedge": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "github:Propertyscout001/puntersedge-mcp"],
      "env": { "PUNTERSEDGE_API_KEY": "your_key_here" }
    }
  }
}

Anything else

Any host that accepts a stdio server takes the same three facts: a command, its arguments, and an env block carrying PUNTERSEDGE_API_KEY. Keep the key in the environment, not in a prompt — the server reads it once at start-up and never echoes it in a tool result.

---

Tools

Nine tools, all read-only. Costs are in API credits and are what the API bills for the underlying endpoint — they are not this server's invention. Figures below were read from https://api.puntersedge.online/openapi.json on 2026-09-15.

Racing

Tool	What it returns	Cost
racing_next_to_go	The next AU races about to jump, with every bookmaker's price per runner. The primary tool.	2 credits
racing_best_odds	Just the best available price per runner, and which book is offering it.	3 credits
racing_events	The upcoming schedule — venues, race numbers, jump times. No prices, so cheaper.	1 credit
racing_results	Settled results and dividends for races already run.	2 credits
racing_movers	Runners firming or drifting sharply across the market. min_books guards against reading one book's reprice as a market move.	3 credits

This is the beginning of the README. Read the rest at the original. Read the full README ↗