# karelrocks
> De website van De Karel Foundation presenteert een historisch treinstel dat door een toegewijd team van vrijwilligers wordt onderhouden en geëxploiteerd. De stichting zet zich in voor het behoud van industrieel erfgoed en gebruikt de trein voor charitatieve ritten, waarvan de opbrengsten naar KWF Kankerbestrijding gaan. Bezoekers kunnen op de site informatie vinden over het boeken van het treinstel voor evenementen, maatwerk catering, en de fiscale voordelen van donaties dankzij de ANBI-status. De site belicht ook de technische specificaties van de trein, de vrijwilligers achter het project en de mogelijkheid om merchandise te kopen ter ondersteuning van het goede doel.

## Toegang voor AI-agents

Deze website wordt aangedreven door Wix en ondersteunt het Model Context Protocol (MCP)
voor agentische AI-toegang. AI-agents kunnen direct verbinding maken om live,
actuele website-inhoud op te halen - geen scraping nodig.

- **Site MCP Endpoint:** https://www.karel.rocks/_api/mcp
- **Wix MCP-documenten:** https://dev.wix.com/docs/develop-websites/articles/get-started/about-the-wix-site-mcp

## Beschikbare MCP-tools

###GetBusinessDetails
Haalt bedrijfs- en websitegegevens op, zoals tijdzone, e-mail, telefoon en adres.

- Geen parameters vereist.
### SearchInSite
Doorzoekt de website naar informatie.
- \`searchTerm\` - De zoekterm voor de website.

### SearchSiteApiDocs
Haalt de API-documentatie op voor de Wix-bedrijfsoplossingen die op zijn geïnstalleerd
deze website, en informeert de AI-client over hoe de API's te gebruiken. Gebruik deze tool voor
het opvragen van producten en diensten (in plaats van SearchInSite).- \`searchTerm\` — De term om op te zoeken in de website API-documentatie.
### GenerateVisitorToken
Maakt een nieuwe bezoekerssessie aan en verkrijgt een bezoekers-toegangstoken voor de website.
Moet worden aangeroepen voordat een CallWixSiteAPI-aanvraag wordt gedaan als er nog geen bezoekers-token beschikbaar is in context.
- Geen parameters vereist.
### CallWixSiteAPI
Roept API-methoden op de website aan om acties uit te voeren namens een bezoeker,
zoals het opvragen van website-data, het boeken van een afspraak of het starten van een aankoop.

- \'visitorToken\' - Token voor bezoekerstoegang. Gebruik eerst GenerateVisitorToken als dat niet beschikbaar is.
- \`url\` — Absolute URL van de API-methode om aan te roepen (bijv.
 https://www.wixapis.com/...). Haal op met SearchSiteApiDocs.
- \'method\' - HTTP-methode om te gebruiken voor de API-aanroep.
- \'body\' - Verzoek body als een geldige JSON-string.

### ReadFullDocsArticle
Haalt een volledig artikel op van het Wix developer-documentatieportaal.
- \'articleUrl\' - de URL van een artikel in het Wix developer-documentatieportaal.

### ReadFullDocsMethodSchema
Haalt het volledige schema op voor een Wix API-methode. - Moet worden aangeroepen voordat de eigenlijke methode via CallWixSiteAPI wordt aangeroepen.- \`articleUrl\` - URL van het referentieartikel voor de Wix API-methode.

## Wat bezoekers kunnen doen via AI + MCP

- Bedrijfsgegevens verkrijgen (contactgegevens, locatie, openingstijden)
- Producten en diensten ontdekken die worden aangeboden
- Diensten boeken en reserveringen maken
- Een aankoop starten en worden doorverwezen naar de website om de betaling te voltooien
- Vragen stellen en relevante antwoorden krijgen zonder de website te hoeven bekijken

## Opmerkingen

- Geen authenticatie vereist om verbinding te maken met het MCP-endpoint
- Alleen openbare informatie die op de website toegankelijk is, is beschikbaar
- De inhoud is altijd live en up-to-date
- Om toolupdates te ontvangen, implementeer je een tools/lijst-aanroep na ontvangst van een toolupdate-melding