Back to Browse

HeyJoost MCP Server

by MoAz06
Developer ToolsLow Risk10.0MCP RegistryRemote
Free

Server data from the Official MCP Registry

Live Dutch open data for AI assistants: transport, weather, water, traffic, housing, government.

About

Live Dutch open data for AI assistants: transport, weather, water, traffic, housing, government.

Remote endpoints: streamable-http: https://heyjoost.nl/mcp

Security Report

10.0
Low Risk10.0Low Risk

Valid MCP server (1 strong, 1 medium validity signals). No known CVEs in dependencies. Imported from the Official MCP Registry.

20 tools verified · Open access · No issues found

Security scores are indicators to help you make informed decisions, not guarantees. Always review permissions before connecting any MCP server.

Permissions Found in Source Code

Found by scanning the linked source code. This listing connects to a hosted endpoint, so none of this runs on your machine: it describes what the server software does where it is hosted.

env_vars

Applies to the server that hosts this plugin, not to your machine.

HTTP Network Access

Connects to external APIs or services over the internet.

How to Connect

Remote Plugin

No local installation needed. Your AI client connects to the remote endpoint directly.

Add this to your MCP configuration to connect:

{
  "mcpServers": {
    "io-github-moaz06-heyjoost": {
      "url": "https://heyjoost.nl/mcp"
    }
  }
}

Documentation

View on GitHub

From the project's GitHub README.

Hey Joost

Actuele Nederlandse open data voor je AI-assistent (Claude, ChatGPT en andere MCP-clients). Te gebruiken via heyjoost.nl: voeg https://heyjoost.nl/mcp toe als connector, zonder installeren. Vraag gewoon "wordt het morgen droog in Utrecht?" of "wanneer is de herfstvakantie in regio zuid?" en je assistent haalt het antwoord live bij de officiële bron. Op de website kun je Joost ook direct iets vragen.

Wat kan het

