app.quantcalc/retirement-engine

Est-ce que app.quantcalc/retirement-engine est sûr ?

Au dernier audit MCP Hub, le serveur MCP « app.quantcalc/retirement-engine » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 7 outils

• compare_return_assumptions≈ 809 tokens

  Runs the same plan against several published capital market assumption sets and returns the success rate and median outcome under each, showing how far the answer moves with the return forecast used. Every input is optional: omitted plan inputs use an illustrative plan (age 65, $1,000,000 saved, $40,000 a year spending) which the reply states in its first line.

  Paramètres, retour & exemple (17)

  Paramètres

  • pension · number · optionnel
    Yearly pension income. Default 0.
  • sources · array · optionnel
    Source ids to compare. Defaults to all.
  • allocations · array · optionnel
    Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0].
  • current_age · integer · optionnel
    Current age of the primary person.
  • bucket_years · integer · optionnel
    Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10.
  • return_model · string · optionnel · parametric | bootstrap | historical
    How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap: stationary block bootstrap of historical months. historical: replays real months from 1926 in order. The last two need a PRO licence; without one the engine runs parametric and the result says so.
  • ss_start_age · integer · optionnel
    Age Social Security starts. Default 67.
  • inflation_rate · number · optionnel
    Annual inflation as a percent, e.g. 2.5. Default 2.5.
  • retirement_age · integer · optionnel
    Age work income stops. Defaults to current age.
  • returns_source · string · optionnel
    Which published return set to use (see list_return_assumption_sources). Default jpmorgan.
  • annual_spending · number · optionnel
    Planned yearly spending in today's dollars, before income tax (this tool runs the standard engine, which does not model tax).
  • current_savings · number · optionnel
    Total invested portfolio today, in dollars.
  • life_expectancy · integer · optionnel
    Age the plan must last until. Default 92.
  • social_security · number · optionnel
    Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden.
  • pension_start_age · integer · optionnel
    Age the pension starts. Default 65.
  • withdrawal_strategy · string · optionnel · fixed | guyton-klinger | vpw | bucket
    Spending rule. fixed (default): the planned amount, inflation-adjusted, every year. guyton-klinger: guardrails that cut or raise spending as the portfolio moves. vpw: variable percentage withdrawal. bucket: a cash reserve of bucket_years of spending.
  • monthly_contribution · number · optionnel
    Monthly savings until retirement. Default 0.

  Exemple d'appel

  {"name": "compare_return_assumptions", "arguments": {"pension": 1, "sources": [], "allocations": [], "current_age": 1, "bucket_years": 1, "return_model": "parametric"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• estimate_2026_tax_return≈ 2111 tokens

  Estimates a household's 2026 federal and state income tax return from its 2026 income (wages, Social Security, IRA and 401(k) distributions, pensions, Roth conversions, interest, dividends, capital gains and losses), deductions, withholding and estimated payments, and returns the federal refund or amount owed, the state refund or amount owed, and both together; the main Form 1040 lines (total income, AGI, deduction, taxable income, tax, total tax) and the state's taxable income and tax; and every default assumed, the facts the state engine assumed, and what is not modelled. Computed by QuantCalc's federal and state tax APIs, the engines the website's 2026 Return Preview is checked against to the cent. Requires a connected QuantCalc PRO licence or Tax Season Pass; without one it returns no figures and names the free web calculator. An estimate, not a filed return and not tax advice.

  Paramètres, retour & exemple (41)

  Paramètres

  • age · integer · requis
    The age the filer reaches in 2026 (18-110).
  • state · string · requis
    Two-letter state of residence for all of 2026, or DC. States with no income tax (e.g. TX, FL) return a state tax of 0.
  • wages · number · optionnel
    The filer's 2026 wages (Form W-2 box 1). Default 0.
  • pension · number · optionnel
    Taxable 2026 pension and annuity income, the household's total. Default 0.
  • spouse_age · integer · optionnel
    Joint return only: the age the spouse reaches in 2026. Default: the same as age, stated in the result.
  • birth_month · integer · optionnel
    Filer's birth month, 1-12, optional. With it the 10% early-withdrawal tax applies only to the part of the year before 59 and a half; without it, through the year the filer reaches 59.
  • pension_type · string · optionnel · private | public
    Whether the pension is a private pension or a government (public) pension, for the state's retirement-income rules. Default private, stated in the result when a pension is given.
  • spouse_split · string · optionnel · even | filer | spouse | custom
    Joint return only: whose the IRA distributions, pension and Roth conversion are on the state return: even (half each), filer, spouse, or custom (the spouse's own amounts in spouse_ira_distributions, spouse_pension and spouse_roth_conversion, the rest the filer's). Arkansas, Delaware, Maryland, Minnesota, Missouri, North Dakota, Ohio and Virginia tax a couple by each spouse's own income, so there it can change the state tax; federal tax does not depend on it. Default even, stated in the result.
  • spouse_wages · number · optionnel
    Joint return only: the spouse's 2026 wages. Default 0.
  • filing_status · string · requis · single | mfj | mfs | hoh
    2026 filing status: single, married filing jointly (mfj), married filing separately (mfs) or head of household (hoh).
  • prior_year_agi · number · optionnel
    2025 adjusted gross income, used with prior_year_tax: above $150,000 ($75,000 married filing separately) the prior-year safe harbor is 110%.
  • prior_year_tax · number · optionnel
    Total tax on the 2025 return. With it the underpayment penalty (Form 2210) is figured and subtracted; without it the penalty is not figured, stated in the result.
  • qualified_tips · number · optionnel
    Qualified tips included in the wages, deducted on Schedule 1-A (IRC 224, up to $25,000, phased out above $150,000 / $300,000 MAGI; none married filing separately). Not more than the wages. Default 0.
  • spouse_pension · number · optionnel
    spouse_split custom only: the spouse's part of pension.
  • charitable_cash · number · optionnel
    Cash gifts to charity in 2026. The engine figures the return with the standard deduction (with the 2026 deduction for non-itemizers' cash gifts) and with the itemized deductions given, and keeps the lower tax. Default 0.
  • long_term_gains · number · optionnel
    2026 net long-term capital gain; negative for a net loss. Default 0.
  • roth_conversion · number · optionnel
    Taxable amount converted to Roth in 2026, the household's total. Default 0.
  • social_security · number · optionnel
    Gross 2026 Social Security benefits of the household (Form SSA-1099 box 5); the engine figures the taxable part. Default 0.
  • medical_expenses · number · optionnel
    Itemized deduction input: medical and dental expenses paid in 2026, before the AGI floor. Default 0.
  • short_term_gains · number · optionnel
    2026 net short-term capital gain; negative for a net loss. Default 0.
  • taxable_interest · number · optionnel
    Taxable interest (Form 1040 line 2b). Default 0.
  • ira_distributions · number · optionnel
    Taxable 2026 IRA, 401(k) and 403(b) distributions (not Roth conversions), the household's total. Default 0.
  • mortgage_interest · number · optionnel
    Itemized deduction input: home mortgage interest paid in 2026. Default 0.
  • state_withholding · number · optionnel
    State income tax withheld in 2026. Default 0.
  • estimated_payments · array · optionnel
    The 2026 federal estimated tax payments, up to four installments in order (April, June, September, January). Default none.
  • ordinary_dividends · number · optionnel
    Ordinary dividends, Form 1099-DIV box 1a (line 3b), including the qualified part. Default 0.
  • qualified_overtime · number · optionnel
    Qualified overtime compensation included in the wages: the FLSA overtime premium only (the half in time-and-a-half), deducted on Schedule 1-A (IRC 225, up to $12,500, $25,000 joint, phased out above $150,000 / $300,000 MAGI; none married filing separately). Not more than the wages. Default 0.
  • spouse_birth_month · integer · optionnel
    Joint return only: the spouse's birth month, 1-12, optional.
  • federal_withholding · number · optionnel
    Federal income tax withheld in 2026 from wages, pensions, IRA distributions and Social Security. Default 0, stated in the result.
  • qualified_dividends · number · optionnel
    The qualified part of ordinary_dividends (box 1b, line 3a), taxed at the capital-gains rates; not more than ordinary_dividends. Default 0.
  • tax_exempt_interest · number · optionnel
    Tax-exempt (municipal bond) interest (line 2a): not taxed, but counts toward the taxable part of Social Security. Default 0.
  • marketplace_coverage · boolean · optionnel
    True if the household had Marketplace (ACA) health coverage in 2026: the premium tax credit is not reconciled by this estimate and the result says so.
  • real_estate_tax_paid · number · optionnel
    Itemized deduction input: real estate tax paid in 2026. Default 0.
  • other_ordinary_income · number · optionnel
    Other ordinary income that is not investment income (Schedule 1). Default 0.
  • spouse_roth_conversion · number · optionnel
    spouse_split custom only: the spouse's part of roth_conversion.
  • spouse_ira_distributions · number · optionnel
    spouse_split custom only: the spouse's part of ira_distributions.
  • state_estimated_payments · number · optionnel
    State estimated tax paid for 2026, the total. Default 0.
  • capital_gain_distributions · number · optionnel
    Capital gain distributions from funds (Form 1099-DIV box 2a). Default 0.
  • state_local_income_tax_paid · number · optionnel
    Itemized deduction input: state and local income tax paid in 2026 (Schedule A line 5a). Default 0.
  • capital_loss_carryover_long_term · number · optionnel
    Long-term capital loss carried over from 2025, as a positive number. Default 0.
  • capital_loss_carryover_short_term · number · optionnel
    Short-term capital loss carried over from 2025, as a positive number. Default 0.

  Exemple d'appel

  {"name": "estimate_2026_tax_return", "arguments": {"age": 1, "state": "texte", "filing_status": "single"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• explain_methodology≈ 98 tokens

  Returns what the QuantCalc engine models and what it deliberately leaves out, including the tax provisions that are out of scope, and links to the published methodology.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "explain_methodology", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_return_assumption_sources≈ 95 tokens

  Returns the published capital market assumption sets the engine carries and which components each publisher provides (returns, volatilities, correlations).

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_return_assumption_sources", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• optimize_social_security_claiming≈ 3247 tokens

  Searches every Social Security claiming age from 62 (or today's age) to 70 for the household's tax-aware plan: each age's benefit is the given benefit restated by the SSA reduction and delayed-retirement-credit rules, and each age runs the full tax-aware plan on the same simulated markets as the plan's own age. The score of a path is the after-tax estate minus unfunded spending (today's dollars); the result gives each age's success rate and median paired difference against the plan, the best age, and the 10th-90th percentile range. Requires a connected QuantCalc PRO licence. Long searches return a job_id: call again with only job_id to fetch the result.

  Paramètres, retour & exemple (39)

  Paramètres

  • state · string · optionnel
    Two-letter state of residence (or DC) for state income tax with that state's retirement-income rules. When absent the result states that no state tax was modelled.
  • job_id · string · optionnel
    Only to fetch a search a previous call started: the job_id it returned. With it, no other input is read.
  • annuity · object · optionnel
    Optional: a single-life immediate annuity bought at purchase_age with premium (today's dollars) from the traditional IRA (a qualified annuity: payments fully taxable) or the taxable account (non-qualified: each payment is tax-free up to the premium over the IRS Table V multiple until the premium is recovered). Payments start in the purchase year and stop at death.
  • pension · number · optionnel
    Yearly pension income. Default 0.
  • lifespan · string · optionnel · fixed | stochastic
    fixed (default): the plan runs to its end age. stochastic: each path draws your death year from the SSA period life table and ends after it (the estate is held at its value at death; success = the money lasted while you were alive). Not on a joint return.
  • ira_basis · number · optionnel
    Optional: your Form 8606 basis (nondeductible traditional IRA contributions not yet recovered); that share of each traditional withdrawal and conversion is tax-free. Not with a per-owner traditional balance.
  • annual_qcd · number · optionnel
    Yearly qualified charitable distribution from the traditional account, in today's dollars, counted against required minimum distributions. Default 0.
  • birth_year · integer · optionnel
    Year of birth, optional. Must match current_age: 2026 minus current_age, or 2025 minus current_age when this year's birthday is still to come (then every tax rule uses the age reached in each calendar year). Sets the RMD start age (73 if born 1951-1959, 75 if born 1960 or later). Default: 2026 minus current_age, stated in the result.
  • dependents · array · optionnel
    Optional: up to 8 people you claim, each {age (at the end of 2026; negative = born later), student, disabled}. Each retirement year counts the qualifying children that year for the child tax credit (under 17), the credit for other dependents and the earned income credit, and gives them to the state return.
  • spouse_age · integer · optionnel
    Spouse's current age, for married filing jointly: sets the second aged deduction and Medicare surcharge. Default: the same as current_age, stated in the result.
  • allocations · array · optionnel
    Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0].
  • birth_month · integer · optionnel
    Month of birth, 1-12, optional. Times the half-year rules: the early-withdrawal penalty ends at 59 and a half, charitable distributions start at 70 and a half, Medicare starts in the birthday month. Default: not given, stated in the result.
  • current_age · integer · optionnel
    Current age of the primary person.
  • bucket_years · integer · optionnel
    Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10.
  • pension_type · string · optionnel · private | public
    Whether the pension is private or a government (public) pension, which several states exempt from state income tax. Only affects the tax-aware tool. Default private, and the tax-aware result states it.
  • return_model · string · optionnel · parametric | bootstrap | historical
    How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap: stationary block bootstrap of historical months. historical: replays real months from 1926 in order. The last two need a PRO licence; without one the engine runs parametric and the result says so.
  • roth_balance · number · optionnel
    Roth IRA and Roth 401(k) balance today, in dollars. 0 if none.
  • spouse_split · string · optionnel · even | filer | spouse
    Married filing jointly with a state: whose IRA withdrawals, pension and Roth conversions they are on the state return: even (half each), filer (all the filer's) or spouse (all the spouse's). Arkansas, Delaware, Maryland, Minnesota, Missouri, North Dakota, Ohio and Virginia tax a couple by each spouse's own income, so there it can change the state tax; federal tax does not depend on it. Default on a joint return with a state: even (the spouse's age is then needed; when spouse_age is not given it is current_age), stated in the result. Not used off a joint return or without a state.
  • ss_start_age · integer · optionnel
    Age Social Security starts. Default 67.
  • filing_status · string · optionnel · single | mfj | mfs | hoh
    Federal filing status: single, married filing jointly (mfj), married filing separately (mfs) or head of household (hoh).
  • inflation_rate · number · optionnel
    Annual inflation as a percent, e.g. 2.5. Default 2.5.
  • retirement_age · integer · optionnel
    Age work income stops. Defaults to current age.
  • returns_source · string · optionnel
    Which published return set to use (see list_return_assumption_sources). Default jpmorgan.
  • aca_marketplace · object · optionnel
    Optional: the household buys marketplace (ACA) health coverage in the retirement years before Medicare. Each path's premium tax credit is figured each year by the federal engine's Form 8962 at that path's own income (no credit above 400% of the poverty line; Medicaid below 138% in expansion states), and the premium after the credit is funded each year and counted by the withdrawal-order search. Needs state.
  • annual_spending · number · optionnel
    Planned yearly spending in today's dollars, after tax: what the household keeps. The engine withdraws enough each year to fund this plus that year's federal, state, Medicare-surcharge and penalty tax.
  • life_expectancy · integer · optionnel
    Age the plan must last until. Default 92.
  • roth_conversion · object · optionnel
    The household's own Roth-conversion plan: a fixed amount per year between two ages. When given, the engine applies it on every path and searches withdrawal orders around it instead of searching its own conversion programmes.
  • social_security · number · optionnel
    Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden.
  • taxable_balance · number · optionnel
    Taxable brokerage and savings today, in dollars. 0 if none. The three balances together are the portfolio.
  • cost_basis_ratio · number · optionnel
    Percentage of the taxable account that is cost basis, 0-100. Default 40, and the result says so when it is assumed.
  • pension_start_age · integer · optionnel
    Age the pension starts. Default 65.
  • medicare_start_age · integer · optionnel
    Age Medicare (and its IRMAA income surcharges) begins. Default 65. The year it begins is charged only for the months from the birthday month.
  • itemized_deductions · object · optionnel
    Optional Schedule A amounts, in today's dollars a year: each year the engine adds that year's own state and local income tax (capped with the property tax by the SALT limit), takes gifts over 0.5% of AGI and medical costs over 7.5% of AGI, and itemizes when that gives the lower tax; otherwise the standard deduction. They are deductions only, assumed to be inside annual_spending already. Mortgage interest stays fixed in dollars until its end year, property tax rises 3.5% a year, giving with inflation, medical costs with inflation. Do not include QCDs in charitable_giving. Default: none, stated in the result.
  • tax_exempt_interest · number · optionnel
    Yearly municipal-bond interest, which counts toward Social Security taxability and IRMAA income but is not itself taxed. Default 0.
  • traditional_balance · number · optionnel
    Pre-tax retirement accounts today (traditional IRA, 401(k), 403(b)), in dollars. 0 if none.
  • withdrawal_strategy · string · optionnel · fixed | guyton-klinger | vpw | bucket
    Spending rule. fixed (default): the planned amount, inflation-adjusted, every year. guyton-klinger: guardrails that cut or raise spending as the portfolio moves. vpw: variable percentage withdrawal. bucket: a cash reserve of bucket_years of spending.
  • monthly_contribution · number · optionnel
    Monthly savings until retirement. Default 0.
  • roth_contribution_basis · number · optionnel
    Optional: the part of roth_balance that is your own regular Roth IRA contributions (withdrawn first, tax-free). Giving it, roth_first_contribution_year or ira_basis turns on the Roth ordering and 5-year rules on Roth withdrawals (earnings before 59 1/2 or inside the 5-year clock are taxed, with the 10% additional tax before 59 1/2) and the Form 8606 pro-rata rule on traditional withdrawals and conversions. Default: all of roth_balance.
  • roth_first_contribution_year · integer · optionnel
    Optional: the first year you contributed to or converted into any Roth IRA (the 5-year clock), 1998-2026. Default: 2021 when roth_balance > 0.

  Exemple d'appel

  {"name": "optimize_social_security_claiming", "arguments": {"state": "texte", "job_id": "texte", "annuity": {}, "pension": 1, "lifespan": "fixed", "ira_basis": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• run_retirement_projection≈ 794 tokens

  Runs a Monte Carlo retirement projection on the QuantCalc engine and returns the success rate, the ending-portfolio distribution, and the assumptions that produced them. The result states the return model that ran, the number of paths, and the income assumptions it used, including when there are none. Income tax is not modelled by this tool; run_tax_aware_projection models it.

  Paramètres, retour & exemple (16)

  Paramètres

  • pension · number · optionnel
    Yearly pension income. Default 0.
  • allocations · array · optionnel
    Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0].
  • current_age · integer · requis
    Current age of the primary person.
  • bucket_years · integer · optionnel
    Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10.
  • return_model · string · optionnel · parametric | bootstrap | historical
    How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap: stationary block bootstrap of historical months. historical: replays real months from 1926 in order. The last two need a PRO licence; without one the engine runs parametric and the result says so.
  • ss_start_age · integer · optionnel
    Age Social Security starts. Default 67.
  • inflation_rate · number · optionnel
    Annual inflation as a percent, e.g. 2.5. Default 2.5.
  • retirement_age · integer · optionnel
    Age work income stops. Defaults to current age.
  • returns_source · string · optionnel
    Which published return set to use (see list_return_assumption_sources). Default jpmorgan.
  • annual_spending · number · requis
    Planned yearly spending in today's dollars, before income tax (this tool runs the standard engine, which does not model tax).
  • current_savings · number · requis
    Total invested portfolio today, in dollars.
  • life_expectancy · integer · optionnel
    Age the plan must last until. Default 92.
  • social_security · number · optionnel
    Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden.
  • pension_start_age · integer · optionnel
    Age the pension starts. Default 65.
  • withdrawal_strategy · string · optionnel · fixed | guyton-klinger | vpw | bucket
    Spending rule. fixed (default): the planned amount, inflation-adjusted, every year. guyton-klinger: guardrails that cut or raise spending as the portfolio moves. vpw: variable percentage withdrawal. bucket: a cash reserve of bucket_years of spending.
  • monthly_contribution · number · optionnel
    Monthly savings until retirement. Default 0.

  Exemple d'appel

  {"name": "run_retirement_projection", "arguments": {"current_age": 1, "annual_spending": 1, "current_savings": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• run_tax_aware_projection≈ 3239 tokens

  Runs the retirement projection with the household's accounts split by tax type and returns the withdrawal order and Roth-conversion programme the engine selected, its present-value advantage and range against drawing traditional first, and the after-tax success rate. Federal and state income tax (50 states and DC), Social Security taxability, required minimum distributions, Medicare IRMAA surcharges and the early-withdrawal penalty are paid from the portfolio year by year; spending is what the household keeps after tax. The result states every assumption it used, including the defaults for inputs that were not given, and what the engine does not model.

  Paramètres, retour & exemple (38)

  Paramètres

  • state · string · optionnel
    Two-letter state of residence (or DC) for state income tax with that state's retirement-income rules. When absent the result states that no state tax was modelled.
  • annuity · object · optionnel
    Optional: a single-life immediate annuity bought at purchase_age with premium (today's dollars) from the traditional IRA (a qualified annuity: payments fully taxable) or the taxable account (non-qualified: each payment is tax-free up to the premium over the IRS Table V multiple until the premium is recovered). Payments start in the purchase year and stop at death.
  • pension · number · optionnel
    Yearly pension income. Default 0.
  • lifespan · string · optionnel · fixed | stochastic
    fixed (default): the plan runs to its end age. stochastic: each path draws your death year from the SSA period life table and ends after it (the estate is held at its value at death; success = the money lasted while you were alive). Not on a joint return.
  • ira_basis · number · optionnel
    Optional: your Form 8606 basis (nondeductible traditional IRA contributions not yet recovered); that share of each traditional withdrawal and conversion is tax-free. Not with a per-owner traditional balance.
  • annual_qcd · number · optionnel
    Yearly qualified charitable distribution from the traditional account, in today's dollars, counted against required minimum distributions. Default 0.
  • birth_year · integer · optionnel
    Year of birth, optional. Must match current_age: 2026 minus current_age, or 2025 minus current_age when this year's birthday is still to come (then every tax rule uses the age reached in each calendar year). Sets the RMD start age (73 if born 1951-1959, 75 if born 1960 or later). Default: 2026 minus current_age, stated in the result.
  • dependents · array · optionnel
    Optional: up to 8 people you claim, each {age (at the end of 2026; negative = born later), student, disabled}. Each retirement year counts the qualifying children that year for the child tax credit (under 17), the credit for other dependents and the earned income credit, and gives them to the state return.
  • spouse_age · integer · optionnel
    Spouse's current age, for married filing jointly: sets the second aged deduction and Medicare surcharge. Default: the same as current_age, stated in the result.
  • allocations · array · optionnel
    Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0].
  • birth_month · integer · optionnel
    Month of birth, 1-12, optional. Times the half-year rules: the early-withdrawal penalty ends at 59 and a half, charitable distributions start at 70 and a half, Medicare starts in the birthday month. Default: not given, stated in the result.
  • current_age · integer · requis
    Current age of the primary person.
  • bucket_years · integer · optionnel
    Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10.
  • pension_type · string · optionnel · private | public
    Whether the pension is private or a government (public) pension, which several states exempt from state income tax. Only affects the tax-aware tool. Default private, and the tax-aware result states it.
  • return_model · string · optionnel · parametric | bootstrap | historical
    How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap: stationary block bootstrap of historical months. historical: replays real months from 1926 in order. The last two need a PRO licence; without one the engine runs parametric and the result says so.
  • roth_balance · number · requis
    Roth IRA and Roth 401(k) balance today, in dollars. 0 if none.
  • spouse_split · string · optionnel · even | filer | spouse
    Married filing jointly with a state: whose IRA withdrawals, pension and Roth conversions they are on the state return: even (half each), filer (all the filer's) or spouse (all the spouse's). Arkansas, Delaware, Maryland, Minnesota, Missouri, North Dakota, Ohio and Virginia tax a couple by each spouse's own income, so there it can change the state tax; federal tax does not depend on it. Default on a joint return with a state: even (the spouse's age is then needed; when spouse_age is not given it is current_age), stated in the result. Not used off a joint return or without a state.
  • ss_start_age · integer · optionnel
    Age Social Security starts. Default 67.
  • filing_status · string · requis · single | mfj | mfs | hoh
    Federal filing status: single, married filing jointly (mfj), married filing separately (mfs) or head of household (hoh).
  • inflation_rate · number · optionnel
    Annual inflation as a percent, e.g. 2.5. Default 2.5.
  • retirement_age · integer · optionnel
    Age work income stops. Defaults to current age.
  • returns_source · string · optionnel
    Which published return set to use (see list_return_assumption_sources). Default jpmorgan.
  • aca_marketplace · object · optionnel
    Optional: the household buys marketplace (ACA) health coverage in the retirement years before Medicare. Each path's premium tax credit is figured each year by the federal engine's Form 8962 at that path's own income (no credit above 400% of the poverty line; Medicaid below 138% in expansion states), and the premium after the credit is funded each year and counted by the withdrawal-order search. Needs state.
  • annual_spending · number · requis
    Planned yearly spending in today's dollars, after tax: what the household keeps. The engine withdraws enough each year to fund this plus that year's federal, state, Medicare-surcharge and penalty tax.
  • life_expectancy · integer · optionnel
    Age the plan must last until. Default 92.
  • roth_conversion · object · optionnel
    The household's own Roth-conversion plan: a fixed amount per year between two ages. When given, the engine applies it on every path and searches withdrawal orders around it instead of searching its own conversion programmes.
  • social_security · number · optionnel
    Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden.
  • taxable_balance · number · requis
    Taxable brokerage and savings today, in dollars. 0 if none. The three balances together are the portfolio.
  • cost_basis_ratio · number · optionnel
    Percentage of the taxable account that is cost basis, 0-100. Default 40, and the result says so when it is assumed.
  • pension_start_age · integer · optionnel
    Age the pension starts. Default 65.
  • medicare_start_age · integer · optionnel
    Age Medicare (and its IRMAA income surcharges) begins. Default 65. The year it begins is charged only for the months from the birthday month.
  • itemized_deductions · object · optionnel
    Optional Schedule A amounts, in today's dollars a year: each year the engine adds that year's own state and local income tax (capped with the property tax by the SALT limit), takes gifts over 0.5% of AGI and medical costs over 7.5% of AGI, and itemizes when that gives the lower tax; otherwise the standard deduction. They are deductions only, assumed to be inside annual_spending already. Mortgage interest stays fixed in dollars until its end year, property tax rises 3.5% a year, giving with inflation, medical costs with inflation. Do not include QCDs in charitable_giving. Default: none, stated in the result.
  • tax_exempt_interest · number · optionnel
    Yearly municipal-bond interest, which counts toward Social Security taxability and IRMAA income but is not itself taxed. Default 0.
  • traditional_balance · number · requis
    Pre-tax retirement accounts today (traditional IRA, 401(k), 403(b)), in dollars. 0 if none.
  • withdrawal_strategy · string · optionnel · fixed | guyton-klinger | vpw | bucket
    Spending rule. fixed (default): the planned amount, inflation-adjusted, every year. guyton-klinger: guardrails that cut or raise spending as the portfolio moves. vpw: variable percentage withdrawal. bucket: a cash reserve of bucket_years of spending.
  • monthly_contribution · number · optionnel
    Monthly savings until retirement. Default 0.
  • roth_contribution_basis · number · optionnel
    Optional: the part of roth_balance that is your own regular Roth IRA contributions (withdrawn first, tax-free). Giving it, roth_first_contribution_year or ira_basis turns on the Roth ordering and 5-year rules on Roth withdrawals (earnings before 59 1/2 or inside the 5-year clock are taxed, with the 10% additional tax before 59 1/2) and the Form 8606 pro-rata rule on traditional withdrawals and conversions. Default: all of roth_balance.
  • roth_first_contribution_year · integer · optionnel
    Optional: the first year you contributed to or converted into any Roth IRA (the 5-year clock), 1998-2026. Default: 2021 when roth_balance > 0.

  Exemple d'appel

  {"name": "run_tax_aware_projection", "arguments": {"current_age": 1, "roth_balance": 1, "filing_status": "single", "annual_spending": 1, "taxable_balance": 1, "traditional_balance": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://mcp.quantcalc.app