Model Context Protocol
A golf MCP server for your own rounds
Chalk Golf runs a hosted remote MCP server. Connect it to Claude, ChatGPT or Claude Code, sign in, and the model can read your rounds, scorecards, stats, shot patterns, handicap record, swing analyses and course notes.
https://api.chalkgolfapp.com/mcpServer details
- Endpoint
- https://api.chalkgolfapp.com/mcp
- Transport
- Streamable HTTP, stateless, JSON responses
- Auth
- OAuth 2.1 with PKCE and dynamic client registration
- Discovery
- Protected resource metadata at /.well-known/oauth-protected-resource/mcp
- Access
- Read-only. Every tool is annotated readOnlyHint
- Data
- Only the signed-in golfer’s own Chalk Golf account
Tools
| Tool | Returns | Inputs |
|---|---|---|
get_profile | Name, current handicap index, home course, completed rounds and membership costs. | None |
get_handicap | Current index and the official score records synced from England Golf or GHIN: date, course, adjusted gross, score differential and the index after each score, plus the 12-month low and the best 8 of the last 20. | None |
list_rounds | Rounds newest first with date, course, gross, score to par, holes played and competition details. | Course, date range, limit |
get_round | Hole-by-hole card (par, stroke index, yards, strokes, putts, fairway), voice-logged shots with club, distance and result, and the post-round review. | Round id |
get_stats | Scoring average, best round, recent form, par 3/4/5 averages, score mix, putting and fairways. For one course, the holes ranked by strokes over par. | Course, date range, number of rounds |
get_shot_patterns | From voice-logged shots: average and longest distance per club, left/centre/right finish, short and long misses, shapes and strike quality. | Club, course, date range, number of rounds |
list_swings | Swing Studio analyses with club, camera view, 0–10 swing score, the fault to fix first and headline tempo and turn. | Limit |
get_swing | Score, every check with its measured value and target, tempo, body metrics, written feedback with a practice plan and the change since the last comparable swing. | Swing id |
list_practice | Practice sessions with date, type, title, notes and minutes. | Date range, limit |
search_courses | Courses in Chalk matching a name, with how many rounds you've played at each. | Course name |
get_course | Holes (par, stroke index, yards per tee), tee ratings, your own notes and your scoring history there, including the holes that cost you most. | Course id |
Connect a client
Claude custom connector
Customize → Connectors → + Add → Add custom connector. Name it Chalk Golf, paste the URL, then Connect and sign in. Leave the OAuth client fields empty: the client registers itself.
Claude Code
claude mcp add --transport http chalk-golf https://api.chalkgolfapp.com/mcpRun /mcp, pick chalk-golf and sign in in the browser.
ChatGPT developer mode
Settings → Apps → Advanced settings → Developer mode, then Create app with the URL and OAuth. Step-by-step instructions for both apps are on Use Chalk Golf in ChatGPT and Claude.
Security
Every tool is read-only and scoped to the signed-in golfer. Tokens issued to an MCP client only work on /mcp; the rest of the Chalk Golf API rejects them. Course text that other golfers can edit is flattened and length-capped before it reaches the model.
The consent page only approves clients that return to Claude, ChatGPT or a loopback address on your own computer. Golfers can see and revoke connected clients in Connected apps.
Questions
Is there an MCP server for golf stats?
Yes. Chalk Golf runs a hosted MCP server at api.chalkgolfapp.com/mcp. It gives Claude, ChatGPT and Claude Code read-only access to the rounds, stats, handicap record and swing analyses in your own Chalk Golf account after you sign in.
Do I need to install or host anything?
No. It’s a remote server, so you paste the URL into your MCP client and sign in. There’s nothing to run on your computer and no API key to manage.
Does it store my password or use another app’s login?
No. You sign in on chalkgolfapp.com through OAuth and the client gets a token for this server only. Chalk Golf’s own API serves the data, so it doesn’t depend on scraping another service.
Can a token from the MCP server be used elsewhere?
No. Tokens issued to an MCP client only work on /mcp. The rest of the Chalk Golf API rejects them.
Which MCP clients can connect?
Claude (web, desktop and mobile), Claude Code and ChatGPT in developer mode. The consent page only approves clients that return to claude.ai, claude.com, chatgpt.com or a loopback address on your own computer.
Where does the data come from?
From what you record in the Chalk Golf app on iPhone, Android or Apple Watch: scores by tap or voice, voice-logged shots, England Golf or GHIN imports, Swing Studio analyses, practice sessions and course notes.