Skip to content
golfdata.online

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

https://golfdata.online/mcp

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

  1. Open Settings → Connectors and enable developer mode (custom connectors), if your plan offers it.
  2. Choose “Create” (custom connector), give it a name such as “golfdata”, and paste the endpoint URL.
  3. Authentication: none. Save, then enable the connector in a conversation (developer mode) and ask a golf question.

Claude

  1. Open Settings → Connectors → “Add custom connector”.
  2. Name: golfdata. Remote MCP server URL: the endpoint above. No OAuth or key.
  3. Enable it for the chat; Claude lists the tools and calls them when a question is about golf clubs.

Cursor and other MCP clients

  1. 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.
  2. 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.

Privacy, terms and more