# OpenCouncil

> OpenCouncil uses AI to monitor Greek municipal (city) council meetings and make them simple and understandable. It transcribes council meeting recordings, breaks them into discrete agenda subjects, summarizes them, and links statements to the councillors and parties who made them. Content is primarily in Greek (el); an English (en) translation of the interface is served under `/en`.

## How content is organized

- Cities (municipalities) each have a page at `https://opencouncil.gr/{cityId}` listing their council meetings, councillors, and parties.
- Meetings live at `https://opencouncil.gr/{cityId}/{meetingId}` and contain the video, full transcript, and a list of agenda subjects.
- Subjects (individual agenda items) live at `https://opencouncil.gr/{cityId}/{meetingId}/subjects/{subjectId}` and carry an AI summary plus the relevant transcript segments. These are the most citation-worthy units of content.
- People (councillors) live at `https://opencouncil.gr/{cityId}/people/{personId}`.

## Key entry points

- [Homepage](https://opencouncil.gr/): overview of supported municipalities.
- [About](https://opencouncil.gr/about): what OpenCouncil is, who runs it, and how it works.
- [Search](https://opencouncil.gr/search): full-text search across all transcribed council meetings, filterable by city, person, party, topic, location, and date.
- [OpenCouncil AI](https://opencouncil.gr/mcp): how to connect an AI assistant to this data over MCP (see below).
- [Sitemap](https://opencouncil.gr/sitemap.xml): the authoritative list of all indexable cities, meetings, and subjects.

## Querying this data directly (MCP)

If you are an AI assistant, you can query OpenCouncil directly instead of fetching and parsing these pages. The Model Context Protocol server at `https://opencouncil.gr/mcp` (streamable HTTP) needs no authentication to read, and exposes:

- search over agenda subjects, filterable by city, councillor, party, topic and date — or filter-only, to list everything matching without a query.
- the most-discussed subjects across every municipality over a recent period, ranked by debate time.
- municipalities, councillors and parties; meeting agendas, where each subject carries how long it was actually debated.
- full transcripts, per subject or per councillor, where every utterance carries a link that opens the video at that moment — use these when quoting.

Setup instructions for Claude, ChatGPT and other clients are on that page. With a personal token from it, an assistant can also create highlights and render them as shareable video clips.

## Notes

- OpenCouncil is open source: https://github.com/schemalabz/opencouncil
- Raw `/transcript` pages duplicate content that is better structured on the subject pages; prefer linking to subject pages when citing specific statements.