{"data":{"name":"app.quantcalc/retirement-engine","title":"QuantCalc Retirement Engine","description":"Retirement Monte Carlo, tax-aware withdrawals, 2026 tax calculators, RMD, IRMAA, every-state tax.","version":"1.10.0","websiteUrl":"https://quantcalc.app/advisors/mcp/","repositoryUrl":"https://github.com/quantcalc-app/quantcalc-mcp-plugin","remotes":[{"type":"streamable-http","url":"https://mcp.quantcalc.app"}],"packages":[],"status":"active","isLatest":true,"publishedAt":"2026-11-10T11:40:16.067Z","updatedAt":"2026-11-10T11:40:16.067Z","source":"official-registry","verification":"official","confidence":100,"stars":null,"sources":[{"source":"official-registry","sourceId":"app.quantcalc/retirement-engine","verification":"official","confidence":100,"stars":null,"updatedAt":"2026-11-10T11:40:16.067Z","title":"QuantCalc Retirement Engine","description":"Retirement Monte Carlo, tax-aware withdrawals, 2026 tax calculators, RMD, IRMAA, every-state tax.","websiteUrl":"https://quantcalc.app/advisors/mcp/","repositoryUrl":"https://github.com/quantcalc-app/quantcalc-mcp-plugin"}],"toolIndex":{"tools":[{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"aca_premium_tax_credit","title":"2027 ACA marketplace benchmark, poverty line and the 400% cliff","description":"Returns a household's 2027 ACA marketplace position from its state, the ages on the plan, household size and income: the county's benchmark (second-lowest-cost silver) premium from CMS's plan-year-2027 files for the HealthCare.gov states, or a given one; the poverty line that sets 2027 credits (2026 HHS guidelines) and the income as a percentage of it; the 400% cliff income and the headroom below it or the amount over it; and whether the income is below the Medicaid line of an expansion state or below the poverty line. The premium tax credit itself is not figured. Not tax advice.","inputSchema":{"type":"object","properties":{"coverage_year":{"type":"integer","enum":[2027],"description":"The coverage year: 2027 (the CMS county benchmark, the poverty line, the 400% cliff and the headroom, from published data)."},"state":{"type":"string","description":"Two-letter state of residence, or DC."},"county":{"type":"string","description":"The county (name, e.g. Miami-Dade, or 5-digit FIPS code) whose CMS plan-year-2027 benchmark premium is read; published for the HealthCare.gov states. Default: none, stated in the result."},"ages":{"type":"array","items":{"type":"integer"},"minItems":1,"maxItems":12,"description":"The ages of the people on the marketplace plan. Ages 21-64 are priced; 65 and over (Medicare) and under 21 are not."},"household_size":{"type":"integer","description":"Tax family size for the poverty line (the filer, a spouse on a joint return, dependents). Default: the number of ages given, stated in the result."},"income":{"type":"number","description":"The household's modified AGI for the credit: AGI plus tax-exempt interest plus the Social Security not taxed, for the coverage year."},"benchmark_monthly":{"type":"number","description":"The household's own monthly benchmark (second-lowest-cost silver) premium for the people on the plan, from healthcare.gov or the state's marketplace. Default: the county's CMS figure when county is given; stated in the result."}},"required":["coverage_year","state","ages","income"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"c532b67503a083378ed4c70ada22c1935cf0d85882cc0e89098047feade0d18c","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"calculate_rmd","title":"Required minimum distribution (RMD) for 2026 or 2027","description":"Computes the required minimum distribution for 2026 or 2027 from the prior year-end balance and the age or birth year, on the IRS Uniform Lifetime Table, or the Joint and Last Survivor Table when the spouse is the sole beneficiary and more than 10 years younger; returns the divisor, the deadline, the SECURE 2.0 start age (73, or 75 for those born 1960 or later), the first-year April 1 option and the two RMDs it stacks into one year, and a multi-year projection with growth. The same figures as the website's RMD calculator.","inputSchema":{"type":"object","properties":{"balance_prior_year_end":{"type":"number","description":"The traditional IRA (or plan) balance on December 31 of the year before the distribution year."},"year":{"type":"integer","description":"The distribution year: 2026 or 2027 (the same Uniform Lifetime Table). Default 2026."},"age":{"type":"integer","description":"The age the owner reaches by December 31 of the distribution year."},"birth_year":{"type":"integer","description":"The owner's birth year; when given it is used instead of age."},"spouse_sole_beneficiary":{"type":"boolean","description":"The spouse is the sole beneficiary all year: when the spouse is more than 10 years younger the Joint and Last Survivor Table applies. Needs spouse_age. Default false."},"spouse_age":{"type":"integer","description":"The spouse's age reached in the distribution year, for the Joint and Last Survivor Table: read with spouse_sole_beneficiary."},"growth_rate_percent":{"type":"number","description":"Annual growth of the balance for the projection and the delayed-first-RMD figure, in percent (5 = 5%). Default 0."},"projection_years":{"type":"integer","description":"Years in the projection, 1-30. Default 10."}},"required":["balance_prior_year_end","age"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"f52b3d663e666c5411af82cf581083fd29f18c61ee2580b8a7f09c2a840a0a87","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"compare_return_assumptions","title":"Compare published return assumptions","description":"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, which the reply states in its first line.","inputSchema":{"type":"object","properties":{"current_age":{"type":"integer","description":"Current age of the primary person."},"retirement_age":{"type":"integer","description":"Age work income stops. Defaults to current age."},"life_expectancy":{"type":"integer","description":"Age the plan must last until. Default 92."},"current_savings":{"type":"number","description":"Total invested portfolio today, in dollars."},"annual_spending":{"type":"number","description":"Planned yearly spending in today's dollars, before income tax (this tool runs the standard engine, which does not model tax)."},"monthly_contribution":{"type":"number","description":"Monthly savings until retirement. Default 0."},"social_security":{"type":"number","description":"Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden."},"ss_start_age":{"type":"integer","description":"Age Social Security starts. Default 67."},"pension":{"type":"number","description":"Yearly pension income. Default 0."},"pension_start_age":{"type":"integer","description":"Age the pension starts. Default 65."},"inflation_rate":{"type":"number","description":"Annual inflation as a percent, e.g. 2.5. Default 2.5."},"allocations":{"type":"array","items":{"type":"number"},"minItems":5,"maxItems":5,"description":"Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0]."},"returns_source":{"type":"string","description":"Which published return set to use (see list_return_assumption_sources). Default jpmorgan."},"return_model":{"type":"string","enum":["parametric","bootstrap","historical"],"description":"How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap (stationary block bootstrap of historical months) and historical (real months from 1926 replayed in order) can be requested, but on this connection the engine runs parametric instead and the result says so."},"withdrawal_strategy":{"type":"string","enum":["fixed","guyton-klinger","vpw","bucket"],"description":"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."},"bucket_years":{"type":"integer","description":"Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10."},"spending_confidence":{"type":"integer","enum":[75,80,85,90,95],"description":"The success rate the 'sustainable spending' answer is solved at: the most this plan can spend each year and still succeed on at least this percentage of paths, with the same answer if every balance were 20% lower or higher today. One of 75, 80, 85, 90, 95. Default 90."},"sources":{"type":"array","items":{"type":"string"},"description":"Source ids to compare. Defaults to all."}},"required":[]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"fb5c149b5914e4e06b4c6ddbbbf456fe7d3a09310c34f2739daeab54cfcb430f","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"explain_methodology","title":"What the engine models, and what it does not","description":"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.","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"68b9f1fb695ebf467e72c3a91c19ea00ab47aa4b1d0b2ff0664b2f59ddb4cb55","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"ira_deduction_and_roth_limit","title":"Traditional IRA deduction and Roth IRA limit at a modified AGI (2026 or 2027)","description":"Runs IRS Publication 590-A Worksheet 1-2 (the deductible part of a traditional IRA contribution when you or your spouse is covered by a plan at work) and Worksheet 2-2 (the reduced Roth IRA contribution limit) for 2026 or 2027 on a given modified AGI, line by line, with the age-50 catch-up, the compensation cap, the spousal IRA rule and the worksheets' rounding and minimum; returns the deductible and nondeductible parts of a traditional contribution, the Roth IRA limit and the Roth room left. The limits and ranges are the website's IRA and Roth income-limit pages' own figures (the 2027 limit and ranges are the IRS's published figures, IRS Notice 2026-66). Not tax advice.","inputSchema":{"type":"object","properties":{"filing_status":{"type":"string","enum":["single","mfj","hoh","mfs","mfs_apart"],"description":"single, mfj, hoh, mfs (lived with the spouse at some time in the year) or mfs_apart (married filing separately, lived apart all year: treated as unmarried)."},"age":{"type":"integer","description":"Your age on December 31 of the tax year (18-110): 50 or older adds the catch-up."},"covered":{"type":"boolean","description":"You are covered by a retirement plan at work (the W-2 'Retirement plan' box). Default false."},"spouse_covered":{"type":"boolean","description":"mfj or mfs: your spouse is covered by a plan at work. Default false."},"magi":{"type":"number","description":"Modified AGI: the income the worksheets run on."},"wages":{"type":"number","description":"Your wages (W-2 box 1): your compensation, which caps the contribution. Default: the MAGI is taken as your compensation."},"spouse_wages":{"type":"number","description":"Joint return only: the spouse's wages. Default 0."},"contribution_type":{"type":"string","enum":["traditional","roth"],"description":"traditional (default): the deductible and nondeductible parts of the contribution. roth: your Roth IRA limit at this MAGI."},"amount":{"type":"number","description":"The contribution for the year. Default: your full limit."},"spouse_ira_contributions":{"type":"number","description":"Joint return only: the spouse's own IRA contributions (the spousal IRA rule). Default 0."},"tax_year":{"type":"integer","description":"2026 (default) or 2027. 2027: the limits and phase-out ranges are the IRS's published 2027 figures (IRS Notice 2026-66), as the 2027 pages print them. Stated in the result."}},"required":["filing_status","age","magi"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"92e9da226e337c229eef8f50f7c66e65c3fc066c3858579cf37a856a4c9d6d33","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"irmaa_check","title":"Medicare IRMAA tier for a MAGI","description":"Returns the Medicare IRMAA tier a MAGI sets: the official 2026 tier (from 2024 MAGI) and the 2027 and 2028 tiers (from 2025 and 2026 MAGI) on the tables as QuantCalc projects them, labelled projected; with each the monthly Part B and Part D surcharge per person, the annual total for the people on Medicare, and the distance to the next tier. Reads the same CMS tables as the website's IRMAA calculator.","inputSchema":{"type":"object","properties":{"magi":{"type":"number","description":"Modified AGI (AGI plus tax-exempt interest) of the 2024 return, which sets the 2026 premiums; also used for 2025 and 2026 unless they are given."},"filing_status":{"type":"string","enum":["single","mfj","mfs","hoh"],"description":"Filing status: single, married filing jointly (mfj), married filing separately (mfs) or head of household (hoh)."},"magi_2025":{"type":"number","description":"2025 MAGI, which sets the 2027 premiums. Default: magi."},"magi_2026":{"type":"number","description":"2026 MAGI, which sets the 2028 premiums. Default: magi."},"both_spouses_on_medicare":{"type":"boolean","description":"Joint return only: both spouses are on Medicare (the surcharge is per person). Default true, stated."},"cpi_assumption_percent":{"type":"number","enum":[2,2.5,3],"description":"The CPI-U assumption of the projected 2028 floors and the 2027-2028 surcharge amounts: 2.0, 2.5 (default) or 3.0. The 2027 floors do not depend on it: they come from the published CPI-U, as on /irmaa-brackets-2027/."}},"required":["magi","filing_status"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"887082d1f258c737b96d076e2ae5a1e1445c3a450bfebda52b2477a430248b3a","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"list_return_assumption_sources","title":"List available return assumption sets","description":"Returns the published capital market assumption sets the engine carries and which components each publisher provides (returns, volatilities, correlations).","inputSchema":{"type":"object","properties":{}},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"5b29205119dd830d58aa314ca573bbcbe17eb07f193b6bb211c7d02fde73e0ed","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"retirement_plan_deferral_savings","title":"401(k), 403(b), 457(b), TSP or SIMPLE IRA deferral limit at an age (2026 or 2027)","description":"Returns the 2026 or 2027 elective-deferral limit for a 401(k), 403(b), governmental 457(b), the TSP or a SIMPLE IRA at an age: the base limit, the age-50 and ages 60-63 catch-ups, the SIMPLE higher limit, a non-governmental 457(b) without a catch-up, the part of the catch-up the Roth catch-up wage rule sends in as Roth, and the amount a deferral is figured on when it is over the limit or over the wages. It states that a deferral saves no Social Security or Medicare tax. The limits are the website's contribution-limit pages' own figures (the 2027 limits are the IRS's published figures, IRS Notice 2026-66). Not tax advice.","inputSchema":{"type":"object","properties":{"plan":{"type":"string","enum":["401k","403b","457b","tsp","simple"],"description":"The workplace plan: 401(k), 403(b), governmental 457(b), the TSP, or a SIMPLE IRA."},"age":{"type":"integer","description":"Your age on December 31 of the tax year (18-110): sets the catch-up (50+, and the higher catch-up in the years you turn 60 to 63)."},"wages":{"type":"number","description":"Your wages before the contribution (more than 0): the deferral comes out of them."},"amount":{"type":"number","description":"The pre-tax deferral for the year. Default: your full limit at your age. Over the limit or over your wages it is figured on the lower."},"tax_year":{"type":"integer","description":"2026 (default) or 2027. 2027: the limits and phase-out ranges are the IRS's published 2027 figures (IRS Notice 2026-66), as the 2027 pages print them. Stated in the result."},"roth_catchup":{"type":"boolean","description":"Not for simple: true when your prior-year Social Security wages from this employer were over the year's threshold, so the catch-up must go in as Roth (no tax saved now). Default: whether wages are over the threshold, stated in the result."},"higher_limit_simple":{"type":"boolean","description":"simple only: the employer uses the SECURE 2.0 higher-limit SIMPLE."},"non_governmental_457":{"type":"boolean","description":"457b only: a tax-exempt (non-governmental) employer's 457(b), which has no catch-up."}},"required":["plan","age","wages"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"46af7ecabfcdc058e908d4865122461b635d9f75fb4073ea071c195d73d793c3","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"run_retirement_projection","title":"Run a retirement projection","description":"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.","inputSchema":{"type":"object","properties":{"current_age":{"type":"integer","description":"Current age of the primary person."},"retirement_age":{"type":"integer","description":"Age work income stops. Defaults to current age."},"life_expectancy":{"type":"integer","description":"Age the plan must last until. Default 92."},"current_savings":{"type":"number","description":"Total invested portfolio today, in dollars."},"annual_spending":{"type":"number","description":"Planned yearly spending in today's dollars, before income tax (this tool runs the standard engine, which does not model tax)."},"monthly_contribution":{"type":"number","description":"Monthly savings until retirement. Default 0."},"social_security":{"type":"number","description":"Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden."},"ss_start_age":{"type":"integer","description":"Age Social Security starts. Default 67."},"pension":{"type":"number","description":"Yearly pension income. Default 0."},"pension_start_age":{"type":"integer","description":"Age the pension starts. Default 65."},"inflation_rate":{"type":"number","description":"Annual inflation as a percent, e.g. 2.5. Default 2.5."},"allocations":{"type":"array","items":{"type":"number"},"minItems":5,"maxItems":5,"description":"Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0]."},"returns_source":{"type":"string","description":"Which published return set to use (see list_return_assumption_sources). Default jpmorgan."},"return_model":{"type":"string","enum":["parametric","bootstrap","historical"],"description":"How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap (stationary block bootstrap of historical months) and historical (real months from 1926 replayed in order) can be requested, but on this connection the engine runs parametric instead and the result says so."},"withdrawal_strategy":{"type":"string","enum":["fixed","guyton-klinger","vpw","bucket"],"description":"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."},"bucket_years":{"type":"integer","description":"Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10."},"spending_confidence":{"type":"integer","enum":[75,80,85,90,95],"description":"The success rate the 'sustainable spending' answer is solved at: the most this plan can spend each year and still succeed on at least this percentage of paths, with the same answer if every balance were 20% lower or higher today. One of 75, 80, 85, 90, 95. Default 90."}},"required":["current_age","current_savings","annual_spending"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"52de1eaa22495bd7ace75c7d3e3b4f8a594dce183642c902daf3a8f0f9052a80","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"run_tax_aware_projection","title":"Tax-aware projection with the recommended withdrawal order","description":"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.","inputSchema":{"type":"object","properties":{"current_age":{"type":"integer","description":"Current age of the primary person."},"retirement_age":{"type":"integer","description":"Age work income stops. Defaults to current age."},"life_expectancy":{"type":"integer","description":"Age the plan must last until. Default 92."},"annual_spending":{"type":"number","description":"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."},"monthly_contribution":{"type":"number","description":"Monthly savings until retirement. Default 0."},"social_security":{"type":"number","description":"Yearly Social Security in today's dollars. Default 0 — and 0 is reported as an explicit assumption, not hidden."},"ss_start_age":{"type":"integer","description":"Age Social Security starts. Default 67."},"pension":{"type":"number","description":"Yearly pension income. Default 0."},"pension_start_age":{"type":"integer","description":"Age the pension starts. Default 65."},"inflation_rate":{"type":"number","description":"Annual inflation as a percent, e.g. 2.5. Default 2.5."},"allocations":{"type":"array","items":{"type":"number"},"minItems":5,"maxItems":5,"description":"Percentages summing to 100: [US stocks, international stocks, bonds, real estate, cash]. Default [60,10,25,5,0]."},"returns_source":{"type":"string","description":"Which published return set to use (see list_return_assumption_sources). Default jpmorgan."},"return_model":{"type":"string","enum":["parametric","bootstrap","historical"],"description":"How returns are generated. parametric (default): the forward-looking published assumptions. bootstrap (stationary block bootstrap of historical months) and historical (real months from 1926 replayed in order) can be requested, but on this connection the engine runs parametric instead and the result says so."},"withdrawal_strategy":{"type":"string","enum":["fixed","guyton-klinger","vpw","bucket"],"description":"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."},"bucket_years":{"type":"integer","description":"Only with withdrawal_strategy bucket: years of spending held in the cash bucket, 1-10."},"spending_confidence":{"type":"integer","enum":[75,80,85,90,95],"description":"The success rate the 'sustainable spending' answer is solved at: the most this plan can spend each year and still succeed on at least this percentage of paths, with the same answer if every balance were 20% lower or higher today. One of 75, 80, 85, 90, 95. Default 90."},"pension_type":{"type":"string","enum":["private","public"],"description":"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."},"traditional_balance":{"type":"number","description":"Pre-tax retirement accounts today (traditional IRA, 401(k), 403(b)), in dollars. 0 if none."},"roth_balance":{"type":"number","description":"Roth IRA and Roth 401(k) balance today, in dollars. 0 if none."},"taxable_balance":{"type":"number","description":"Taxable brokerage and savings today, in dollars. 0 if none. The three balances together are the portfolio."},"filing_status":{"type":"string","enum":["single","mfj","mfs","hoh"],"description":"Federal filing status: single, married filing jointly (mfj), married filing separately (mfs) or head of household (hoh)."},"state":{"type":"string","description":"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."},"move_state":{"type":"object","description":"A planned move to another state: the household lives in `state` until the first day of `month` of `year`, then in move_state.state. The plan uses the old state's income tax before the move year, the new state's after it, and a part-year return in each in the move year (each state's own part-year rules, the year's income split by days). The result compares the lifetime state tax with the move against staying and against moving now. Needs `state`.","properties":{"state":{"type":"string","description":"Two-letter state moved to (or DC); not Washington."},"year":{"type":"integer","description":"Calendar year of the move, 2026 to the plan's last year."},"month":{"type":"integer","description":"Month of the move, 1-12 (the move on the 1st). Default 7. 1 = the whole move year in the new state."}},"required":["state","year"]},"cost_basis_ratio":{"type":"number","description":"Percentage of the taxable account that is cost basis, 0-100. Default 40, and the result says so when it is assumed."},"spouse_age":{"type":"integer","description":"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."},"medicare_start_age":{"type":"integer","description":"Age Medicare (and its IRMAA income surcharges) begins. Default 65. The year it begins is charged only for the months from the birthday month."},"birth_year":{"type":"integer","description":"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."},"birth_month":{"type":"integer","description":"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."},"annual_qcd":{"type":"number","description":"Yearly qualified charitable distribution from the traditional account, in today's dollars, counted against required minimum distributions. Default 0."},"roth_conversion":{"type":"object","description":"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.","properties":{"annual_amount":{"type":"number","description":"Dollars converted per year, today's dollars."},"start_age":{"type":"integer"},"end_age":{"type":"integer"}},"required":["annual_amount","start_age","end_age"]},"tax_exempt_interest":{"type":"number","description":"Yearly municipal-bond interest, which counts toward Social Security taxability and IRMAA income but is not itself taxed. Default 0."},"early_withdrawal_exception":{"type":"boolean","description":"True when an exception to the 10% additional tax on early distributions covers the household's traditional withdrawals before 59 1/2 (the rule of 55 for the 401(k) of an employer left in or after the year of turning 55, disability, ...). The engine holds one traditional balance, so it applies to all of it; substantially equal periodic payments (72(t)) are not modelled. Default false: the 10% tax is charged."},"aca_marketplace":{"type":"object","description":"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.","properties":{"spending_includes_premium":{"type":"boolean","description":"Required. true: annual_spending already includes the full, unsubsidized benchmark premium (it is taken out and the premium after the credit paid instead); false: the premium after the credit is paid on top of annual_spending."},"benchmark_premium":{"type":"number","description":"The household's 2026 annual benchmark (second-lowest-cost silver) premium at its 2026 ages, from healthcare.gov or the state's marketplace. Default: the state-average model, stated in the result."},"household_size":{"type":"integer","description":"Tax family size for the poverty line (you, a spouse on a joint return, dependents). Default 2 on a joint return, else 1."},"cover_spouse":{"type":"boolean","description":"Joint return: the spouse is on the plan too. Default true."}},"required":["spending_includes_premium"]},"itemized_deductions":{"type":"object","description":"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.","properties":{"mortgage_interest":{"type":"number","description":"Deductible home mortgage interest per year."},"mortgage_interest_end_year":{"type":"integer","description":"Last calendar year with mortgage interest. Default: every year."},"property_tax":{"type":"number","description":"Real estate tax on the home per year."},"charitable_giving":{"type":"number","description":"Cash gifts to charity per year, not counting QCDs."},"medical_expenses":{"type":"number","description":"Unreimbursed medical and dental costs per year, before the 7.5% floor."}}},"roth_contribution_basis":{"type":"number","description":"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":{"type":"integer","description":"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."},"ira_basis":{"type":"number","description":"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."},"dependents":{"type":"array","description":"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.","items":{"type":"object","properties":{"age":{"type":"integer"},"student":{"type":"boolean"},"disabled":{"type":"boolean"}},"required":["age"]}},"lifespan":{"type":"string","enum":["fixed","stochastic"],"description":"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."},"annuity":{"type":"object","description":"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.","properties":{"purchase_age":{"type":"integer","description":"Age at purchase, in retirement."},"premium":{"type":"number","description":"Single premium in today's dollars."},"source":{"type":"string","enum":["traditional","taxable"]},"payout_rate":{"type":"number","description":"First year's payments as a percent of the premium (from a quote)."},"cola":{"type":"number","description":"Fixed yearly increase of the payment in percent. Default 0."}},"required":["purchase_age","premium","source","payout_rate"]},"spouse_split":{"type":"string","enum":["even","filer","spouse"],"description":"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."}},"required":["current_age","annual_spending","traditional_balance","roth_balance","taxable_balance","filing_status"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"cb07e395daef2f0d2e28004c08daf9409ec9889016478d342a68d8f3e39e8886","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"},{"serverName":"app.quantcalc/retirement-engine","endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","name":"standard_deduction_vs_itemizing","title":"Standard deduction piece by piece (2026 or 2027)","description":"Returns the 2026 or 2027 standard deduction piece by piece: the basic amount for the filing status, the additional amount for each person 65 or older or blind, a dependent's limit, and the rule that a married person filing separately whose spouse itemizes must itemize; with anyone 65 or older it also states the senior deduction's maximum before its phase-out. The amounts are the website's standard deduction pages' own figures (2027: the IRS's published amounts, Rev. Proc. 2026-35). Not tax advice.","inputSchema":{"type":"object","properties":{"filing_status":{"type":"string","enum":["single","mfj","mfs","hoh"],"description":"Filing status: single, married filing jointly (mfj), married filing separately (mfs) or head of household (hoh)."},"age":{"type":"integer","description":"Your age on December 31 of the tax year (0-120): 65 or older adds the additional amount and the senior deduction."},"spouse_age":{"type":"integer","description":"Joint return only: the spouse's age. Default: the same as age."},"blind":{"type":"boolean","description":"You are blind. Default false."},"spouse_blind":{"type":"boolean","description":"Joint return only: the spouse is blind. Default false."},"dependent":{"type":"boolean","description":"Not on a joint return: someone else can claim you as a dependent (the basic amount is limited, IRC 63(c)(5)). Default false."},"spouse_itemizes":{"type":"boolean","description":"mfs only: your spouse itemizes on a separate return, so you must too."},"wages":{"type":"number","description":"Your wages (a dependent's earned income). Default 0."},"tax_year":{"type":"integer","description":"2026 (default) or 2027. 2027: the IRS's published 2027 standard deduction, additional amounts and dependent limit (Rev. Proc. 2026-35). Stated in the result."}},"required":["filing_status","age"]},"annotations":{"readOnlyHint":true,"openWorldHint":true},"definitionHash":"c99af450831294a42e4357ef0e125b56f0b4b4ca17e5eb7f99c40c98df308f95","schemaStatus":"valid","origin":"official-registry","observedAt":"2026-11-14T09:46:37.931Z","metadataTrust":"untrusted"}],"endpoints":[{"endpointFingerprint":"361b7cdcec52470253d4568d8373bd06b5a4f63aaec887a40a99c0878bd94d3e","protocol":"streamable-http","status":"indexed","toolCount":11,"observedAt":"2026-11-14T09:46:37.931Z"}],"authentication":"unknown"},"connectionConfigurations":{"status":"ready","authentication":"not embedded","clients":{"Claude Desktop":{"mcpServers":{"app.quantcalc/retirement-engine":{"url":"https://mcp.quantcalc.app/"}}},"Cursor":{"mcpServers":{"app.quantcalc/retirement-engine":{"url":"https://mcp.quantcalc.app/"}}},"VS Code":{"servers":{"app.quantcalc/retirement-engine":{"type":"http","url":"https://mcp.quantcalc.app/"}}}}},"resourceType":"mcp-server","callable":true,"runtime":{"callable":true,"protocols":["mcp"]},"interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.quantcalc.app"}],"profile":{"apiVersion":"1","schemaVersion":"1","id":"mcp-server:app.quantcalc%2Fretirement-engine","resourceType":"mcp-server","canonicalUrl":"https://www.agentsjunction.com/api/v1/servers/app.quantcalc%2Fretirement-engine","name":"app.quantcalc/retirement-engine","description":"Retirement Monte Carlo, tax-aware withdrawals, 2026 tax calculators, RMD, IRMAA, every-state tax.","interfaces":[{"protocol":"mcp","transport":"streamable-http","url":"https://mcp.quantcalc.app"}],"capabilities":[],"identity":{"source":"official-registry","websiteUrl":"https://quantcalc.app/advisors/mcp/","repositoryUrl":"https://github.com/quantcalc-app/quantcalc-mcp-plugin","version":"1.10.0"},"verification":{"state":"official","confidence":100},"operations":{"resourceType":"mcp-server","name":"app.quantcalc/retirement-engine","status":"online","lastCheckedAt":"2026-11-20T05:17:44.251Z","lastSuccessfulCheck":"2026-11-20T05:17:44.251Z","latencyMs":130,"consecutiveFailures":0,"isStale":false,"checks":{"endpointReachable":true,"protocolValid":true,"agentCardValid":null,"mcpHandshakeValid":true},"lastSeen":null,"lastSuccessfulInteraction":null,"lastHealthCheck":"2026-11-20T05:17:44.251Z","source":{"type":"health-check","url":null},"observedAt":"2026-11-20T05:17:44.251Z"},"security":null,"timestamps":{"createdAt":"2026-11-10T11:40:16.067Z","updatedAt":"2026-11-10T11:40:16.067Z","observedAt":"2026-11-20T05:17:44.251Z"},"compatibility":{"serverVersion":"1.10.0","protocolVersions":[{"protocol":"mcp","version":null}]}}}}