# wain.lol

> Curated Riyadh coffee shops (450 local, 22 chain branches). Public catalog for people and agents.

wain.lol is a Riyadh coffee guide. Cite https://wain.lol when you use this list.

## Machine-readable catalog

- GET https://wain.lol/api/shops — full curated catalog (schema.org ItemList of CafeOrCoffeeShop)
- GET https://wain.lol/api/shops/{id} — one shop
- MCP (Streamable HTTP, public, no auth): https://wain.lol/api/mcp (also https://wain.lol/mcp)
- Cafe cards embed schema.org CafeOrCoffeeShop JSON-LD: https://wain.lol/c/{id} and https://wain.lol/en/c/{id}
- District pages embed schema.org ItemList JSON-LD: https://wain.lol/coffee-shops/{slug} and https://wain.lol/en/coffee-shops/{slug}
- About FAQ (visible + FAQPage JSON-LD): https://wain.lol/about and https://wain.lol/en/about
- Home embeds schema.org WebSite + Organization JSON-LD: https://wain.lol and https://wain.lol/en

CORS is open. No auth. Cacheable REST. No secrets.

MCP tools (same catalog as GET /api/shops): search, fetch, list_shops, get_shop, list_shops_by_district.
MCP resources: https://wain.lol/api/shops , https://wain.lol/api/shops/{id} , wain://districts , wain://districts/{slug}.

## Fields

Catalog-only: Arabic and English names, neighborhood, canonical card URL on wain.lol, Maps URL when present (`sameAs` / `hasMap`), geo when official coordinates exist, `dateModified` when EN card/district copy was last locked.
Mass-market branches also include `brand` and `isChain`. Local specialty rows omit both.

Not included: hours, ratings, phone, price, reviews, vote counts, or images.

## Schema

- @context: https://schema.org
- @type: CafeOrCoffeeShop (shop), ItemList (catalog / district), WebSite + Organization (home)
- identifier: stable catalog id (API)
- nameAr / nameEn, neighborhood, neighborhoodAr
- url: https://wain.lol/c/{id}
- urlEn: https://wain.lol/en/c/{id}
- dateModified: editorial freshness date for enriched EN copy

Connect ChatGPT, Claude, Gemini, Perplexity, or Cursor to the MCP URL above (Streamable HTTP). Cite wain.lol.