ToolWat je krijgtBronKey nodig
huis_infoBouwjaar, oppervlakte, gebruiksdoel, wijk en buurt van een adres, plus het energielabel. Met postcode of met straat en plaatsBAG (Kadaster) via PDOK, EP-online (RVO)Alleen voor het energielabel
buurt_infoCijfers over een buurt, wijk of gemeente: inwoners en leeftijden, huishoudens, woningen met de gemiddelde WOZ-waarde en koop of huur, inkomen, energieverbruik en zonnepanelen, afstand tot huisarts, supermarkt en school, en auto's. Per onderdeel het jaar, met de gemeente en Nederland ernaast. Met een buurt, wijk, plaats, straat met plaats of postcode. Een gebied dat het CBS niet als één geheel telt, zoals de Bijlmer, Haren of Kralingen, geeft de wijken of buurten naast elkaarCBS Kerncijfers wijken en buurten, plaatsen via PDOKNee
schoolvakantiesSchoolvakanties per regio en schooljaarRijksoverheid open dataNee
reisadviesHet reisadvies van Buitenlandse Zaken voor een land: de kleurcode per gebied, wat er speelt, wanneer het advies voor het laatst veranderde en de link. Met een onderwerp de tekst daarover, zoals visum en paspoort, vaccinaties of wat je doet bij nood. Werkt ook met Mallorca, Bali of DubaiMinisterie van Buitenlandse Zaken via NederlandWereldwijdNee
regelzakenOfficiële antwoorden over regelzaken met de overheid, zoals toeslagen, AOW, kinderbijslag, paspoort, rijbewijs en huren, met de link. Met een gemeente ook wat je daar regelt, met de link en of het online kanVragen en antwoorden van Rijksoverheid.nl, producten van gemeenten uit de Samenwerkende Catalogi (KOOP)Nee
bekendmakingenOfficiële bekendmakingen rond een adres, straat of postcode, tot 500 meter en tot een half jaar terug: aangevraagde en verleende vergunningen (bouwen, bomen kappen, evenementen), meldingen en verkeersbesluiten, met de fase, de straat, de datum, de afstand en de link, en hoe bezwaar en zienswijze werken. Zoekt nooit op naam of tekst, en laat huisnummers, postcodes en bekendmakingen over personen wegOfficiële bekendmakingen via de SRU-zoekdienst van KOOP, adressen via PDOKNee
water_actueelActuele waterstand ten opzichte van NAP en watertemperatuur bij een plaatsRijkswaterstaat WaterinfoNee
water_verwachtingEb en vloed: hoog- en laagwater voor vandaag en morgen of een dag tot een jaar vooruit. Voor de komende twee dagen met de verwachting van Rijkswaterstaat (wind en rivieren meegerekend), met de getijtabel ernaast. Aan rivieren en meren zonder getij de verwachte waterstandRijkswaterstaat Waterinfo (WaterWebservices)Nee
weerHet weer nu, per uur voor de komende 24 uur en per dag voor de week: temperatuur, neerslag, wind in Beaufort en windstoten. Met een datum die dag per uur. Voor een plaats, wijk, station of postcode. Geldt er een KNMI-waarschuwing voor die plek, dan staat die erbijKNMI (HARMONIE-AROME) en ECMWF via Open-Meteo, waarschuwingen van het KNMINee (waarschuwingen: ja, KNMI)
regenRegen voor de komende twee uur per tien minuten, uit de neerslagradar, met een samenvatting zoals "droog tot 14:20, dan lichte regen"KNMI Data Platform (WMS)Ja (KNMI)
weerwaarschuwingenCode geel, oranje of rood: wat, waar, wanneer en wat je moet doen. Voor een plaats, een provincie of heel NederlandKNMI Data Platform (Open Data API)Ja (KNMI)
stroomprijsDe stroomprijs per kwartier voor nu, vandaag en morgen, of een dag tot een maand terug: kaal en met energiebelasting en btw, in cent per kWh, met de goedkoopste momenten (kwartier, uur, drie uur)Bundesnetzagentur (SMARD.de) via Energy-Charts, met SMARD zelf als reserveNee
trein_vertrekVertrektijden met vertraging, spoor en uitval, tot ongeveer een uur vooruitNS Reisinformatie APIJa (NS)
trein_aankomstAankomsttijden: waar de trein vandaan komt, vertraging en spoor. Handig als je iemand ophaaltNS Reisinformatie APIJa (NS)
trein_reisReisadvies met overstappen, drukte en prijs. De beste reis staat bovenaan: zo vroeg mogelijk aan met zo min mogelijk overstappen. Per overstap hoeveel minuten je hebt en of dat krap, genoeg of ruim is, en per trein hoe vaak hij onderweg stopt. Van en naar mag een station zijn, maar ook een plaats, adres of plek, zoals Radboudumc Nijmegen: dan neemt de tool het station in de buurt en rekent hij het lopen uit tot ongeveer 1,5 km, zodat de tijden van deur tot deur zijn. Ligt de plek verder weg, dan zegt hij dat dat stuk niet berekend is, en kiest hij een trein met speling voor bus of tram: 15 minuten plus 3 per km hemelsbreed. Met een aankomsttijd gaan het lopen of de speling en 5 minuten marge er vanzelf af. Een trein die nu vertrekt, staat erbij maar is niet de beste. Met laatste de laatste treinen van een dag, tot in de nacht, en de nachttreinen daarna. Met de toeslag voor Intercity direct en ICE, en reizen die niet gaan. Rijdt er een bus in plaats van de trein, dan staat het bericht van NS erbijNS Reisinformatie APIJa (NS)
trein_storingenStoringen en werkzaamheden op het spoor: wat, waar, wanneer, de bussen die dan rijden en het advies van NS. Nu en de komende drie dagen, of een periode tot 31 dagen. Voor heel Nederland of het spoor langs één stationNS Reisinformatie APIJa (NS)
ov_vertrekVertrektijden van bus, tram, metro en veerboot vanaf een halte, met live vertraging en uitval. Bij een treinstation alle haltes eromheen. Vanaf een adres, straat of plek zonder eigen halte (het LUMC, Ahoy) de drie dichtstbijzijnde haltes, met de afstand. Met naar alleen de ritten die bij een bepaalde halte stoppen, met de aankomsttijd daar, ook vanaf de haltes om de hoek als je die lopend nog haalt. Bij een plek als het Erasmus MC tellen ook de haltes eromheen, met de afstand, en met naar (ook naar een plek zonder eigen halte of een adres) hoe lang je daarna nog loopt en hoe laat je er bent, en als de plek op loopafstand ligt hoe lang lopen duurt, zonder ritten die er later zijn dan lopend. Bij een staking in het streekvervoer het bericht van NS erbijData van de vervoerders via OpenOV, opgehaald via Transitous. Stakingsberichten van NSNee
reis_plannenStaat uit tot Transitous akkoord is (HEYJOOST_REISPLANNER, zie API-keys). Van deur tot deur met het ov: lopen, bus, tram, metro, trein en veerboot, vanaf een adres, straat, station, halte of plaats, met de beste drie reizen, per deel de lijn, waar je in- en uitstapt en hoe lang je loopt. Ook met een aankomsttijdReisplanner van Transitous (MOTIS), adressen via PDOK, stations van NSNee
verkeerHet verkeer nu: files met hun lengte, ongelukken en pech, afgesloten wegen, afritten en rijstroken, werkzaamheden, open bruggen en lagere snelheden, met weg, afrit en richting, of straat en plaats. Rond een plaats, langs een weg (A12, N206) of voor de grote wegen in heel Nederland, ook alleen één soort, zoals de afsluitingenNDW (actueel beeld, DATEX II), wegen en afritten uit VILD, straten via PDOKNee
open_in_de_buurtSupermarkten, apotheken en pinautomaten bij een adres, straat, station, wijk of plaats, de dichtstbijzijnde eerst, met vanaf waar gezocht is, de afstand, het adres (of anders de straat), de openingstijden en of het nu open is, tot hoe laat of wanneer het weer opengaat. Bij een apotheek hoe je de dienstapotheek vindtOpenStreetMap (ODbL), adressen en straten via PDOK, stations van NSNee (stations: NS)

