mcp-hypotheken-berekenen

Instructions

Implementation Reference

• src/index.ts:638-671 (handler)

  The primary handler function for the 'opzet_hypotheek_starter' tool. It extracts and normalizes arguments, performs validation, constructs a payload, calls the external Replit API endpoint for opzet calculations, and returns a formatted response.

  async function handleOpzetStarter(request: any): Promise<ToolResponse> {
    const rawArgs = requireArguments<OpzetStarterArguments>(request);
    const normalizedArgs = normalizeOpzetAanvragerShape(rawArgs) as OpzetStarterArguments;
    const logger = createLogger(normalizedArgs.session_id);
  
    const aanvrager = requireOpzetAanvrager(normalizedArgs);
    validateOpzetAanvrager(aanvrager);
    enforceRateLimit(normalizedArgs.session_id);
  
    const payload: any = {
      aanvrager: mapOpzetAanvrager(aanvrager),
      nieuwe_woning: {
        waarde_woning: normalizedArgs.nieuwe_woning.waarde_woning,
        bedrag_verbouwen: normalizedArgs.nieuwe_woning.bedrag_verbouwen ?? 0,
        bedrag_verduurzamen: normalizedArgs.nieuwe_woning.bedrag_verduurzamen ?? 0,
        kosten_percentage: normalizedArgs.nieuwe_woning.kosten_percentage ?? 0.05,
        energielabel: normalizeEnergielabel(normalizedArgs.nieuwe_woning.energielabel || ''),
      },
    };
  
    if (normalizedArgs.session_id) {
      payload.session_id = normalizedArgs.session_id;
    }
  
    const apiClient = getApiClient();
    const { data } = await apiClient.post(
      REPLIT_API_URL_OPZET,
      payload,
      { correlationId: normalizedArgs.session_id }
    );
  
    logger.info('Toolcall succesvol', { tool: 'opzet_hypotheek_starter' });
    return successResponse(formatResponse(data, "opzet_hypotheek_starter"));
  }

• src/index.ts:881-901 (schema)

  Defines the tool's metadata including name, detailed description, and JSON input schema specifying required 'aanvrager' and 'nieuwe_woning' objects with their properties.

    name: "opzet_hypotheek_starter",
    description: `Opzet-berekening voor starters met een CONCRETE woning. Gebruik dit zodra de gebruiker een huis/koopprijs noemt en wil weten “kan ik deze woning kopen, hoe ziet de financiering eruit?”. Voor louter oriëntatie zonder woning blijft u bij de maximale-hypotheek tools. Dit is de standaardvariant; kies opzet_hypotheek_uitgebreid wanneer de gebruiker expliciet scenario’s/leningdelen wil tweaken.`,
    inputSchema: {
      type: "object",
      description: `Gebruik basisintake plus woninginfo; zie ${OPZET_GUIDE_URI} voor detailvelden en defaults.`,
      properties: {
        aanvrager: aanvragerSchema,
        nieuwe_woning: {
          ...nieuweWoningSchema,
        },
        session_id: {
          type: "string",
          description: "Optioneel sessie-ID vanuit n8n (voor logging).",
        },
      },
      required: [
        "aanvrager",
        "nieuwe_woning",
      ],
    },
  },

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

  Maps the tool name 'opzet_hypotheek_starter' to its handler function 'handleOpzetStarter' in the central TOOL_HANDLERS registry used by the MCP CallToolRequestHandler.

  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/adapters/field-normalizer.ts:183-210 (helper)

  Helper function used by the handler to normalize legacy flat argument structure into the required nested 'aanvrager' object format.

  export function normalizeOpzetAanvragerShape(args: any): any {
    if (!args || typeof args !== 'object') {
      return args;
    }
  
    if (args.aanvrager && typeof args.aanvrager === 'object') {
      return args;
    }
  
    const legacy = { ...args };
    if (
      typeof legacy.inkomen_aanvrager === 'number' &&
      typeof legacy.geboortedatum_aanvrager === 'string' &&
      typeof legacy.heeft_partner === 'boolean'
    ) {
      legacy.aanvrager = {
        inkomen_aanvrager: legacy.inkomen_aanvrager,
        geboortedatum_aanvrager: legacy.geboortedatum_aanvrager,
        heeft_partner: legacy.heeft_partner,
        inkomen_partner: legacy.inkomen_partner,
        geboortedatum_partner: legacy.geboortedatum_partner,
        verplichtingen_pm: legacy.verplichtingen_pm,
        eigen_vermogen: legacy.eigen_vermogen,
      };
    }
  
    return legacy;
  }