hypotheek-mcp-server

pace8/hypotheek-mcp-server

3.1

If you are the rightful owner of hypotheek-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to dayong@mcphub.com.

The Hypotheek MCP Server is designed to facilitate mortgage calculations and provide up-to-date interest rates using the Model Context Protocol (MCP).

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 .


🛠️ Beschikbare tools

ToolBeschrijvingOutput
bereken_hypotheek_starterMaximale hypotheek voor startersMax bedrag + maandlast + NHG-vergelijking
bereken_hypotheek_doorstromerMaximale hypotheek voor doorstromersMax bedrag + maandlast + overwaarde
bereken_hypotheek_uitgebreidMaatwerkparameters (rente, looptijd, energielabel)Custom leenbedrag
opzet_hypotheek_starterComplete financiering voor gewenste woning (starter)Totaal benodigd bedrag + financieringsmix + maandlast
opzet_hypotheek_doorstromerFinancieringsmix voor doorstromers (bestaand + nieuw)Benodigd bedrag + overwaarde + maandlasten
opzet_hypotheek_uitgebreidOpzet met maatwerk leningdelenCustom opzet, zowel bestaand als nieuw
haal_actuele_rentes_opActuele rentes per rentevaste periodeJSON 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 voor volledige release notes.