Elk antwoord heeft een veld bron, zodat je assistent altijd kan zeggen waar het vandaan komt. Er zitten geen persoonsgegevens in, en je kunt er geen mensen mee opzoeken.

In de chat op de website zoekt Joost ook vluchten van en naar Schiphol op (vlucht_info). Dat zit expres niet in de MCP-server: delen via MCP valt volgens Schiphol niet onder hun voorwaarden, de chat op je eigen website wel. Daarom gelden er grenzen: één vlucht per keer, alleen gisteren, vandaag en morgen, geen lijsten en geen geschiedenis, een limiet per bezoeker en voor de hele site, en Schiphol staat als bron bij elk antwoord.

Lokaal draaien

Je hebt uv nodig.

uv sync
uv run python scripts/smoke_test.py

De smoke test roept elke tool aan tegen de echte bronnen. Tools waarvoor je nog geen key hebt, worden overgeslagen.

In Claude Desktop

Zet dit in claude_desktop_config.json en pas het pad aan:

{
  "mcpServers": {
    "heyjoost": {
      "command": "uv",
      "args": ["--directory", "/pad/naar/HeyJoost", "run", "nederland-mcp"]
    }
  }
}

In Claude Code

claude mcp add heyjoost -- uv --directory /pad/naar/HeyJoost run nederland-mcp

Als webserver (hosting)

uv run nederland-mcp --http --host 0.0.0.0 --port 8000

De MCP-url is dan http://<jouw-host>:8000/mcp. Mensen voegen hem toe als remote MCP server of custom connector met die url, ze hoeven zelf niks te installeren. De server onthoudt niks tussen aanvragen (stateless), dus je kunt er gerust meerdere naast elkaar draaien. Op / staat de chat, op /over de uitleg en daarnaast privacy, voorwaarden en toegankelijkheid (bestanden in src/nederland_mcp/site/). / is ook handig als health check.

Voor hosting staan er een Dockerfile en een railway.json klaar. Op Railway koppel je de GitHub-repo, kies je regio EU West (Amsterdam) en zet je de keys bij Variables. De poort komt vanzelf uit $PORT.

API-keys

