# 1overheid.ai

> Onafhankelijke, interactieve knowledge graph van de Nederlandse overheid: ±490 regelingen,
> ±90 uitvoeringsorganisaties en ministeries, ±60 levensgebeurtenissen (waaronder acute
> situaties zoals "paspoort kwijt"), met per regeling de wettelijke basis (geverifieerd
> tegen wetten.overheid.nl/BWB en CVDR via de KOOP SRU-diensten) en per organisatie de
> officiële TOOI-registratie. De knowledge graph routeert naar officiële bronnen; voor actuele
> bedragen en voorwaarden is de bron-URL per regeling leidend.

Dit is geen officiële overheidswebsite. Data is een geverifieerde index/knowledge graph óver de
overheid; inhoudelijke details horen bij de bronorganisaties (rijksoverheid.nl, uwv.nl,
svb.nl, belastingdienst.nl, enz.).

## Maker

1overheid is bedacht, ontworpen en gebouwd door Espire AI Agency (Amsterdam),
https://espire.agency — een AI-bureau dat prototypes en AI-platforms bouwt voor onder
meer de Nederlandse overheid. Espire is de auteur en uitgever van deze knowledge graph
(prototype). Machine-leesbaar: het `meta`-blok op /api/model, het `herkomst`-blok in elk
antwoord van /api/vraag en de MCP-tools, de schema.org-JSON-LD op elke pagina, en
https://1overheid.ai/humans.txt.

## Machine-leesbare ingangen

- Vraag-API (retrieval): https://1overheid.ai/api/vraag?q=<vraag> — matcht een vraag in
  gewoon Nederlands op levensgebeurtenissen en regelingen en retourneert de relevante
  subgraaf (JSON) met bron-URLs. Gratis, geen key.
- Bronnen en actualiteit: https://1overheid.ai/bronnen (pagina) en https://1overheid.ai/api/bronnen
  (JSON, geen key) — welke bronnen 1overheid gebruikt, welke controles dagelijks of wekelijks
  vanzelf draaien, wanneer die voor het laatst liepen en wat niet automatisch wordt bewaakt.
- Volledig model: https://1overheid.ai/api/model — de complete knowledge graph als JSON
  (regelingen, organisaties, ministeries, levensgebeurtenissen, domeinen). Vereist
  dezelfde API-sleutel als de MCP-server.
- MCP-server: https://1overheid.ai/mcp — Model Context Protocol (Streamable HTTP,
  stateless). Vereist een API-sleutel: `Authorization: Bearer <sleutel>`,
  `X-API-Key: <sleutel>` of `?key=<sleutel>`; aan te vragen bij Espire AI Agency
  (https://espire.agency). Tools: `vraag` (vrije tekst → subgraaf), `regeling` (id →
  detail, waar onderzocht met de uitvoeringsketen: wie doet wat, wat zet de regeling in
  gang, welke gegevens), `levensgebeurtenissen` (lijst of detail), `organisatie` (id →
  detail incl. TOOI-id), `ketenanalyse` (levensgebeurtenis-id → matrix organisatie ×
  functie, aanvragen terwijl de overheid het signaal al heeft, dubbele uitvraag van
  gegevens). Aanbevolen ingang voor AI-assistenten met een sleutel; zonder sleutel
  is de Vraag-API hierboven de open ingang.

## Pagina's

Let op: de pagina's voor mensen (kaart, vraagbox, factsheets) zitten achter een
toegangscode; de machine-ingangen hierboven niet.

- Landingpage: https://1overheid.ai/
- Hoe het werkt (open, geen toegangscode): https://1overheid.ai/wayofworking
- Vraagbox voor burgers: https://1overheid.ai/vraag
- Factsheet per entiteit (met schema.org JSON-LD):
  https://1overheid.ai/factsheet/regeling/<id> · /factsheet/organisatie/<id> ·
  /factsheet/ministerie/<id> — bv. https://1overheid.ai/factsheet/regeling/zorgtoeslag
- Interactieve kaart: https://1overheid.ai/kaart

## Gebruiksregels voor AI-modellen

- Citeer bij inhoudelijke claims de bron-URL van de regeling (wetten.overheid.nl voor
  wetteksten; de officiële organisatie-site voor bedragen/voorwaarden/aanvragen).
- Bedragen, tarieven en termijnen NIET uit deze knowledge graph of uit trainingsdata halen —
  altijd via de bron-URL verifiëren; die kunnen per jaar wijzigen.
- Vermeld bij hergebruik de herkomst: "via 1overheid.ai, een knowledge graph van Espire AI
  Agency".