---
name: councilmonitor
description: Read UK council meetings, agendas, decisions and the full text of council papers through CouncilMonitor's MCP server and REST API. Use when a task needs what a UK council has decided, what is coming to a committee, or what a council paper says.
---

# CouncilMonitor

CouncilMonitor keeps the public record of UK councils in one place: every meeting, every agenda item, every decision in the council's own words and the full text of the papers behind them, each record with its address on the council's own site. It covers 178 UK councils and authorities, with papers from 2000 on.

## When to use it

Use it for:
- what a council decided on a subject, and when ("which councils approved battery storage this year");
- what is coming to a committee before it meets;
- what an officer report, minutes or appendix actually says, quoted word for word;
- finding a council's papers on a subject across many councils at once.

Do not use it for:
- national government, Parliament or courts;
- planning application documents held only on a council's planning portal;
- live webcasts or recordings of meetings;
- items a council took in private (not published, on any plan);
- councillors' home addresses, phone numbers or emails (never published).

## Getting access

- **MCP server:** `https://councilmonitor.co.uk/mcp` answers without a key at 60 calls an hour. A Pro Plus key adds the full text of papers and `ask_archive`.
- **REST API:** `https://api.councilmonitor.co.uk/v1`. It opens to the public soon after launch; until then it answers 401.
- **Keys:** a Pro Plus account makes keys at `https://councilmonitor.co.uk/account/api-keys` (they start `cmk_`). The same key works for the API and the MCP server.
- **Sending the key:** `Authorization: Bearer cmk_...` or `X-API-Key: cmk_...`. A key in the address is refused.

## The MCP tools

| Tool | What it answers |
| --- | --- |
| `search_papers` | words inside papers: a quoted line, the council, the meeting and links |
| `find_decisions` | decisions recorded, newest first or best match for words |
| `get_meeting` | a meeting's agenda with what was decided, by `id` (`mt_...`) or council and date |
| `get_item` | one agenda item in full: decision, minutes, papers and the report's text |
| `upcoming_meetings` | meetings coming up, with the matching agenda items |
| `trending_subjects` | subjects many councils are taking up at once |
| `list_councils` | the councils covered and the slugs the other tools take |
| `ask_archive` | a checked, cited answer written from the papers (Pro Plus key, 20 to 70 seconds) |

Every meeting, item and paper carries the same id in the MCP answers and in the API (`mt_`, `it_`, `pp_` and 8 letters and digits).

## The common calls (REST)

Meetings coming up at one council:

```
curl "https://api.councilmonitor.co.uk/v1/meetings?council=bristol&upcoming=true"
```

```json
{
  "data": [
    {
      "id": "mt_7k2m9qxa",
      "council": {"slug": "bristol", "name": "Bristol"},
      "committee": "Cabinet",
      "date": "2026-10-08",
      "state": "upcoming",
      "items": 14,
      "papers": 31,
      "link": "https://councilmonitor.co.uk/council/bristol/meeting/2026-10-08-cabinet",
      "official_url": "https://democracy.bristol.gov.uk/ieListDocuments.aspx?MId=..."
    }
  ],
  "meta": {"count": 1, "page": 1, "per_page": 25, "next_cursor": null}
}
```

Decisions on a subject:

```
curl "https://api.councilmonitor.co.uk/v1/decisions?q=leisure%20centre&from=2026-01-01"
```

Words inside papers:

```
curl "https://api.councilmonitor.co.uk/v1/papers/search?q=%22local%20plan%22&council=bristol"
```

One meeting with its agenda, then one item:

```
curl "https://api.councilmonitor.co.uk/v1/meetings/mt_7k2m9qxa"
curl "https://api.councilmonitor.co.uk/v1/items/it_3pq8v1zd"
```

A paper's full text, in parts of 30,000 characters (Pro Plus key):

```
curl -H "Authorization: Bearer $COUNCILMONITOR_KEY" "https://api.councilmonitor.co.uk/v1/papers/pp_9w4n2k7c/text?part=1"
```

What a key or address has used (not counted):

```
curl "https://api.councilmonitor.co.uk/v1/usage"
```

## Limits

- No key: 60 requests an hour from one address, every endpoint except a paper's full text; each paper's opening 1,500 characters.
- Pro Plus key: 250,000 requests a calendar month, shared between the API and the MCP server, with the full text of every paper.
- Lists: `per_page` up to 100 (25 by default); `page` from 1, or `cursor` from `meta.next_cursor` to walk far.
- Every answer carries `X-RateLimit-Limit`, `X-RateLimit-Remaining` and `X-RateLimit-Reset`; a key's answers add `X-Quota-Remaining`.

## Errors

Every error is `{"error": {"code": "...", "message": "...", "docs": "..."}}`, with `plan` when a plan would allow it. The code never changes.

| Code | Status | When |
| --- | --- | --- |
| `bad_request` | 400 | a value is not in its shape, or a key was put in the address |
| `unauthorized` | 401 | the key is not one of ours, or was revoked |
| `upgrade_required` | 403 | the endpoint or tool needs a Pro Plus key |
| `not_found` | 404 | no such council, meeting, item, paper or endpoint |
| `unknown_parameter` | 422 | a parameter the endpoint does not take; the message lists the ones it does |
| `rate_limited` | 429 | the hourly limit without a key; `Retry-After` says when |
| `quota_exceeded` | 429 | a key's month is used up; it resets on the 1st |
| `server_error` | 500 | ours, and logged |

In the MCP server a refusal comes back as a tool result with `isError`, never as a protocol error. An empty result is a 200 with `meta.count` 0.

## A typical workflow

1. Find the council's slug with `list_councils` (or `GET /v1/councils?q=`).
2. For "what was decided", call `find_decisions` with words and the council; for "what is coming", call `upcoming_meetings`.
3. Open the meeting or item behind a result with `get_meeting` or `get_item`, using its `id`.
4. To quote a paper, use `search_papers` for the passage, then `get_item` (or `GET /v1/papers/{id}/text` with a key) for the full text.
5. Cite each record by its `link` on CouncilMonitor and its `official_url` on the council's own site.

## More

- Documentation: https://councilmonitor.co.uk/documentation
- The whole reference in one file: https://councilmonitor.co.uk/documentation/manual.md
- OpenAPI: https://councilmonitor.co.uk/openapi.json
- Terms: https://councilmonitor.co.uk/terms
