betteroff.finance WebMCP Tools, Schemas & Agent Capabilities

betteroff.finance

live Unverified (seed import) Finance & Crypto 22 tools imperative implementation

BetterOff keeps household accounts and financial records current, then shows what changed, what is coming, and what needs attention.

First seen 2026-08-31 · Last seen 2026-08-31 · Source: webmcp.com

Answer 5 · Act 16 · Transact 1 · Score: Not yet scored

Tool inspector

calc_retirement

act imperative

Projects retirement savings from age, contributions, return assumptions, and income target, returns the year-by-year balance at each age, then estimates the gap using a 4% withdrawal assumption.

Page: /

Input schema

Property	Type	Required	Description
`currentAge`	integer	no	Current age
`retirementAge`	integer	no	Retirement age
`currentSavings`	number	no	Current retirement savings
`monthlyContribution`	number	no	Monthly contribution
`annualReturnPct`	number	no	Expected annual return (%) — Nominal annual return before inflation.
`desiredMonthlyIncome`	number	no	Desired retirement income — Monthly income target in retirement.
`displayMode`	string	no	Projection mode
`inflationRatePct`	number	no	Inflation rate (%)
`annualFeePct`	number	no	Annual investment fees (%) — Deducted from the assumed annual return.
`annualContributionGrowthPct`	number	no	Annual contribution growth (%) — Increase applied to monthly contributions after each projection year.
`withdrawalRatePct`	number	no	Withdrawal-rate assumption (%) — Planning assumption only; it is not guaranteed to be safe.
`otherMonthlyIncome`	number	no	Other monthly retirement income — Expected Social Security, pension, or other income that reduces the amount the portfolio must provide.

Raw JSON schema

{
  "$schema": "http://json-schema.org/draft-07/schema#",
  "type": "object",
  "properties": {
    "currentAge": {
      "default": 35,
      "description": "Current age",
      "type": "integer",
      "minimum": 18,
      "maximum": 80
    },
    "retirementAge": {
      "default": 65,
      "description": "Retirement age",
      "type": "integer",
      "minimum": 30,
      "maximum": 90
    },
    "currentSavings": {
      "default": 150000,
      "description": "Current retirement savings",
      "type": "number",
      "minimum": 0,
      "maximum": 50000000
    },
    "monthlyContribution": {
      "default": 1500,
      "description": "Monthly contribution",
      "type": "number",
      "minimum": 0,
      "maximum": 1000000
    },
    "annualReturnPct": {
      "default": 7,
      "description": "Expected annual return (%) — Nominal annual return before inflation.",
      "type": "number",
      "minimum": -20,
      "maximum": 30
    },
    "desiredMonthlyIncome": {
      "default": 6000,
      "description": "Desired retirement income — Monthly income target in retirement.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    },
    "displayMode": {
      "default": "nominal",
      "description": "Projection mode",
      "type": "string",
      "enum": [
        "nominal",
        "inflation_adjusted"
      ]
    },
    "inflationRatePct": {
      "default": 2.5,
      "description": "Inflation rate (%)",
      "type": "number",
      "minimum": 0,
      "maximum": 20
    },
    "annualFeePct": {
      "default": 0,
      "description": "Annual investment fees (%) — Deducted from the assumed annual return.",
      "type": "number",
      "minimum": 0,
      "maximum": 10
    },
    "annualContributionGrowthPct": {
      "default": 0,
      "description": "Annual contribution growth (%) — Increase applied to monthly contributions after each projection year.",
      "type": "number",
      "minimum": 0,
      "maximum": 20
    },
    "withdrawalRatePct": {
      "default": 4,
      "description": "Withdrawal-rate assumption (%) — Planning assumption only; it is not guaranteed to be safe.",
      "type": "number",
      "minimum": 1,
      "maximum": 10
    },
    "otherMonthlyIncome": {
      "default": 0,
      "description": "Other monthly retirement income — Expected Social Security, pension, or other income that reduces the amount the portfolio must provide.",
      "type": "number",
      "minimum": 0,
      "maximum": 100000
    }
  },
  "additionalProperties": false
}