golfdata.online MCP connector for ChatGPT, Claude and Cursor
The golfdata.online connector gives an AI assistant verified golf club data across Europe, Spain first: each fact with its source and the date it was verified. It is a Model Context Protocol (MCP) server over Streamable HTTP, free and without a key.
Last updated: 22 November 2026
What the connector does
- Finds golf clubs and courses by name, place or coordinates and returns each club's facts: holes, par, green fees, visitor rules, booking link, phone, opening hours, facilities.
- Every fact carries its source URL, the publisher, a trust level and a verified date, so the assistant can cite where a fact comes from and how old it is.
- Read-only, with one exception: a booking request can be forwarded to a club that has enabled booking requests. golfdata only forwards it to the club and never confirms a booking.
- Says what it covers: a coverage tool reports, per country, region and island, how many clubs are listed, how many have a verified green fee or a booking link, and how fresh the data is.
Endpoint
MCP Streamable HTTP (stateless JSON-RPC 2.0 over HTTPS POST), no authentication, no key, no account.
Server version 1.4.0. The machine-readable server card is at /.well-known/mcp.json; the plain-text guide for agents is /llms.txt.
Tools
The same list the server card publishes. Use search_clubs for names and places, find_nearby_clubs for coordinates, get_club for one club's full facts and sources, list_sources_for for provenance only, and get_data_coverage before claiming what golfdata covers.
- search_clubs (read-only)Find clubs by name or place (free text, country, island, region, municipality): summary records with last_verified; leads, not citable facts.
- find_nearby_clubs (read-only)Clubs closest to a lat/lng (radius_km default 25, max 200; limit default 10, max 50): summary records plus distance_km, nearest first.
- get_club (read-only)One club by UUID or slug: all facts with sources[], the club card and club_facts; the tool to call before citing.
- list_sources_for (read-only)Full provenance of a club (source URL, publisher, trust level, field, retrieved_at), without the facts.
- get_data_coverage (read-only)What the directory covers: per country (and per region/island for one country) clubs, clubs with a verified green fee or a booking link, newest/oldest last_verified, valid region/island filter values.
- request_booking (writes: forwards a booking request to the club)Send a booking request to a club that has booking.requests_enabled true (routed by email or a WhatsApp link); you must have the golfer's consent to share their details.
How to add it
Paste the endpoint URL into your client's MCP or connector settings. No key is asked for; leave authentication empty.
ChatGPT
- Open Settings → Connectors and enable developer mode (custom connectors), if your plan offers it.
- Choose “Create” (custom connector), give it a name such as “golfdata”, and paste the endpoint URL.
- Authentication: none. Save, then enable the connector in a conversation (developer mode) and ask a golf question.
Claude
- Open Settings → Connectors → “Add custom connector”.
- Name: golfdata. Remote MCP server URL: the endpoint above. No OAuth or key.
- Enable it for the chat; Claude lists the tools and calls them when a question is about golf clubs.
Cursor and other MCP clients
- Add the server to your MCP configuration (for Cursor: mcp.json) with the snippet below, or use the client's “add remote MCP server” dialog with the same URL.
- Transport: Streamable HTTP (a stateless POST endpoint; no SSE stream, no session).
{
"mcpServers": {
"golfdata": {
"url": "https://golfdata.online/mcp"
}
}
}Example prompts
- “Which golf courses in Tenerife have a verified green fee, and what does it start from?”
- “Find golf courses within 30 km of Marbella and show the distance to each.”
- “What does golfdata know about Golf del Sur? Give me the sources and the verification dates.”
- “Which clubs in the Algarve have an online booking link?”
- “How many clubs does golfdata list in Scotland, and how fresh is the data?”
- “Which golf courses near Munich accept visitors?”
Rate limits
20 units per minute per client IP. get_club costs 4 units, other calls 1. search_clubs accepts limit ≤ 10 (a larger limit is refused with JSON-RPC error -32011). Over the budget the server answers HTTP 429 with a Retry-After header. These are the strict limits the server runs until its shared limiter is switched on; /llms.txt says so when they rise.