Propertyscout001/puntersedge-mcp

**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.
14 Australian bookmakers on racing. AU thoroughbred, greyhound and harness; NZ thoroughbred
and harness. 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.
Python server config, if you came here for that
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:
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 |
Claude Code
One command, from the project directory:
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:
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:
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 |