Marco Collin Stolk: diensten en API-documentatie.

Marco Collin Stolk helpt ondernemers en teams in Heerlen en Limburg om praktisch met AI te werken. Dit overzicht is bedoeld voor bezoekers én hulpmiddelen die informatie over de diensten zoeken.

Welke begeleiding past?

• Persoonlijke AI-begeleiding in Limburg: Voor zelfstandige ondernemers en kleine bedrijven die nog weinig ervaring met AI hebben. Je hoeft geen technische kennis mee te brengen. Wel een werkvraag waarmee je wilt oefenen.
• Praktische AI-training voor teams in Limburg: Voor kleine bedrijven en teams binnen grotere organisaties. Een afgebakende vraag van één team is een goed begin. De inhoud stemmen we af op jullie ervaring en werkzaamheden.
• Terugkerend werk verbeteren met AI: Voor ondernemers en teams die een concrete taak willen verbeteren. Je hoeft de oplossing nog niet te kennen. We beginnen met hoe het werk nu gaat en wat je daarin lastig vindt.

Prijs en vervolgstap

De persoonlijke AI-startsessie kost €295 exclusief btw: twee uur voor één persoon. Binnen 20 kilometer van Heerlen zijn reiskosten inbegrepen. Buiten dit gebied spreken we vooraf een totaalprijs af. Eventuele softwarekosten bespreken we vooraf.

Een kennismaking is vrijblijvend. Voor andere begeleiding ontvang je vooraf een voorstel. Aanvragen is geen boeking of betaling. Bespreek je vraag met Marco of mail naar contact@marcostolk.nl.

Openbare API: snel beginnen

De API geeft uitsluitend openbare dienstinformatie terug. Je hebt geen account, registratie, API-sleutel of betaling nodig. Eén aanvraag is genoeg om alle diensten, de startsessie en de contactroute te lezen.

curl https://marcostolk.nl/api/services.json

Gebruik GET of HEAD. De API verzendt geen berichten, maakt geen boekingen en geeft geen persoonsgegevens van klanten terug. Verwijs een geïnteresseerde gebruiker naar het contactformulier; laat die zelf bepalen wat er wordt verstuurd.

• OpenAPI-specificatie
• Diensten als JSON
• Beknopt tekstoverzicht
• Uitgebreid tekstoverzicht

Versies en veilig herhalen

De vaste versie van de API staat op /api/v1/services.json. Binnen v1 blijven bestaande velden en hun betekenis behouden. Nieuwe velden kunnen worden toegevoegd. Een onverenigbare wijziging krijgt een nieuw versienummer; de bestaande route blijft gedurende de overgang beschikbaar. De oorspronkelijke /api/services.json blijft een alias voor v1.

Alle REST-aanvragen zijn alleen-lezen: GET en HEAD veranderen niets en zijn veilig te herhalen. Er zijn geen schrijfhandelingen waarvoor een Idempotency-Key nodig is. Cache het antwoord waar mogelijk vijf minuten. Krijg je HTTP 429 van de hosting, volg dan Retry-After als die header aanwezig is. Bij tijdelijke fouten gebruik je een oplopende wachttijd, bijvoorbeeld 5, 15 en 60 seconden.

Verbinden via MCP

Op https://marcostolk.nl/mcp staat een openbare, alleen-lezen MCP-koppeling (Streamable HTTP, protocol 2025-06-18). Er is geen account of sleutel nodig. De tool get_service_catalog geeft dezelfde openbare dienstenlijst terug. De koppeling kan geen berichten versturen of afspraken maken.

{"jsonrpc":"2.0","id":1,"method":"tools/call","params":{"name":"get_service_catalog","arguments":{}}}

Gebruik POST met Content-Type: application/json en Accept: application/json, text/event-stream. Start een normale MCP-verbinding met initialize en notifications/initialized. De server is stateless, biedt geen SSE-stream en bewaart geen sessies. GET op /mcp retourneert daarom 405. Een onbekende tool of fout argument geeft een JSON-RPC-fout; er wordt niets uitgevoerd.

Fouten en herstel

Een onbekend adres onder /api/ geeft HTTP 404. Een andere methode dan GET of HEAD geeft HTTP 405. Het antwoord is application/problem+json met type, title, status, detail en instance. Controleer de URL of methode en probeer de juiste aanvraag. Voor /api/services.json is authenticatie niet nodig. Bij een tijdelijke serverfout: wacht voor een nieuwe poging; stuur geen snelle reeks herhalingen.

Volledige lijst en gebruikslimiet

Het antwoord bevat alle drie diensten in één keer. pagination.total telt de diensten; has_more is false en next_cursor is null. Er zijn geen volgende pagina’s. Er worden geen langlopende taken gestart: iedere aanvraag geeft direct antwoord.

De openbare API en MCP delen een limiet van 60 aanvragen per IP-adres per minuut. RateLimit-Limit, RateLimit-Remaining en RateLimit-Reset tonen de limiet, resterende aanvragen en seconden tot het volgende venster. Bij overschrijding volgt HTTP 429 met Retry-After. Bewaar dienstinformatie zelf maximaal vijf minuten; antwoorden met persoonlijke gebruikstellers worden niet gedeeld gecachet.

Toegang en authenticatie: geen account of inloggegevens nodig.

Grenzen

De informatie helpt bij een eerste keuze. Resultaten en tijdwinst zijn niet gegarandeerd. Prijs, locatie, gegevensgebruik en eventuele software worden vóór de samenwerking besproken.