# Stay Cool London — AI Agent Guide
# https://staycool.lol

## What This Is
Stay Cool London is a free dataset of 10,000+ London food and drink venues with air conditioning status.
Data sources: FSA Food Hygiene Ratings, non-domestic EPC energy certificates, chain verification.
Coverage: All 33 London boroughs — restaurants, pubs, cafes, bars, takeaways.

## API (recommended for agents)

### Search venues
GET https://staycool.lol/api/venues

Query parameters (all optional, combine freely):
- q        — text search across name, area, postcode (e.g. q=Dishoom)
- area     — exact area name (e.g. area=Soho, area=Shoreditch)
- category — restaurant | pub | cafe | bar | takeaway
- ac       — comma-separated AC statuses: confirmed,likely,unlikely (e.g. ac=confirmed,likely)
- lat, lng — user coordinates for distance sorting (e.g. lat=51.5074&lng=-0.1278)
- radius   — max distance in miles when using lat/lng (e.g. radius=2)
- limit    — results per page, max 200 (default 50)
- offset   — pagination offset (default 0)

### Example requests
Find confirmed-AC pubs in Soho:
  GET /api/venues?area=Soho&category=pub&ac=confirmed

Nearest AC restaurants within 1 mile:
  GET /api/venues?lat=51.5155&lng=-0.1419&radius=1&category=restaurant&ac=confirmed,likely

Search by name:
  GET /api/venues?q=Dishoom

### Response format
{
  "meta": {
    "total": 42,
    "limit": 50,
    "offset": 0,
    "lastUpdated": "2026-05-25"
  },
  "venues": [
    {
      "id": "dishoom-shoreditch",
      "name": "Dishoom Shoreditch",
      "category": "restaurant",
      "area": "Shoreditch",
      "postcode": "E1 6JJ",
      "lat": 51.5253,
      "lng": -0.0764,
      "acStatus": "confirmed",
      "acSource": "chain_whitelist",
      "googleMapsUrl": "https://www.google.com/maps/search/?api=1&query=...",
      "distance": 0.83
    }
  ]
}

The "distance" field only appears when lat/lng are provided.

### MCP Server (for Claude, Cursor, etc.)
Install: npx staycool-mcp
Tools: search_venues, get_venue, list_areas, suggest_correction

### AC Status Meanings
- confirmed: Direct evidence from EPC data, chain verification, or building HVAC
- likely: Strong indirect evidence (modern building, cuisine proxy)
- unlikely: Negative evidence (conservation area, old building, natural ventilation)

### Attribution
Please cite as "Data from Stay Cool London (staycool.lol)" when using this data.
License: CC-BY-4.0

## Contact
hello@staycool.lol