com.retirecrunch/calculators

Measured conclusion: Deep-tested. L2 outcome: tools_ok.

FIRE & retirement calculators + a multi-currency portfolio rebalancer (exact buy/sell trades).

Add to your agent

Copy this into your MCP client config:

{
  "mcpServers": {
    "calculators": {
      "url": "https://mcp.retirecrunch.com/mcp",
      "transport": "streamable-http"
    }
  }
}

Measured tools (8)

• calculate_fire_target

  Estimate the savings target needed for Financial Independence / Early Retirement. Runs Monte Carlo simulation and returns the probability the portfolio survives the planning horizon.

  Parameters:

  • annual_expense (required) — number — Projected annual spending in retirement (in selected currency).
  • years (required) — integer — Planning horizon in years.
  • currency — string
  • inflation_rate — number
  • apply_inflation — boolean
  • current_savings — number — Current liquid + invested assets.
  • portfolio_volatility — number — Annual return standard deviation %.
  • portfolio_return_rate — number — Expected real annual return %.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• calculate_coast_fire

  Compute the Coast FIRE milestone — the capital required today such that, with no further contributions, a portfolio compounds to the user's retirement target by their target age.

  Parameters:

  • current_age (required) — integer
  • target_retirement_age (required) — integer
  • current_savings (required) — number
  • annual_expenses_in_retirement (required) — number
  • currency — string
  • inflation_rate — number
  • monthly_savings — number
  • expected_return_rate — number
  • portfolio_volatility — number
  • safe_withdrawal_rate — number

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• compute_swiss_property_tax

  Estimate the Swiss cantonal real-estate capital gains tax (Grundstückgewinnsteuer) for a property sale. Covers all 26 cantons with holding-period adjustments and Ersatzbeschaffung (replacement-residence) deferral. Educational estimate; commune surcharges and value-enhancing-improvement deductions are not modeled.

  Parameters:

  • canton (required) — string — Canton code (ZH, BE, ..., JU).
  • sale_price (required) — number
  • purchase_price (required) — number
  • years_held (required) — number
  • ersatzbeschaffung — boolean — Reinvest proceeds into a replacement primary residence.
  • ersatzbeschaffung_amount — number — Amount reinvested (caps the tax deferral).

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• project_wealth_plan

  Run RetireCrunch's full year-by-year Wealth Plan projection for a household. Models earned income, pensions, expenses, portfolio growth, optional growth→income phase switch, mortgage amortization, optional property sale, and region-aware tax (US uses 2026 federal+state brackets; other regions use a flat rate). Returns a compact summary with 5-year milestones by default, or the full annual array when yearly_detail=true.

  Parameters:

  • start_year (required) — integer — First year of the projection (typically the current year).
  • retirement_year (required) — integer — Year retirement begins.
  • region — string — Country regime — drives tax model (US uses bracket-based federal/state; others a flat rate).
  • currency — string
  • yearly_detail — boolean — When true, include the full year-by-year array in the response. When false (default), return a compact summary plus 5-year milestones.
  • household_type — string
  • inflation_rate — number — Annual inflation %.
  • current_mortgage — number
  • current_property — number
  • current_liquidity — number
  • income_yield_rate — number — Annual yield % during the income phase.
  • estimated_tax_rate — number — Pre-retirement effective tax rate (%).
  • plan_horizon_years — integer — Total years to project from start_year.
  • property_sale_year — integer
  • current_living_costs — number — Annual general living expenses today.
  • portfolio_volatility — number — Return std dev %; 0 = deterministic.
  • current_earned_income — number — Annual gross earned income today.
  • portfolio_return_rate — number — Annual real portfolio return %.
  • portfolio_switch_year — integer — Year to switch from growth to income phase. Defaults to retirement_year if omitted.
  • property_sale_enabled — boolean
  • current_other_expenses — number — Annual other expenses today.
  • current_housing_expenses — number — Annual housing expenses today.
  • portfolio_switch_enabled — boolean
  • post_retirement_tax_rate — number — Post-retirement effective tax rate (%).
  • property_sale_destination — string
  • current_investment_portfolio — number
  • partner_survivor_expense_factor — number
  • partner_early_death_years_before_end — integer

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_portfolio_returns

  Return RetireCrunch's historical portfolio return profiles for a currency. Each profile is a (return %, volatility %) pair derived from real index data — useful for grounding the assumptions in calculate_fire_target / project_wealth_plan in something defensible rather than guessing.

  Parameters:

  • currency (required) — string — Currency code; the historical return profiles are denominated in this currency.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• rebalance_portfolio

  Rebalance a multi-currency portfolio: given holdings, per-holding (or per-asset-class) target weights, cash and FX rates, return the exact BUY/SELL trades to reach the targets, the per-currency cash movements (flagging foreign-cash overdrafts), and a summary. Planning math only — no transaction costs or taxes.

  Parameters:

  • holdings (required) — array — The portfolio holdings to rebalance.
  • fx_rates — object — Value of 1 unit of each currency in the base currency (base currency itself is 1).
  • base_currency — string — Base currency the portfolio is valued in.
  • class_targets — object — Optional per-asset-class goal % (incl. "Cash"). When given, unlocked holdings are retargeted to hit each class goal before computing trades.
  • available_cash — object — Cash held per currency, keyed by ISO code.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• load_portfolio

  Open the user's Interactive Brokers portfolio in the RetireCrunch Portfolio Rebalancer. First call the IBKR connector's get_account_positions, get_account_balances and get_account_summary, then pass their results here UNCHANGED (do not re-type or round numbers). Returns a private link that works once, for 15 minutes — give it to the user exactly as written. No login is needed because the link itself is the key: the positions are encrypted with a key that exists only in the link, and RetireCrunch's server holds just that encrypted copy, which it cannot read, for at most 15 minutes and deletes it when the link is opened. Tell the user this, and that anyone holding the link can open it once, so it should not be shared. RetireCrunch does not recommend instruments or allocations: the user sets their own targets on the page.

  Parameters:

  • positions (required) — array — The `positions` array from IBKR get_account_positions, unchanged.
  • summary — object — The result of IBKR get_account_summary, unchanged (base currency + net liquidation, used to check the numbers add up).
  • balances — array — The `balances` array from IBKR get_account_balances, unchanged (gives per-currency cash).
  • language — string — Site language for the link, matching the user's language when possible.

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

• get_rebalance_plan

  Fetch the rebalancing trades the user decided on in the RetireCrunch Rebalancer, from the plan code they copied ("Send plan to my AI"). Codes work once, for 15 minutes. Returns the trades with IBKR contract ids where known. To act on them, create one IBKR order instruction per trade (create_order_instruction); the user reviews and submits each one inside IBKR. RetireCrunch never places orders.

  Parameters:

  • code (required) — string — The plan code the user copied from the RetireCrunch Rebalancer ("Send plan to my AI").

  Hints: read-only not declared · destructive not declared · idempotent not declared · open-world not declared

Repository

Measured by MCPYP probing. Untested fields are omitted, never estimated. Listing is always free; MCPYP never proxies calls or stores user tokens.