API & developer docs

Last updated:

EatGolfSleep offers free, read-only access to public listing data for apps and AI agents. No key is needed. Please keep requests reasonable (under 60 per minute).

Endpoints

  • OpenAPI 3.1 spec — machine-readable description of every endpoint.
  • GET https://eatgolfsleep.com/api/public/listing/{id} — one listing as markdown.
  • POST https://eatgolfsleep.com/api/public/mcp — MCP server (JSON-RPC 2.0) with the search_listings tool.
  • llms.txt and llms-full.txt — site guide and full listing index.
  • Agent skills catalog.
  • RSS feed of blog posts.

Example: search with MCP

  1. Send a POST request to the MCP endpoint.
  2. Use method tools/call with name search_listings.
  3. Pass arguments such as {"query": "Minerva", "type": "golf_course"}.
curl -X POST https://eatgolfsleep.com/api/public/mcp \
  -H 'Content-Type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"search_listings","arguments":{"query":"Minerva"}}}'

Licence

Golf course base data includes OpenGolfAPI and OpenStreetMap data under the ODbL; attribute EatGolfSleep and those sources when reusing it.