mcp-hypotheken-berekenen

Instructions

Implementation Reference

• src/index.ts:581-625 (handler)

  Main handler function for 'bereken_hypotheek_uitgebreid' tool: validates input, normalizes arguments (especially for doorstromer), builds API payload including custom new loan params, calls Replit API, logs success, and returns formatted response.

  async function handleBerekenUitgebreid(request: any): Promise<ToolResponse> {
    const rawArgs = requireArguments<UitgebreidArguments>(request);
    const normalizedArgs = rawArgs.is_doorstromer
      ? (normalizeDoorstromerArgs(rawArgs) as UitgebreidArguments)
      : rawArgs;
    const logger = createLogger(normalizedArgs.session_id);
  
    validateBaseArguments(normalizedArgs as BaseArguments);
    if (normalizedArgs.is_doorstromer && normalizedArgs.bestaande_hypotheek) {
      validateBestaandeHypotheek(normalizedArgs.bestaande_hypotheek);
    }
  
    enforceRateLimit(normalizedArgs.session_id);
  
    const payload: any = {
      aanvragers: mapAanvragers(normalizedArgs),
    };
  
    if (normalizedArgs.is_doorstromer && normalizedArgs.waarde_huidige_woning && normalizedArgs.bestaande_hypotheek) {
      payload.bestaande_hypotheek = {
        waarde_huidige_woning: normalizedArgs.waarde_huidige_woning,
        leningdelen: normalizedArgs.bestaande_hypotheek.leningdelen,
      };
    }
  
    const maatwerk = (normalizedArgs as any).nieuwe_hypotheek ?? (normalizedArgs as any).nieuwe_lening;
    const nieuweLening = buildNieuweLeningPayload(maatwerk);
    if (nieuweLening) {
      payload.nieuwe_lening = nieuweLening;
    }
  
    if (normalizedArgs.session_id) {
      payload.session_id = normalizedArgs.session_id;
    }
  
    const apiClient = getApiClient();
    const { data } = await apiClient.post(
      REPLIT_API_URL_BEREKENEN,
      payload,
      { correlationId: normalizedArgs.session_id }
    );
  
    logger.info('Toolcall succesvol', { tool: 'bereken_hypotheek_uitgebreid' });
    return successResponse(formatResponse(data, "bereken_hypotheek_uitgebreid"));
  }

• src/index.ts:766-773 (registration)

  TOOL_HANDLERS object maps tool name 'bereken_hypotheek_uitgebreid' to its handler function handleBerekenUitgebreid, used by CallToolRequestSchema handler.

  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:830-866 (schema)

  Tool registration and input schema definition in ListToolsRequestSchema response, including detailed properties for extended params like nieuwe_hypotheek, nieuwe_lening, doorstromer support.

          name: "bereken_hypotheek_uitgebreid",
          description: `Maximale hypotheek – uitgebreide variant. Gebruik dit alleen wanneer er nog GEEN concrete woning is, maar de gebruiker/adviseur expliciet met parameters wil spelen (bijv. andere rentevast-periodes, custom renteklassen, scenariovergelijkingen). Voor een concrete woning altijd de opzet-tools gebruiken. Zodra u dit tool voor een doorstromer inzet (is_doorstromer=true of bestaande_hypotheek ingevuld), gelden dezelfde regels als bij de standaard doorstromer-tool:
  ${DOORSTROMER_OUTPUT_GUIDANCE}`,
          inputSchema: {
            type: "object",
            description: `Alle velden zijn optioneel bovenop de basisintake; zie ${OPZET_GUIDE_URI} voor velduitleg en defaults.`,
            properties: {
              ...baseIntakeProperties,
              is_doorstromer: {
                type: "boolean",
                description: "Geeft aan of de aanvrager een doorstromer is.",
              },
              waarde_huidige_woning: {
                type: "number",
                description: "Optionele huidige woningwaarde in euro's.",
              },
              bestaande_hypotheek: {
                ...bestaandeHypotheekSchema,
              },
              nieuwe_woning: {
                ...nieuweWoningSchema,
              },
              nieuwe_hypotheek: {
                type: "object",
                description: `Optionele maatwerk leningparameters (looptijd, rentevast, rente). Detailuitleg: ${OPZET_GUIDE_URI}.`,
              },
              nieuwe_lening: {
                type: "object",
                description: `Optionele structuur voor looptijd/rentevast/NHG en renteklassen (detailuitleg: ${OPZET_GUIDE_URI}).`,
              },
              session_id: {
                type: "string",
                description: "Optioneel sessie-ID vanuit n8n (voor logging).",
              },
            },
            required: baseIntakeRequired,
          },

• src/index.ts:81-86 (schema)

  TypeScript interface defining the input arguments structure for the 'bereken_hypotheek_uitgebreid' tool.

  interface UitgebreidArguments extends BaseArguments {
    is_doorstromer?: boolean;
    waarde_huidige_woning?: number;
    bestaande_hypotheek?: BestaandeHypotheek;
    nieuwe_hypotheek?: NieuweHypotheek;
  }

• src/index.ts:623-624 (helper)

  Specific formatting and logging in handler tail for this tool, using formatResponse function tailored for it.

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