{"ok":true,"tool":"Retirement Calculator","operation":"calculate-retirement","description":"Project retirement savings and optionally the contribution needed to reach a target.","method":"POST","endpoint":"/api/retirement-calculator","webUrl":"https://ultraquick.tools/tools/retirement-calculator","parameters":{"type":"object","properties":{"currentAge":{"type":"number","description":"Current age"},"retirementAge":{"type":"number","description":"Target retirement age (must be greater than currentAge)"},"currentSavings":{"type":"number","description":"Existing savings (default 0)"},"monthlyContribution":{"type":"number","description":"Monthly contribution (default 0)"},"annualReturn":{"type":"number","description":"Expected annual return as a percentage (default 7)"},"targetNestEgg":{"type":"number","description":"Optional target savings to compare against"}},"required":["currentAge","retirementAge"]},"response":{"type":"object","properties":{"projectedSavings":{"type":"number"},"totalContributed":{"type":"number"},"totalGrowth":{"type":"number"},"meetsTarget":{"type":"boolean"},"shortfall":{"type":"number"},"requiredMonthlyContribution":{"type":"number"}}},"example":{"request":{"currentAge":30,"retirementAge":65,"monthlyContribution":200,"annualReturn":7},"response_shape":{"type":"object","properties":{"projectedSavings":{"type":"number"},"totalContributed":{"type":"number"},"totalGrowth":{"type":"number"},"meetsTarget":{"type":"boolean"},"shortfall":{"type":"number"},"requiredMonthlyContribution":{"type":"number"}}}},"howToCall":"POST a JSON body to https://ultraquick.tools/api/retirement-calculator. Returns {\"ok\":true,\"result\":{...}} on success or {\"ok\":false,\"error\":\"...\"} on failure. No auth, CORS-enabled.","parametersSummary":"  currentAge (number, required) — Current age\n  retirementAge (number, required) — Target retirement age (must be greater than currentAge)\n  currentSavings (number, optional) — Existing savings (default 0)\n  monthlyContribution (number, optional) — Monthly contribution (default 0)\n  annualReturn (number, optional) — Expected annual return as a percentage (default 7)\n  targetNestEgg (number, optional) — Optional target savings to compare against","curlExample":"curl -X POST https://ultraquick.tools/api/retirement-calculator -H \"Content-Type: application/json\" -d '{\"currentAge\":30,\"retirementAge\":65,\"monthlyContribution\":200,\"annualReturn\":7}'"}