De MCP-server van Theorie Rijbewijs

De server

Adres: https://theorie-rijbewijs.nl/mcp. Transport Streamable HTTP, JSON-antwoorden, zonder authenticatie of sessie; een SSE-stroom is niet nodig. Protocolversies: 2026-07-28, 2025-11-25, 2025-06-18 en 2025-03-26.

De tools

• search: {"query": "maximumsnelheid"} geeft maximaal 20 documenten {id, title, url} terug.
• fetch: {"id": "…"}, met de id die search teruggeeft, geeft {id, title, text, url, metadata} terug: de aard van het document, de bronnen, de data (verified_at voor een controle, modified_at voor een wijziging van de publicatie) en bij een les het hoofdstuk, de afbeelding en de video.

De headers

Stuur Content-Type: application/json en Accept: application/json, text/event-stream mee. In 2025: initialize, daarna notifications/initialized, daarna tools/list en tools/call, met de header MCP-Protocol-Version na de onderhandeling. In 2026-07-28: server/discover, daarna tools/list en tools/call; elk verzoek draagt zijn versie in _meta en in de headers MCP-Protocol-Version, Mcp-Method en, bij een tool, Mcp-Name. Een externe browser gebruikt de REST-API: de MCP-route controleert de origins. Controleer altijd JSON-RPC-fouten en isError, ook bij een HTTP 200-antwoord.

Voorbeelden om te kopiëren

Zoeken en daarna een document lezen met de MCP-SDK

Met Node.js 20 of nieuwer: installeer npm install @modelcontextprotocol/sdk@1.30.0 en sla deze code op in een .mjs-bestand. De SDK regelt de initialisatie en de headers van het protocol. Het lezen gebruikt de identifier die de zoekopdracht echt heeft teruggegeven. Bewaar het veld url als zichtbare bronvermelding in je interface.

import { Client } from '@modelcontextprotocol/sdk/client/index.js';
import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';

const client = new Client({ name: 'exemple-site', version: '1.0.0' }, { capabilities: {} });
const transport = new StreamableHTTPClientTransport(new URL('https://theorie-rijbewijs.nl/mcp'));

function readTool(result) {
  if (result.isError) throw new Error('De MCP-tool kon het verzoek niet verwerken.');
  if (result.structuredContent) return result.structuredContent;
  const content = result.content?.find(item => item.type === 'text');
  if (!content) throw new Error('MCP-antwoord zonder inhoud.');
  return JSON.parse(content.text);
}

try {
  await client.connect(transport);
  const available = await client.listTools();
  if (!['search', 'fetch'].every(name => available.tools.some(tool => tool.name === name))) {
    throw new Error('De verwachte tools zijn niet beschikbaar.');
  }
  const search = readTool(await client.callTool({
    name: 'search', arguments: { query: 'theorie-examen' }
  }));
  if (!search.results.length) {
    console.log('Geen document gevonden.');
  } else {
    const record = readTool(await client.callTool({
      name: 'fetch', arguments: { id: search.results[0].id }
    }));
    console.log(JSON.stringify(record, null, 2));
  }
} finally {
  await client.close();
}

De actuele versie van een gegeven terugvinden

De API en de MCP-server geven toegang tot de openbare publicaties van Theorie Rijbewijs. De documenten volgen de updates van de site, met een link naar de oorspronkelijke pagina en de bijbehorende bronnen.

Lees voordat je antwoordt of je tool bijwerkt de relevante documenten opnieuw: je vindt hun online versie, hun bronnen en hun data. Een officiële regel kan veranderen: de controledatum zegt wanneer de regel voor het laatst in de wettekst is nagelezen.

Hergebruiken met bronvermelding

De openbare inhoud van Theorie Rijbewijs mag worden bekeken, geciteerd en samengevat om een antwoord te onderbouwen of een tool te bouwen, ook voor commercieel gebruik, met zichtbare bronvermelding en een link naar de gebruikte pagina: ‘Bron: Theorie Rijbewijs’.

Bewaar de bronnen en de voorbehouden die bij de informatie horen. Vermeld welke aanpassingen je hebt gedaan en maak onderscheid tussen de officiële regels en de uitleg, de methode en het aanbod van Theorie Rijbewijs.

Documenten en beeldmateriaal van derden vallen onder hun eigen voorwaarden. Wil je een cursus of artikel volledig opnieuw publiceren, vraag dan toestemming via contact@theorie-rijbewijs.nl. Toegang tot de gegevens betekent niet dat Theorie Rijbewijs of Permis Online SRL met jou samenwerkt of jouw dienst goedkeurt.