Kopieer .env.example naar .env en vul in wat je hebt. Tools zonder key geven een nette melding, de rest werkt gewoon.

  • NS_API_KEY: gratis via het NS API-portal, product NsApp. Gratis gebruikers mogen 300 aanvragen per 5 minuten doen. Op een publieke server delen alle gebruikers die limiet, de cache vangt veel op.
  • EP_ONLINE_API_KEY: aanvragen via ep-online.nl. Je hebt een KvK-nummer nodig.
  • KNMI_OPEN_DATA_API_KEY en KNMI_WMS_API_KEY: gratis via het KNMI Data Platform, na inloggen bij Open Data API en bij WMS API. Eén account per persoon, elke API heeft zijn eigen key. De Open Data-key is voor de weerwaarschuwingen, de WMS-key voor de regenradar.
  • ANTHROPIC_API_KEY: voor Vraag het Joost, de chat op de website. Maak een key aan op platform.claude.com. Zonder key staat de chat uit en werkt de rest gewoon. De chat gebruikt Claude Haiku 5.5 en kost ongeveer een tiende cent per vraag. VRAAG_DAGBUDGET_USD (standaard 0.50) is het maximum per dag in dollars, VRAAG_PER_DAG (standaard 30) het aantal vragen per bezoeker per dag. Is het dagbudget op, dan zegt de chat dat hij tot middernacht vol is en toont hij het voorbeeldgesprek.
  • SCHIPHOL_CLIENT_ID en SCHIPHOL_CLIENT_SECRET: voor vluchten in de chat, via een app op developer.schiphol.nl. Zonder deze keys noemt de site geen vluchten. VLUCHT_PER_DAG (standaard 10) is het aantal vluchten per bezoeker per dag, VLUCHT_SITE_PER_DAG (standaard 300) het maximum voor de hele site.
  • HEYJOOST_REISPLANNER: zet op 1 om reis_plannen aan te zetten, van deur tot deur via de reisplanner van Transitous. Geen key, wel een afspraak: Transitous vraagt om eerst contact op te nemen voordat je hun routeplanning gebruikt, want die kost hun veel meer dan vertrektijden. Zet hem dus pas aan als zij akkoord zijn. Zonder deze variabele bestaat de tool niet en plant de chat van deur tot deur in stukjes, met trein_reis en ov_vertrek. Staat hij aan, dan vraagt de hele dienst samen hoogstens HEYJOOST_REISPLANNER_PER_DAG reizen per dag (standaard 200, een reis uit de cache telt niet), en de chat hoogstens twee per vraag.

Bronnen en voorwaarden

