# Disc Golf MCP

> Disc golf data for AI agents. A Model Context Protocol server exposing PDGA players, events, courses, season statistics and results to any MCP client.

Endpoint: https://discgolfmcp.com/mcp
Transport: Streamable HTTP, HTTPS only.
Protocol: MCP revision 2026-07-28 (https://modelcontextprotocol.io/specification/2026-07-28).

The endpoint requires OAuth 2.1. An unauthenticated request answers 401 with a
`WWW-Authenticate` challenge naming the authorization server. A compliant
client runs the flow. Callers supply no PDGA credentials of their own; the
server authenticates upstream with a single server-side account. Free,
non-commercial use. The licence requires attribution. Link every player, event
and course name to its pdga.com page. Some of this data comes from public www.pdga.com endpoints the PDGA does not document, read without an account and identified only by a contact address, outside the Developer Program terms.

## Connect

    claude mcp add --transport http disc-golf https://discgolfmcp.com/mcp

## Tools

- `pdga_division_standings`: Who finished where in one division of one event: placing, total, score to par and prize.
- `pdga_entry_scorecard`: One entry played out: every round, every hole, the layout and both round ratings.
- `pdga_event_info`: What an event was: dates, tier, scoring format, the divisions that ran and the round numbers they played.
- `pdga_find_courses`: Courses by name, location, postal code or coordinate.
- `pdga_find_events`: Sanctioned events by date, tier, classification or location.
- `pdga_find_players`: Members by PDGA number, name or location.
- `pdga_player_results`: One player's whole competitive record: every event entered, division, placing, score and winnings.
- `pdga_player_statistics`: Rating, events, Tour points and winnings by season, for one player or a whole division ranked by points.

## Prompts

- `pdga_player_card`: Member record plus season statistics for one player, by PDGA number or name.

## Resources

An address with a `{variable}` in it is a template: fill it in and
`resources/read` fetches that one PDGA record. There is no listable set of
those, because the PDGA cannot be enumerated. The fixed addresses cost no
upstream call and are the whole of what `resources/list` returns.

- `pdga://course/{course_id}`: One course: name, location, holes, length and amenities.
- `pdga://event/{tournament_id}`: One event: name, dates, location, tier, format and status.
- `pdga://player/{pdga_number}`: A player's member record: name, rating, classification, membership status and location.
- `pdga://server/instructions`: The server's own guidance, the same text `server/discover` returns as `instructions`.

## Pages

- [Home](https://discgolfmcp.com/): what the server is and how to connect.
  The complete surface is above, not there.

## Notes

- Data from the Professional Disc Golf Association (pdga.com) and remains its property. Disc Golf MCP is an independent project, not affiliated with or endorsed by the PDGA.