# NeoDemos (remote · mcp.neodemos.nl)

Source-anchored search and civic intelligence for Dutch municipal council records.

- Trust score: 86/100 (high trust)
- Change this week: 0
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-21

## Components

- remote · `mcp.neodemos.nl`: 86/100 (this document), [markdown](https://verifymcp.io/servers/neodemoshq-neodemos/public-mcp.md), [page](https://verifymcp.io/servers/neodemoshq-neodemos/public-mcp)

## Channel facts

- Endpoint: `https://mcp.neodemos.nl/public/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.3.41`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-21.

- **Endpoint Security**: 83/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 74/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 4832 tokens (~439/item across 11 items; 7 tools + 4 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 100/100
  - No destabilizing schema changes in the last 30 days.
- **Tool Coverage**: 67/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 0% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 7 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 9 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the NeoDemos MCP server?

NeoDemos is a hosted endpoint at https://mcp.neodemos.nl/public/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http neodemoshq-neodemos 'https://mcp.neodemos.nl/public/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "neodemoshq-neodemos": {
      "url": "https://mcp.neodemos.nl/public/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "neodemoshq-neodemos": {
      "type": "http",
      "url": "https://mcp.neodemos.nl/public/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.neodemoshq-neodemos]
url = "https://mcp.neodemos.nl/public/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "neodemoshq-neodemos": {
      "type": "remote",
      "url": "https://mcp.neodemos.nl/public/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add neodemoshq-neodemos --url 'https://mcp.neodemos.nl/public/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  neodemoshq-neodemos:
    url: "https://mcp.neodemos.nl/public/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "neodemoshq-neodemos": {
      "Transport": "http",
      "Url": "https://mcp.neodemos.nl/public/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add neodemoshq-neodemos -t streamable-http -u 'https://mcp.neodemos.nl/public/mcp'
```

### Other

```json
{
  "mcpServers": {
    "neodemoshq-neodemos": {
      "type": "http",
      "url": "https://mcp.neodemos.nl/public/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-21 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.160 → v0.3.163

### 2026-09-20 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.159 → v0.3.160

### 2026-09-19 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.157 → v0.3.159

### 2026-09-18 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.152 → v0.3.157

### 2026-09-17 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.145 → v0.3.152

### 2026-09-16 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.139 → v0.3.145

### 2026-09-15 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.135 → v0.3.139

### 2026-09-14 (score 86, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [functional] Server version: v0.3.133 → v0.3.135

## MCP tools (7)

### `get_neodemos_context` (~303 tokens)

Retourneert een structured primer met de beschikbare gemeenten, document-types, de huidige zittende wethouders van Rotterdam (uit `raadslid_rollen`), de coalition-history per college-periode, known limitations, en recommended tool sequences voor veelvoorkomende vraagpatronen. Cheap to call (<50ms). Cached op server-niveau als de DB bereikbaar is.

Gebruik deze tool wanneer:
\- Je een nieuwe sessie start — dit geeft je de ground-truth voor rol/tenure/coalition in plaats   van dat je uit trainingsdata moet gokken.
\- Je een actuele referentiedatum nodig hebt voor 'vandaag', 'recent', 'vorige week'   of vergelijkbare temporele termen — het `today` veld wordt per call berekend.
\- De vraag gaat over een historische stemming — check `coalition_history` voor de compositie   op dát moment (GroenLinks/PvdA waren in 2018 coalitiepartij, niet oppositie).
\- Je niet zeker weet welke tool sequence past — zie `recommended_tool_sequences`.

Gebruik deze tool NIET wanneer:
\- De vraag al duidelijk in één retrieval tool past en je de context al kent.
\- Je al in dezelfde sessie de context hebt opgehaald (het verandert niet binnen één sessie).

Retourneert: markdown met secties voor gemeenten, document-types, raadssamenstelling, college-history, limitations, en recommended tool-sequences.

### `adviseer_raadsinstrument` (~482 tokens)

Adviseert welk raadsinstrument past bij wat het raadslid wil bereiken, en weegt EXPLICIET de doorlooptijd mee — schriftelijke vragen zijn het traagste instrument (~30 dagen) en zijn vaak niet de juiste keuze bij een actueel onderwerp. Pure kennisbank: geen retrieval, geen DB-call, <10ms.

Gebruik deze tool wanneer:
\- Het raadslid iets wil bereiken (informatie, college ter verantwoording roepen, een uitspraak/besluit, nieuw beleid) en de vraag is WELK instrument daarvoor past.
\- Je op het punt staat 'stel schriftelijke vragen' te adviseren — check eerst hier of een sneller instrument (mondelinge vragen, interpellatie) beter past bij de urgentie.
\- Je een schriftelijke-vragen- of actua-template nodig hebt die de structuur en kwaliteitscriteria volgt (in lijn met het reglement van orde).
\- Je wilt weten WAT een instrument oplevert (uitkomsttype, college-verplichting, uitvoeringsplicht) zodat je het raadslid kunt uitleggen welke actie het college verplicht is te ondernemen na gebruik van het instrument.

Gebruik deze tool NIET wanneer:
\- De vraag inhoudelijk is over een dossier → `zoek_raadshistorie` / `zoek_moties`.
\- Je een bestaande motie/amendement wilt terugvinden → `zoek_moties`.

Retourneert: markdown met het aanbevolen instrument + alternatieven, inclusief:
\- doel, snelheid, binding, wettelijke basis, wanneer-wel/niet
\- uitkomsttype (raadsbesluit / college_handeling / antwoord_college / debat / onderzoek)
\- college_verplichting: wat het college verplicht is te doen na gebruik
\- uitvoeringsplicht: ja/nee (juridisch vs. politiek afdwingbaar)
\- typische_doorlooptijd_weken: numeriek, gegrond in het RvO
\- afdoeningsproces: pad naar afsluiting
\- een bijpassende RvO-template (bij vraag-instrumenten)
\- disclaimer dat exacte termijnen/quora per lokaal RvO verschillen en geverifieerd moeten worden.

Input parameters:

- `doel` (string, required)
- `onderwerp` (string)
- `op_agenda` (boolean)
- `urgentie` (string)

### `beoordeel_tekst` (~479 tokens)

Eén deterministische review-tool voor concept-teksten van een raadslid/fractiemedewerker. Geen LLM, geen DB, <10ms. Kies de modus via `soort`:
\- `vragen` — scherpt concept schriftelijke/mondelinge vragen aan: flagt suggestief/sturend, meervoudig, gesloten ja/nee, vage kwantoren, en ongefundeerde vragen + 'scherper'-suggestie.
\- `notitie` / `commissienotitie` / `fractienotitie` — sanity-review (maximaal 10 opmerkingen): ontbrekend voor/tegen-eindoordeel, strategische opstelling, bronnen zonder paginanummer, ontbrekende samenvatting/vragen/bolletjes en suggestieve vragen — gegroepeerd op ernst (hoog/midden/laag).
\- `spreektekst` — rubriek met cijfer (1-10) + deelscores + verbeterpunten + duur-vs-spreektijd (opening, standpunt, onderbouwing, weerlegging, oproep, lengte ~130 wpm).
\- RvO-format check: `motie` | `motie_vreemd` | `amendement` | `schriftelijke_vragen` | `mondelinge_vragen` | `initiatiefvoorstel` | `interpellatieverzoek` — valideert structuur + RvO-regels (ontbrekend dictum, geen raadsvoorstel-ref bij amendement, gesloten vragen bij schriftelijke vragen, etc.). Gebruik dit na `genereer_raadsstuk` of op een handgeschreven concept.

Gebruik wanneer: het raadslid een concept heeft geschreven en wil weten wat scherper kan. NIET om corpus te doorzoeken → `zoek_raadshistorie`.

Retourneert: markdown met concrete verbeterpunten passend bij `soort`, gegroepeerd op ernst.

\**Positie in de drafting-keten:** roep aan ná `genereer_raadsstuk`; verwerk de bevindingen in het concept en sla daarna op met `sla_fractie_artifact_op(artifact_type=<doc_type>)`.

Input parameters:

- `soort` (string)
- `spreektijd_sec` (integer)
- `tekst` (string, required)

### `verzamel_context` (~1829 tokens)

Bundelt server-side meerdere achtergrondbronnen voor een onderwerp in één antwoord, zodat je niet meerdere losse tools hoeft te ketenen. Alleen de via parameters gevraagde bronnen worden opgehaald (opt-in), zodat de call snel blijft. Beschikbare bronnen:
\- **CBS-achtergrond** (publieke StatLine open data, geen credentials): geef `cbs_beleidsgebied` (bv. 'wonen', 'inkomen', 'criminaliteit') voor EXACTE, geciteerde cijfers uit de gecureerde nationale-contextlaag (cache-first, WS85/ADR-0037; nooit vector-embedded) voor `cbs_gemeente` (default GM0599). Of geef `cbs_zoekterm` / `cbs_tabel_id` (+ optioneel `cbs_perioden` + `cbs_extra_filters` + `cbs_top`) voor ad-hoc live StatLine-zoek. Voor aggregerende Iv3-tabellen (84413NED rekeningen, 83641NED begrotingen — grootteklasse-niveau, NIET per gemeente) gebruik `cbs_extra_filters` (bv. {"RegioS": "LD03"}) en verhoog `cbs_top` (default 100). LET OP: CBS StatLine biedt jeugd-lasten UITSLUITEND op grootteklasse-niveau, NIET per gemeente; gebruik `iv3_kerncijfers_gemeenten` voor per-gemeente totale lasten (niet taakveld-specifiek). Netwerk-call.
\- **CBS afgeleide cijfers** (metrics-laag, WS85b): geef `cbs_metric` (bv. 'woningvoorraad_per_1000_inw') voor een BEREKEND cijfer (per-1.000 / Δ-t.o.v.-vorig-jaar / verhouding) mét bronherkomst; optioneel `cbs_compare_regions` (tussen regio's) OF `cbs_compare_periodes` (over de tijd) — precies één van beide — met vergelijkbaarheidswaarborg, OF `cbs_rollup_region` (bv. 'NL01') om op te rollen van leden naar ouder-niveau (anti-Simpson, dekkingsvlag).
\- **CBS cube-engine** (WS90/ADR-0054, vrije slice-and-dice): voor een vraag die NIET op een vaste `cbs_metric` past, geef eerst `cube_describe` (tabel-id/onderwerp) → krijg de maten met hun aggregation_type + toegestane ops + dimensieleden; geef daarna `cube_query` (een {table_id|topic, measures, filters, op, region, + max één vergelijkings-as}-dict). De engine compileert deterministisch en WEIGERT illegale ops ('je kunt geen gemiddelde midd…

Input parameters:

- `cbs_beleidsgebied` (string)
- `cbs_compare_periodes` (array)
- `cbs_compare_regions` (array)
- `cbs_extra_filters` (object)
- `cbs_gemeente` (string)
- `cbs_metric` (string)
- `cbs_perioden` (string)
- `cbs_rollup_region` (string)
- `cbs_tabel_id` (string)
- `cbs_top` (integer)
- `cbs_zoekterm` (string)
- `cube_describe` (string)
- `cube_query` (object)
- `instrument_doel` (string)
- `instrument_op_agenda` (boolean)
- `instrument_urgentie` (string)
- `iv3_jaar` (integer)
- `iv3_kerncijfers_gemeenten` (array)
- `iv3_taakvelden` (array)
- `iv3_verslagsoort` (string)
- `onderwerp` (string, required)
- `rivm_gezondheid` (string)

### `genereer_fractienotitie` (~420 tokens)

Stelt de fractienotitie samen (Erik's hero-feature, WS23-core): een agenda-overzicht voor de komende ~2 weken op de portefeuille van de gebruiker, met bolletjes (🟢 positief / 🟠 spannend / 🟡 aandacht / ⚪ procedureel) en per agendapunt een detailblok waarvan de diepgang USER-RELATIEF is (diepgaand als het onderwerp in de portefeuille valt; beknopt binnen de commissie; bronnen als de gebruiker het debat zelf aanvroeg; vlucht daarbuiten; procedurele punten worden overgeslagen). De host-LLM levert uitsluitend `meeting_ids` uit `lijst_vergaderingen`; de tool haalt de gestructureerde vergadering en agenda zelf op. Zo hoeft de host geen markdown terug naar een ongedocumenteerd object te vertalen. Een onbekend ID, een vergadering zonder agenda of een vergadering buiten de horizon geeft een expliciete validatiefout, nooit een plausibel lege notitie. Automatische e-mailbezorging + de vrijdag/maandag-cron zijn aparte infrastructuur.

\**Positie in de keten:** roep eerst `mijn_fractie_context` aan en neem daaruit de gebruikersnaam en fractienaam over. Vul `covered_topics` en `followed_committees` met bevestigde waarden of lege lijsten; verzin ze niet. Gebruik daarna `lijst_vergaderingen(na_datum=<vandaag>, voor_datum=<horizon>, sortering='oudste_eerst')` en geef de gekozen `vergadering_id`-waarden door als `meeting_ids`.

Gebruik wanneer: de gebruiker een fractienotitie/voorbereiding voor de komende vergaderingen wil.

Retourneert: markdown — bolletjes-legenda + agenda-overzicht + per-vergadering detailblok op maat.

Input parameters:

- `gebruiker` (required)
- `horizon_dagen` (integer)
- `meeting_ids` (array, required)
- `vandaag` (string)

### `formatteer_bronvermelding` (~297 tokens)

Formatteert een bronvermelding zoals Erik die wil: mét paginanummer (en, indien bekend, alinea) — bijv. '(Begroting 2025, 12-10-2024, p. 41, alinea 3)'. Met `spreker` + `quote` levert de tool de volledige citaat-attributie in huisstijl: 'Volgens {spreker} ({partij}): _"..."_ (bron, p. ..)'. Velden die ontbreken worden netjes weggelaten (nooit 'p. None'). Geen DB, geen netwerk.

Let op: paginanummers vereisen dat de paginametadata in het bronfragment aanwezig is (aanwezig bij sommige bronnen, afwezig bij andere — de tool degradeert netjes). Zin-/alinea-precisie op corpusniveau is aparte ontologie (WS30); deze tool is de formatteerlaag.

Gebruik wanneer: je een quote of bron netjes wilt vermelden met paginanummer/alinea.

Retourneert: de bronvermelding/citaat-string (markdown).

Input parameters:

- `alinea` (integer)
- `bron` (string, required)
- `datum` (string)
- `document_id` (string)
- `pagina` (string)
- `partij` (string)
- `quote` (string)
- `spreker` (string)

### `genereer_raadsstuk` (~454 tokens)

Genereert een volledig opgemaakt, RvO-conformant concept voor één van de zeven raadsstuk­typen. Geen DB, geen netwerk, <10ms — puur structurele kennis.

Gebruik deze tool wanneer:
\- Het raadslid een stuk wil indienen en een correct gestructureerd concept nodig heeft.
\- Je `adviseer_raadsinstrument` hebt gebruikt (welk instrument) en nu het daadwerkelijke stuk wilt renderen in het juiste format met RvO-verwijzingen.
\- Een concept al bestaat maar opnieuw in correct format moet worden gezet.

Gebruik deze tool NIET wanneer:
\- Je het juiste instrument nog moet kiezen → gebruik eerst `adviseer_raadsinstrument`.
\- Je een bestaand concept wilt beoordelen op inhoud → `beoordeel_tekst`.
\- Je een format-validatie wil uitvoeren op een bestaand concept → `beoordeel_tekst` met `soort` gelijk aan het doc_type.

\``doc_type`` keuzes: 'motie', 'motie_vreemd', 'amendement', 'schriftelijke_vragen', 'mondelinge_vragen', 'initiatiefvoorstel', 'interpellatieverzoek'.

\``velden`` zijn optioneel — ontbrekende velden worden vervangen door invul-placeholders [zoals dit] zodat het concept altijd een compleet, geldig skelet is.

\``gemeente`` bepaalt welk lokaal RvO-overlay (artikel­nummers, termijnen, indienings­route) wordt gebruikt. Default 'rotterdam'. Degradeert netjes naar het canonieke basis­format + disclaimer als er geen overlay beschikbaar is.

Retourneert: markdown-concept in de juiste RvO-structuur, met RvO-artikel­citaat en disclaimer.

\**Volgende stap in de drafting-keten:** valideer het gegenereerde concept met `beoordeel_tekst(tekst=<concept>, soort=<doc_type>)` voordat je het presenteert of opslaat; sla daarna op met `sla_fractie_artifact_op(artifact_type=<doc_type>)`.

Input parameters:

- `doc_type` (string, required)
- `gemeente` (string)
- `velden` (object)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/neodemoshq-neodemos/public-mcp#diagnostics

## Score history

- 2026-09-21: 86
- 2026-09-20: 86
- 2026-09-19: 86
- 2026-09-18: 86
- 2026-09-17: 86
- 2026-09-16: 86
- 2026-09-15: 86
- 2026-09-14: 86
- 2026-09-13: 86
- 2026-09-12: 86
- 2026-09-11: 86
- 2026-09-10: 86
- 2026-09-09: 79
- 2026-09-08: 78
- 2026-09-07: 78
- 2026-09-06: 77
- 2026-09-05: 77
- 2026-09-04: 76
- 2026-09-03: 76
- 2026-09-02: 75
- 2026-09-01: 75
- 2026-08-31: 75
- 2026-08-30: 74
- 2026-08-29: 74
- 2026-08-28: 73
- 2026-08-27: 73
- 2026-08-26: 72
- 2026-08-25: 70
- 2026-08-24: 70
- 2026-08-23: 69

## Common questions

### What is the NeoDemos MCP server?

NeoDemos is an MCP server listed in the public MCP registry as io.github.NeoDemosHQ/neodemos. Source-anchored search and civic intelligence for Dutch municipal council records. This page covers its hosted endpoint (https://mcp.neodemos.nl/public/mcp).

### Is the NeoDemos MCP server safe to use?

NeoDemos scores 86 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the NeoDemos MCP server expose?

NeoDemos exposes 7 tools: get_neodemos_context, adviseer_raadsinstrument, beoordeel_tekst, verzamel_context, genereer_fractienotitie, and 2 more. Their descriptions and schemas cost roughly 4,264 tokens of context every time the server is loaded.

### Does the NeoDemos MCP server require authentication?

No. We connected to NeoDemos without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the NeoDemos MCP server still maintained?

NeoDemos is still listed as active in the MCP registry. We last reached this channel on 21 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://mcp.neodemos.nl/public/mcp
- Website: https://neodemos.nl/
- Changelog RSS feed: https://verifymcp.io/servers/neodemoshq-neodemos/public-mcp.xml
- Changelog JSON feed: https://verifymcp.io/servers/neodemoshq-neodemos/public-mcp.json
- HTML version of this page: https://verifymcp.io/servers/neodemoshq-neodemos/public-mcp
