Hypotheek MCP Server v5.0

MCP-server voor Nederlandse hypotheekberekeningen. Levert compacte tools, prompts en resources zodat AI-agents (n8n, Claude, GPT, ...) direct hypotheekvragen kunnen afhandelen.

🚀 Quick Start

git clone https://github.com/pace8/hypotheek-mcp-server.git cd hypotheek-mcp-server npm install cp .env.example .env # vul je REPLIT_API_KEY in npm run build npm start

npm run dev — TypeScript watch mode
npm test — Jest test suites
npm run lint — ESLint controle

Meer configuratie-opties staan in docs/CONFIG.md.

🛠️ Beschikbare tools

Tool	Beschrijving	Output
`bereken_hypotheek_starter`	Maximale hypotheek voor starters	Max bedrag + maandlast + NHG-vergelijking
`bereken_hypotheek_doorstromer`	Maximale hypotheek voor doorstromers	Max bedrag + maandlast + overwaarde
`bereken_hypotheek_uitgebreid`	Maatwerkparameters (rente, looptijd, energielabel)	Custom leenbedrag
`opzet_hypotheek_starter`	Complete financiering voor gewenste woning (starter)	Totaal benodigd bedrag + financieringsmix + maandlast
`opzet_hypotheek_doorstromer`	Financieringsmix voor doorstromers (bestaand + nieuw)	Benodigd bedrag + overwaarde + maandlasten
`opzet_hypotheek_uitgebreid`	Opzet met maatwerk leningdelen	Custom opzet, zowel bestaand als nieuw
`haal_actuele_rentes_op`	Actuele rentes per rentevaste periode	JSON met NHG en niet-NHG tarieven

📚 MCP Resources & Prompts

hypotheek://v4/guide/opzet-intake — intake checklist, defaults & velddefinities
hypotheek://v4/guide/output-formatting — hoe je tooloutput toont aan klanten
hypotheek://v4/guide/quick-ref — toolselectie, formatregels, valkuilen
hypotheek://v4/guide/playbook — 10 uitgewerkte voorbeeldgesprekken

Prompts (list_prompts) verwijzen automatisch naar deze resources zodat agents detailinformatie kunnen ophalen wanneer nodig.

🔧 Development notes

Config wordt centraal geladen via src/config/index.ts (Zod-validatie)
Toolhandlers zitten in src/index.ts en gebruiken gedeelde helperfuncties
Markdown-resources wonen in docs/ en worden via src/resources/index.ts beschikbaar gemaakt
Testen draaien op Node ≥18 met Jest (ESM + ts-jest)

Zie CHANGELOG.md voor volledige release notes.