First in Golf

TeeTime.AI MCP Server

The world's first golf course MCP server. Give your AI agent access to 30,000+ verified courses worldwide — search by name, location, country, or geographic radius. Open data. Open protocol. Zero API key required.

Transport

HTTP/JSON-RPC 2.0

Protocol

MCP 2025-06-18

Auth

None required

License

ODbL + CC-BY-SA

Endpoint & Manifest

MCP Endpoint

https://teetime.ai/api/mcp

Well-Known Manifest

https://teetime.ai/.well-known/mcp.json

Tools

tool

search_golf_courses(query: string, country?: string, admin1?: string, limit?: number)

Search courses by name, country (ISO alpha-2), and/or region. Returns up to 50 matches.

Example args

{"query": "Pebble Beach", "country": "US", "limit": 5}

tool

get_golf_course(course_id: string)

Full detail for a single course by UUID, including source provenance.

Example args

{"course_id": "3fa85f64-5717-4562-b3fc-2c963f66afa6"}

tool

find_courses_near(lat: number, lon: number, radius_km?: number, limit?: number)

Geo radius search. Returns courses sorted by distance_km.

Example args

{"lat": 37.593, "lon": -122.228, "radius_km": 25}

tool

list_countries()

All countries in the graph with live active course counts.

Example args

{}

tool

list_regions(country: string)

States/provinces for a country with live course counts.

Example args

{"country": "AU"}

Quick Verify

# Initialize
curl -s -X POST https://teetime.ai/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"initialize","params":{}}'

# List tools
curl -s -X POST https://teetime.ai/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/list","params":{}}'

# Search courses
curl -s -X POST https://teetime.ai/api/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":3,"method":"tools/call","params":{"name":"search_golf_courses","arguments":{"query":"Augusta","country":"US","limit":3}}}'

Add to Your AI Client

Claude Desktop

~/Library/Application Support/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "teetime-golf": {
      "url": "https://teetime.ai/api/mcp",
      "transport": "http"
    }
  }
}

Cursor

.cursor/mcp.json in your project root

// .cursor/mcp.json
{
  "mcpServers": {
    "teetime-golf": {
      "url": "https://teetime.ai/api/mcp"
    }
  }
}

Continue

~/.continue/config.json

// ~/.continue/config.json (add under "experimental.modelContextProtocolServers")
{
  "name": "teetime-golf",
  "transport": {
    "type": "http",
    "url": "https://teetime.ai/api/mcp"
  }
}

License & Attribution

All responses include attribution metadata (attribution, license fields). Data is licensed under ODbL 1.0 (OSM-derived) and CC-BY-SA 4.0 (Wikipedia-derived).

Attribution required in any derived work: "© OpenStreetMap contributors (ODbL 1.0), © Wikipedia contributors (CC-BY-SA 4.0). Compiled by teetime.ai."

Rate limit: 60 requests/minute per IP. No API key required. Full license details →

Registry Status

Manifest live at /.well-known/mcp.json. Registry submission pending Anthropic's official MCP registry launch. TeeTime.AI is positioned to be the first golf course MCP server in the registry.

To submit when the registry opens: github.com/modelcontextprotocol/registry