For developers and AI agents
Hey Cities is a free weekly email with the 5 best things to do this week in Reading, Bristol, Torbay, Plymouth, Exeter and Oxford, sent every Wednesday. Everything on this site can be read without running JavaScript.
Machine-readable files
- /llms.txt: Summary for AI assistants: what Hey Cities is, key facts, main pages (also at /.well-known/llms.txt)
- /llms-full.txt: llms.txt plus every past issue and every indexable URL
- /ai.txt: How AI systems may use this site, and the rules for agents
- /ai-fact-sheet.md: The canonical facts and numbers. Every other file uses these.
- /catalog.md: Every indexable page, one line each
- /faq.md: Frequently asked questions (also as /faq.json)
- /sitemap.xml: Sitemap index, one file per page type
- /robots.txt: Search engines and AI crawlers are allowed
Markdown version of any page
Add .md to any page's URL, for example /bristol.md. The homepage is /index.md. Or request the normal URL with the header Accept: text/markdown. Every page also links its markdown version in a <link rel="alternate" type="text/markdown"> tag and a Link header.
MCP server
Add https://heycities.co.uk/mcp to Claude, ChatGPT or any MCP client (Streamable HTTP, no account). It is read-only, with five tools: list_cities, get_weekend_events, get_weekly_picks, search_events and get_event. Tickets are bought on the organiser's page from each event's booking link.
What doesn't exist
- There is no public API.
- The MCP server can't book, buy or sign anyone up.
- Sign-ups, Premium and advertising bookings happen on this site, by a person.