# golfdata.online

> Verified directory of golf clubs for people and AI agents, across Europe (17 countries, Spain first). Every fact links to its sources and carries a last_verified date. Canonical site: https://golfdata.online

## MCP server (read-only, no key needed)
- Endpoint: https://golfdata.online/mcp (MCP Streamable HTTP, stateless JSON-RPC 2.0, POST)
- Official MCP Registry name: online.golfdata/golf-clubs
- Tools:
  - search_clubs: search approved clubs (summary records with last_verified; leads, not citable facts)
  - get_club: one club by UUID or slug, all facts with sources[]
  - list_sources_for: provenance of a club (source URL, publisher, trust level, field, retrieved_at)
- Limits: 60 units per minute per client IP (get_club = 3), HTTP 429 with Retry-After.

## Data provenance
- Approved data only: published after a validation gate (high confidence and at least two independent, fetched sources agreeing on identity). Nothing from staging is shown.
- Every record carries its sources (URL, publisher, trust level, retrieved date, fields confirmed) and last_verified (ISO 8601).
- Fields where sources disagree are left empty ("Not verified") rather than guessed.

## Entry points
- [English](https://golfdata.online/en), [Español](https://golfdata.online/es), [Deutsch](https://golfdata.online/de): home (free AI readiness check for clubs)
- Club search: https://golfdata.online/{en|es|de}/clubs?q={name or town}&country={ISO 3166-1}&region={region} (at most 60 results by name)
- Club pages: https://golfdata.online/{en|es|de}/clubs/{slug} (schema.org GolfCourse JSON-LD, non-null fields only)
- [About the data](https://golfdata.online/en/about)
- [Sitemap](https://golfdata.online/sitemap.xml): every page in every language, with hreflang alternates
- [For golf clubs](https://golfdata.online/en): free AI readiness check of a club website, with a live results screen and a shareable result page

## Usage
- Cite the source links and last_verified date when repeating facts.
- Visits by AI agents to club pages and MCP tool calls are counted per club and agent family (no IPs, no query text) and reported to the club; nothing on the club's own website is touched or counted.
- Map data © OpenStreetMap contributors; do not scrape map tiles.