---
title: "MCP-endpoint"
method: POST
path: "/mcp"
tags: ["Agents"]
---

# MCP-endpoint

`POST /mcp`

## Request

- Base URL: `https://www.citeerbaar.nl`
- URL: `https://www.citeerbaar.nl/mcp`
- Auth: none declared

Model Context Protocol over HTTP, één JSON-RPC-bericht per verzoek. Versies tot en met 2025-11-25: initialize, dan de notificatie notifications/initialized (zonder id, antwoord 202 zonder body), dan tools/list. Versie 2026-07-28: geen handshake; stuur tools/list of tools/call direct met de headers MCP-Protocol-Version: 2026-07-28 en Mcp-Method gelijk aan de methode in de body (bijv. Mcp-Method: tools/list), plus dezelfde versie in params._meta["io.modelcontextprotocol/protocolVersion"]. Bij tools/call, resources/read en prompts/get ook Mcp-Name: de toolnaam (of uri). Ontbreekt of verschilt Mcp-Method of Mcp-Name, dan 400 met code -32020. Optioneel eerst server/discover. Elf tools; alleen request_quick_check schrijft (5 per uur per IP). Protocolversies: 2026-07-28, 2025-11-25, 2025-06-18, 2025-03-26.

## Headers

- `MCP-Protocol-Version` string
- `Mcp-Method` string
- `Mcp-Name` string

## Request body

- object
  - `jsonrpc` '2.0', required
  - `id` union: Weglaten bij een notificatie. Een ander type geeft -32600 met id null.
    - string
    - integer
  - `method` 'initialize' | 'notifications/initialized' | 'server/discover' | 'ping' | 'tools/list' | 'tools/call' | 'resources/list' | 'resources/read' | 'prompts/list', required
  - `params` object

## Response `200`

JSON-RPC-antwoord: result bij succes, error bij een fout op protocolniveau (ook bij een onbekende methode). error.message is Engels, error.data.message_nl Nederlands.

- JsonRpcResponse
  - `jsonrpc` '2.0', required
  - `id` union, required
    - string
    - integer
  - `result` object
  - `error` object
    - `code` integer, required
    - `message` string, required: Engels.
    - `data` object
      - `message_nl` string

## Other responses

- `202`: Notificatie ontvangen (bericht zonder id, bijv. notifications/initialized). Lege body.
- `400`: Geen geldige JSON (-32700, id null), geldige JSON die geen object is (-32600, id null), een batch of een ongeldige envelop (-32600: jsonrpc niet "2.0", id geen string of geheel getal, method ontbreekt), of een ontbrekend verplicht veld.
- `405`: Alleen POST.
- `429`: Limiet: 60 verzoeken per 60 seconden per IP. Retry-After en RateLimit-* zeggen wanneer het weer kan.

---

[API](https://skmtc.dev/citeerbaar/apis/citeerbaar-open-data-en-agent-laag.md) · [All operations](https://skmtc.dev/citeerbaar/apis/citeerbaar-open-data-en-agent-laag/llms.txt) · [OpenAPI document](https://skmtc.dev/citeerbaar/apis/citeerbaar-open-data-en-agent-laag/revisions/565b296eeecf?raw)