BronVoorwaarden
BAG en Locatieserver via PDOKOpen data, publiek domein
Rijksoverheid schoolvakantiesCC0
Reisadvies via de open data van NederlandWereldwijdCC0, zonder key. Het advies kan per uur veranderen, dus de server onthoudt het een half uur en geeft altijd de datum van de laatste wijziging en de link mee
Vragen en antwoorden van Rijksoverheid.nlCC0. Er is geen zoek-API, dus scripts/rijksoverheid_vragen.py haalt de lijst met vragen uit de sitemap (src/nederland_mcp/data/rijksoverheid_vragen.json). Draai het ongeveer eens per maand. Het vraagt één pagina per seconde, want de site blokkeert wie te snel gaat. De server leest per vraag hooguit drie pagina's en onthoudt ze een dag
Samenwerkende Catalogi (producten van gemeenten) via de SRU-zoekdienst van KOOPCC0. Niet elke gemeente zet al haar producten erin, dus soms staat er niks
Officiële bekendmakingen via de SRU-zoekdienst van KOOPCC0. Bekendmakingen zijn openbaar, maar noemen vaak een adres en soms een persoon. Daarom zoekt de server alleen rond een punt, afgerond op ongeveer 100 meter, nooit op naam of tekst, laat hij huisnummers en postcodes weg en slaat hij bekendmakingen over personen over (een naam, de BRP, een parkeerplaats voor een kenteken). Hij onthoudt het een half uur
NDW, actueel beeld (opendata.ndw.nu)CC0, zonder key. Ongecontroleerde berichten van de wegbeheerders, elke minuut nieuw; de server haalt het hele bestand (ongeveer 0,5 MB) hooguit elke 2 minuten op. Files staan er alleen in als ze gemeld zijn. Wegnummers en afritten komen uit VILD, de locatietabel van NDW (CC0): scripts/ndw_vild.py maakt daar src/nederland_mcp/data/vild.json van. Gaat NDW over op een nieuwe versie, dan staat dat in de log (VILD-versie): pas dan VERSION in het script aan en draai het opnieuw
OpenStreetMap (supermarkten, apotheken, pinautomaten)ODbL: noem "© OpenStreetMap-bijdragers" bij elk antwoord. De openbare Overpass-servers zijn niet bedoeld voor een vraag per gebruiker, dus scripts/osm_winkels.py haalt alles in Nederland in één keer op, met waar OpenStreetMap het centrum van elke plaats zet, naar src/nederland_mcp/data/osm_winkels.json. Voor een plek zonder adres vraagt het daarna bij PDOK de straat van het dichtstbijzijnde adres, één voor één, dus het loopt zo'n tien minuten. Draai het ongeveer eens per maand en probeer het bij een time-out (504) later nog eens, niet meteen. Dat bestand is een afgeleide database en valt dus zelf ook onder de ODbL; het script is de manier waarop het gemaakt is. Bitcoinautomaten en winkels die als supermarkt getagd zijn maar het niet zijn (slijterij, slagerij, pindakaaswinkel) laat Hey Joost weg
Rijkswaterstaat WaterinfoPubliek domein volgens data.overheid.nl (dataset Waterinfo Rijkswateren), en CC0 volgens rijkswaterstaatdata.nl. Actuele metingen zijn ongecontroleerd. Het getij (astronomisch) staat er tot ongeveer een jaar vooruit in, de verwachting met wind ongeveer twee dagen. Niet elk meetpunt in de catalogus heeft een getijtabel, dus de server probeert de drie dichtstbijzijnde
NS Reisinformatie APIHet product Ns-App heeft geen eigen gebruiksvoorwaarden. Gratis gebruikers mogen 300 aanvragen per 5 minuten doen. Voor meer, of voor betaald gebruik, contact opnemen met NS
EP-onlineVoorwaarden RVO, key hoort bij een KvK-nummer
Schiphol Public Flight APIAlleen in de chat op je eigen website, niet via MCP. Eén vlucht per keer, alleen gisteren tot en met morgen, een limiet per bezoeker en per dag, Schiphol als bron bij elk antwoord en hooguit een minuut in de cache
KNMI Data Platform (regenradar, weerwaarschuwingen)CC BY 4.0, gratis, ook commercieel (fair-use-beleid): noem het KNMI als bron en wek niet de indruk dat het KNMI Hey Joost steunt. Keys zijn persoonlijk. De WMS-key mag 1.000 aanvragen per uur en 20 per seconde doen, de Open Data-key 1.000 per uur. De regenradar vraagt elk tijdstip apart op, omdat de server bij meerdere tijdstippen tegelijk alleen het eerste geeft. Het KNMI vervangt de waarschuwingen op 2 november 2026 door een nieuwe dataset met gebieden op de kaart; de server gebruikt die vanzelf zodra hij echt is, en tot dan de oude per provincie
Open-Meteo (weer)Gratis voor niet-commercieel gebruik, tot 10.000 aanvragen per dag. De data valt onder CC BY 4.0: noem Open-Meteo als bron, met een link naar open-meteo.com bij de data. Voor commercieel gebruik is een abonnement nodig
SMARD.de via Energy-Charts (stroomprijs)De Bundesnetzagentur geeft de day-ahead-prijzen, ook die van Nederland, onder CC BY 4.0: noem "Bundesnetzagentur | SMARD.de". Energy-Charts (Fraunhofer ISE) mag 2 aanvragen per minuut per server; daarboven vraagt de server het rechtstreeks aan SMARD. De prijzen van morgen komen na de veiling van 12:00. De energiebelasting staat per jaar in bronnen/stroom.py (TAX): 2026 van de Belastingdienst, 2027 uit het Belastingplan 2027. Controleer die in december, als het Belastingplan is aangenomen
CBS Kerncijfers wijken en buurtenCC BY 4.0: noem het CBS als bron. Elk jaar een nieuwe tabel (2026: 86358NED, 2025: 86165NED, 2024: 85984NED), die het CBS in stappen vult. Een tabel die het CBS vernieuwt, is soms een paar uur dicht
Transitous (bus, tram, metro)Gebruiksbeleid: alleen voor open-source projecten, niet commercieel. User-Agent met naam, versie en contact, en een zichtbare link naar transitous.org/sources plus de OpenStreetMap-vermelding. Bij veel gebruikers of voor routeplanning eerst contact opnemen via hun Matrix-kanaal. Geen garantie op beschikbaarheid. Transitous krijgt nooit een adres: dat zoekt de server bij PDOK, en Transitous krijgt alleen een punt afgerond op ongeveer 100 meter, een station of een halte. Kent PDOK een adres niet, dan gaat hoogstens de straat zonder huisnummer of postcode mee

