bereken_hypotheek_starter

Calculate your maximum mortgage amount, monthly payments, and NHG comparison based on your income, age, and partner details.

Instructions

Berekent de maximale hypotheek voor starters. Output: maximaal leenbedrag, maandlast en NHG-vergelijking.

Input Schema

TableJSON Schema

Name	Required	Description
`inkomen_aanvrager`	Yes	Bruto jaarinkomen hoofdaanvrager in euro's.
`geboortedatum_aanvrager`	Yes	Interne geboortedatum hoofdaanvrager (ISO). Vraag de gebruiker altijd: "Wat is uw leeftijd of geboortedatum?" en deel bij een leeftijd alleen die leeftijd terug.
`heeft_partner`	Yes	Geeft aan of een partner mee leent.
`inkomen_partner`	No	Optioneel partnerinkomen in euro's.
`geboortedatum_partner`	No	Optionele interne geboortedatum partner (ISO). Vraag ook hier: "Wat is uw leeftijd of geboortedatum?" en houd de afgeleide datum intern.
`verplichtingen_pm`	No	Optionele maandelijkse verplichtingen in euro's.
`session_id`	No	Optioneel sessie-ID vanuit n8n (voor logging).

Implementation Reference

src/index.ts:524-548 (handler)

The main handler function for the 'bereken_hypotheek_starter' tool. Validates base arguments, enforces rate limiting, constructs payload for the external Replit API, calls the API, logs success, and returns a formatted response using successResponse and formatResponse.

async function handleBerekenStarter(request: any): Promise<ToolResponse> {
  const args = requireArguments<BaseArguments>(request);
  const logger = createLogger(args.session_id);

  validateBaseArguments(args);
  enforceRateLimit(args.session_id);

  const payload: any = {
    aanvragers: mapAanvragers(args),
  };

  if (args.session_id) {
    payload.session_id = args.session_id;
  }

  const apiClient = getApiClient();
  const { data } = await apiClient.post(
    REPLIT_API_URL_BEREKENEN,
    payload,
    { correlationId: args.session_id }
  );

  logger.info('Toolcall succesvol', { tool: 'bereken_hypotheek_starter' });
  return successResponse(formatResponse(data, "bereken_hypotheek_starter"));
}

src/index.ts:766-774 (registration)

Registration of all tool handlers, including mapping 'bereken_hypotheek_starter' to its handler function handleBerekenStarter. This object is used in the CallToolRequestSchema handler to dispatch tool calls.

const TOOL_HANDLERS: Record<string, ToolHandler> = {
  bereken_hypotheek_starter: handleBerekenStarter,
  bereken_hypotheek_doorstromer: handleBerekenDoorstromer,
  bereken_hypotheek_uitgebreid: handleBerekenUitgebreid,
  haal_actuele_rentes_op: handleActueleRentes,
  opzet_hypotheek_starter: handleOpzetStarter,
  opzet_hypotheek_doorstromer: handleOpzetDoorstromer,
  opzet_hypotheek_uitgebreid: handleOpzetUitgebreid,
};

src/index.ts:781-794 (schema)

Tool definition in ListToolsRequestSchema handler, including name, description, and inputSchema (JSON Schema) for 'bereken_hypotheek_starter' which defines the expected arguments like inkomen_aanvrager, geboortedatum_aanvrager, etc.

{
  name: "bereken_hypotheek_starter",
  description: `Maximale hypotheek voor starters ZONDER concrete woning. Gebruik deze tool alleen wanneer de gebruiker zich oriënteert ("Wat kan ik lenen?") en er nog geen koopsom/adres bekend is. Zodra de gebruiker een specifiek huis of biedprijs noemt moet u overschakelen naar de opzet-hypotheek tools.`,
  inputSchema: {
    type: "object",
    description: `Gebruik basisintakevelden; zie ${OPZET_GUIDE_URI} voor detaildefinities.`,
    properties: {
      ...baseIntakeProperties,
      session_id: {
        type: "string",
        description: "Optioneel sessie-ID vanuit n8n (voor logging).",
      },
    },
    required: baseIntakeRequired,

src/index.ts:546-547 (helper)
Specific use of formatResponse tailored for 'bereken_hypotheek_starter', which formats the API response into a user-friendly Dutch summary with scenarios, amounts, and labels.
```
logger.info('Toolcall succesvol', { tool: 'bereken_hypotheek_starter' });
return successResponse(formatResponse(data, "bereken_hypotheek_starter"));
```

mcp-hypotheken-berekenen