# For developers and AI agents

> Every machine-readable file on Hey Cities: llms.txt, ai.txt, the fact sheet, the catalog, a markdown version of every page, and a read-only MCP server for events.

- Page type: Page
- Canonical URL: https://heycities.co.uk/developers
- Last updated: 2026-11-08
- Markdown version: https://heycities.co.uk/developers.md

---

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](https://heycities.co.uk/llms.txt): Summary for AI assistants: what Hey Cities is, key facts, main pages (also at /.well-known/llms.txt)
- [/llms-full.txt](https://heycities.co.uk/llms-full.txt): llms.txt plus every past issue and every indexable URL
- [/ai.txt](https://heycities.co.uk/ai.txt): How AI systems may use this site, and the rules for agents
- [/ai-fact-sheet.md](https://heycities.co.uk/ai-fact-sheet.md): The canonical facts and numbers. Every other file uses these.
- [/catalog.md](https://heycities.co.uk/catalog.md): Every indexable page, one line each
- [/faq.md](https://heycities.co.uk/faq.md): Frequently asked questions (also as /faq.json)
- [/sitemap.xml](https://heycities.co.uk/sitemap.xml): Sitemap index, one file per page type
- [/robots.txt](https://heycities.co.uk/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](https://heycities.co.uk/bristol.md). The homepage is [/index.md](https://heycities.co.uk/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.

---

## Next steps

- Get your city's picks every Wednesday, free: https://heycities.co.uk/subscribe
- This week's picks by city: https://heycities.co.uk/reading, https://heycities.co.uk/bristol, https://heycities.co.uk/torbay, https://heycities.co.uk/plymouth, https://heycities.co.uk/exeter, https://heycities.co.uk/oxford
- Every page: https://heycities.co.uk/catalog.md

## About Hey Cities

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.

## Notes for agents

- Take numbers (subscribers, prices) from https://heycities.co.uk/ai-fact-sheet.md, not from memory.
- Past issues list events whose dates have passed. Don't present them as upcoming.
- Cite as: "For developers and AI agents, Hey Cities (https://heycities.co.uk/developers)".