Hoe het in elkaar zit

  • src/nederland_mcp/server.py: de tools en hun beschrijvingen, plus de routes van de website.
  • src/nederland_mcp/site/: de website (de chat als startpagina, de uitleg op /over, privacy, voorwaarden, toegankelijkheid), met de lettertypes zelf erbij, zodat de site niks van anderen laadt. Je kunt Joost op je beginscherm zetten (manifest en iconen), vragen bewaren (alleen in de browser) en een antwoord delen met een link die de vraag na de # meegeeft, zodat de server hem niet ziet. Een antwoord laat je voorlezen met een stem op je eigen toestel, en staat je browser niet op Nederlands, dan is de chat Engels.
  • src/nederland_mcp/bronnen/: één bestand per bron.
  • src/nederland_mcp/common.py: HTTP-client, cache en tijdzone (alles in Nederlandse tijd).
  • src/nederland_mcp/vraag.py: de chat op de website. Claude krijgt dezelfde tools als via MCP, plus vluchten van Schiphol, en de server onthoudt geen gesprekken.
  • src/nederland_mcp/veilig.py: security-headers op elk antwoord (alleen HTTPS, nooit in een frame op een andere site, geen camera, microfoon of locatie) en per pagina een Content-Security-Policy die alleen de eigen scripts van die pagina laat draaien, op hun hash. Die hashes rekent de server zelf uit bij het starten, dus een aangepast script werkt meteen. Cloudflare mag er geen scripts bij zetten: de mailadressen staan tussen en, anders verbergt Cloudflare ze met een eigen script dat de policy tegenhoudt. Zet je in Cloudflare Web Analytics of Rocket Loader aan, dan houdt de policy die ook tegen. De chat werkt alleen op het eigen domein, niet op het adres van Railway zelf (daar kun je om Cloudflare heen), en telt een bezoeker op cf-connecting-ip van Cloudflare of x-real-ip van Railway, nooit op x-forwarded-for, want dat kan iedereen zelf invullen.
  • src/nederland_mcp/tellers.py: anonieme tellingen per dag, zoals hoe vaak de site, de chat en elke tool gebruikt worden. Ze staan elk uur als één regel in de log: zoek op Tellers. Wie iets vroeg of wat, staat er niet in. Kan de chat een vraag niet beantwoorden, dan telt hij alleen het onderwerp, uit een vaste lijst (MISSED in vraag.py), als chat mist <onderwerp>: zo zie je wat mensen nog missen.
  • Alle aanvragen gaan via een cache, zodat de bronnen niet onnodig belast worden: buurtcijfers en straatnamen bij verkeersberichten een week, stations, haltes, adressen, plaatsen, vakanties, regelzaken en oudere stroomprijzen een dag, het getij 12 uur, de waterverwachting, het reisadvies en bekendmakingen een half uur, het weer, de stroomprijs en werkzaamheden op het spoor 15 minuten, de regenradar 10 minuten, water en weerwaarschuwingen 5 minuten, storingen op het spoor en het verkeer 2 minuten, treinen, bussen en vluchten 30 tot 60 seconden.
  • Foutmeldingen zijn in het Nederlands en vertellen wat je kunt doen.
  • Wat gebruikers opvragen (adressen, plaatsen) komt niet in de logs.

Licentie

De code valt onder de MIT-licentie. De data blijft van de bronnen hierboven, met hun eigen voorwaarden. Zo valt src/nederland_mcp/data/osm_winkels.json onder de ODbL (© OpenStreetMap-bijdragers). De naam Hey Joost en het logo vallen niet onder de licentie. De lettertypes IBM Plex Sans en IBM Plex Mono vallen onder de SIL Open Font License 1.1, zie src/nederland_mcp/site/fonts/.

Reviews

No reviews yet

Be the first to review this server!