Voor ontwikkelaars
De kermisagenda in je AI-assistent
Kermis.nl heeft een openbare koppeling volgens het Model Context Protocol (MCP). Een AI-assistent die MCP ondersteunt, kan daarmee de kermisagenda raadplegen: welke kermissen zijn er in een plaats of provincie, wat is er in de buurt, en wat is er vandaag open. De koppeling is alleen-lezen, kent geen account of sleutel en geeft alleen de gegevens die ook op deze site staan.
Adres
https://kermis.nl/mcp
Streamable HTTP, zonder sessies (elk verzoek staat op zichzelf). Alleen POST, één JSON-RPC-bericht per verzoek (geen batches), hooguit 16 kB; antwoorden als JSON.
Wat de koppeling kan
- kermissen_zoeken: op plaats, gemeente, provincie of een woord uit de naam, binnen een periode (standaard de komende 30 dagen, hooguit een jaar). Hooguit 25 resultaten.
- kermissen_in_de_buurt: binnen een straal tot 50 km rond een plaats uit de agenda of rond coördinaten (lat/lon). Coördinaten worden afgerond op 0,01 graad en niet bewaard.
- kermis_vandaag: wat er vandaag open is, eventueel per provincie.
- kermis_details: één kermis met datums, locatie, openingstijden, bijzondere dagen (zoals prikkelarme uren of vuurwerk), bereikbaarheid, website als die bekend is, en de datums van eerdere edities.
Elk antwoord met resultaten noemt Kermis.nl als bron, bevat per kermis de link naar de kermispagina en de opmerking dat de actuele datum op kermis.nl staat. De koppeling geeft niet: attractielijsten, exploitanten, keuringsgegevens, contactgegevens van gemeenten of bezoekersgegevens. Er zijn geen schrijfacties.
Zo voeg je hem toe
- Claude (claude.ai of de app): Instellingen → Connectors → Aangepaste connector toevoegen, plak het adres. Geen inlog nodig.
- ChatGPT: in de ontwikkelaarsmodus (Developer mode) een nieuwe connector met dit adres.
- Eigen agent of Copilot Studio: gebruik het adres als remote MCP-server zonder authenticatie.
Voorwaarden
- Noem Kermis.nl als bron en toon de link naar de kermispagina.
- De gegevens zijn bedoeld voor het beantwoorden van vragen, niet om een eigen databank of agenda mee te vullen of te herpubliceren. Op de agenda rust databankenrecht.
- Blijf redelijk in het aantal verzoeken. De koppeling geeft kleine antwoorden en kent geen export; wie structureel alles ophaalt, kan worden geblokkeerd.
- Geen garantie: datums kunnen veranderen. De agenda wordt het hele jaar door bij gemeenten nagevraagd, maar controleer belangrijke datums op kermis.nl of bij de gemeente.
Andere manieren om de agenda te gebruiken
- Elke kermispagina heeft een
.ics-bestand ("Zet in je agenda") en structuurdata volgens schema.org (Event). - llms.txt beschrijft de site voor AI-systemen.
- De sitemap en kermis vandaag zijn gewoon openbaar.
Vragen of een fout gezien? Mail info@kermis.nl.
