US retirement withdrawal tax planner: draw order, Roth conversion room, IRMAA, ACA line, and RMDs.
Maintained bydipperfield.com(verified)Also a maintainer?
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Answers "how much can I convert without losing the ACA subsidy" and "how close am I to the ACA subsidy cliff": the 400%-of-poverty line for a household size and coverage year, the room under it, the expected contribution, and with a benchmark silver premium the premium tax credit and what filling the room costs. Also "do I get cost-sharing reductions" and "how low does my income need to be for a better silver plan": the CSR tier (94%, 87% or 73% silver up to 250% of poverty) with its out-of-pocket maximum and room to the tier line; with a state, whether Medicaid or a Basic Health Program covers that income instead, and the Alaska or Hawaii guideline. Read-only.
Household MAGI for the premium tax credit (AGI plus tax-exempt interest and non-taxable Social Security) before any Roth conversion, US dollars a year.
People in the tax household.
Two-letter state code, if known. Sets Medicaid (expansion states up to 138% FPL), Basic Health Programs (MN, NY, OR, DC up to 200% FPL) and the Alaska and Hawaii poverty guidelines.
Marketplace coverage year (2026 or 2027). Defaults to 2026.
Second-lowest-cost silver plan premium a month for the household, if known; adds the credit in dollars.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http dipperfield https://mcp.dipperfield.com/mcp
Answers "how much can I convert without losing the ACA subsidy" and "how close am I to the ACA subsidy cliff": the 400%-of-poverty line for a household size and coverage year, the room under it, the expected contribution, and with a benchmark silver premium the premium tax credit and what filling the room costs. Also "do I get cost-sharing reductions" and "how low does my income need to be for a better silver plan": the CSR tier (94%, 87% or 73% silver up to 250% of poverty) with its out-of-pocket maximum and room to the tier line; with a state, whether Medicaid or a Basic Health Program covers that income instead, and the Alaska or Hawaii guideline. Read-only.
| Argument | Type | Description |
|---|---|---|
| magi* | number | Household MAGI for the premium tax credit (AGI plus tax-exempt interest and non-taxable Social Security) before any Roth conversion, US dollars a year. |
| state | string | Two-letter state code, if known. Sets Medicaid (expansion states up to 138% FPL), Basic Health Programs (MN, NY, OR, DC up to 200% FPL) and the Alaska and Hawaii poverty guidelines. |
| coverageYear | integer | Marketplace coverage year (2026 or 2027). Defaults to 2026. |
| householdSize* | integer | People in the tax household. |
| benchmarkMonthly | number | Second-lowest-cost silver plan premium a month for the household, if known; adds the credit in dollars. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"householdSize",
"magi"
],
"properties": {
"magi": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Household MAGI for the premium tax credit (AGI plus tax-exempt interest and non-taxable Social Security) before any Roth conversion, US dollars a year."
},
"state": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"type": "string",
"description": "Two-letter state code, if known. Sets Medicaid (expansion states up to 138% FPL), Basic Health Programs (MN, NY, OR, DC up to 200% FPL) and the Alaska and Hawaii poverty guidelines."
},
"coverageYear": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Marketplace coverage year (2026 or 2027). Defaults to 2026."
},
"householdSize": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "People in the tax household."
},
"benchmarkMonthly": {
"type": "number",
"maximum": 1000000,
"minimum": 0,
"description": "Second-lowest-cost silver plan premium a month for the household, if known; adds the credit in dollars."
}
}
}The signed-in Dipperfield account: its email, subscription state, whether the subscriber tools (roth_conversion_path, year_end_check, save_plan) are available, whether save_plan saves straight to the account, and which email reminders it is signed up for. Read-only.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Signs the signed-in user up for a Dipperfield email reminder, sent to the account’s email. Every email has a one-click unsubscribe. Free for every account. account_status says which reminders the user is already on.
| Argument | Type | Description |
|---|---|---|
| topic* | string | year-end: two emails, November 20 and December 15, to run the year-end check and finish Roth conversions before December 31. irmaa-table: one email the day Medicare publishes next year’s IRMAA brackets. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"year-end",
"irmaa-table"
],
"type": "string",
"description": "year-end: two emails, November 20 and December 15, to run the year-end check and finish Roth conversions before December 31. irmaa-table: one email the day Medicare publishes next year’s IRMAA brackets."
}
}
}Takes the signed-in user off a Dipperfield email reminder. account_status says which reminders the user is on.
| Argument | Type | Description |
|---|---|---|
| topic* | string | year-end: two emails, November 20 and December 15, to run the year-end check and finish Roth conversions before December 31. irmaa-table: one email the day Medicare publishes next year’s IRMAA brackets. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"topic"
],
"properties": {
"topic": {
"enum": [
"year-end",
"irmaa-table"
],
"type": "string",
"description": "year-end: two emails, November 20 and December 15, to run the year-end check and finish Roth conversions before December 31. irmaa-table: one email the day Medicare publishes next year’s IRMAA brackets."
}
}
}Answers "will my income trigger IRMAA" and "how far am I from the next IRMAA bracket": the Medicare Part B and Part D income-related surcharge tier for a MAGI and filing status, the monthly and yearly surcharge, and the room before the next tier. The tax year’s MAGI sets premiums two years later, so the latest published CMS tiers stand in as an estimate. Read-only.
| Argument | Type | Description |
|---|---|---|
| magi* | number | Modified adjusted gross income for IRMAA (AGI plus tax-exempt interest) of the tax year, US dollars a year. |
| year | integer | Tax year. Defaults to 2026, the latest year with published tables. |
| people | integer | People on Medicare in the household: 1 or 2 (2 only when filing jointly). Defaults to 2 for mfj, 1 for single. |
| filingStatus* | string | Federal filing status: single, or mfj (married filing jointly). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filingStatus",
"magi"
],
"properties": {
"magi": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Modified adjusted gross income for IRMAA (AGI plus tax-exempt interest) of the tax year, US dollars a year."
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tax year. Defaults to 2026, the latest year with published tables."
},
"people": {
"type": "integer",
"maximum": 2,
"minimum": 1,
"description": "People on Medicare in the household: 1 or 2 (2 only when filing jointly). Defaults to 2 for mfj, 1 for single."
},
"filingStatus": {
"enum": [
"single",
"mfj"
],
"type": "string",
"description": "Federal filing status: single, or mfj (married filing jointly)."
}
}
}Answers "which account should I withdraw from first" and "how much should I take from my IRA, brokerage, cash and Roth this year" for a US retiree household. From income, spending and balances it computes this tax year’s withdrawal mix: RMDs first, then traditional or taxable draws up to the lines the user wants to stay under (ACA subsidy line, an IRMAA tier, the top of a federal bracket, the 0% capital gains ceiling), then cash and Roth, with an optional Roth conversion. For each traditional account at RMD age, ask for the preceding December 31 statement balance; never substitute the current balance. Do not ask before RMD age. Returns the amount from each account in order, federal and covered state tax, AGI and MAGI, room under each line, the tables used, and a link that opens the plan on dipperfield.com. One tax year; read-only.
| Argument | Type | Description |
|---|---|---|
| cash | number | Cash available to spend, US dollars. |
| roth | number | Roth IRA balance, US dollars. |
| year | integer | Tax year. Defaults to 2026, the latest year with published tables. |
| lines | array | Lines to stay under, highest priority first, e.g. ["aca", "bracket-12"]. Taxable withdrawals stop at the tightest line; cash and Roth cover the rest. |
| state | string | State of residence, two-letter code. Leave out for federal figures only. |
| wages | number | Wages, US dollars a year. Default 0. |
| pensions | number | Pensions and annuities, US dollars a year. Default 0. |
| spending* | number | After-tax spending the year must fund, US dollars a year. |
| birthYear* | integer | Your birth year. |
| fillOrder | string | Which taxable source to draw first. Default traditional-first. |
| lineMargin | number | Dollars to stay under every line, room for dividends or interest that land late in the year. Default 0. |
| convertUpTo | string | Also convert to Roth up to this line; it must be one of `lines`. |
| harvestUpTo | string | After the conversion, realize long-term gain in the taxable account (sell and buy back) up to this line; it must be one of `lines`, usually ltcg-zero. |
| traditional | number | Your traditional IRA and 401(k) balance, US dollars. |
| filingStatus* | string | Federal filing status: single, or mfj (married filing jointly). |
| convertAmount | number | Also convert this fixed amount to Roth, US dollars. |
| otherOrdinary | number | Other ordinary income, US dollars a year. Default 0. |
| socialSecurity | number | Gross household Social Security benefits, US dollars a year. Default 0. |
| taxableBalance | number | Taxable brokerage account balance, US dollars. |
| spouseBirthYear | integer | Spouse's birth year; required when filing jointly. |
| taxableInterest | number | Taxable interest, US dollars a year. Default 0. |
| acaHouseholdSize | integer | Household size for the aca line. Defaults to 2 when filing jointly, 1 otherwise. |
| taxableCostBasis | number | Cost basis of the taxable account; required when it has a balance, US dollars. |
| spouseTraditional | number | Spouse's traditional IRA and 401(k) balance (joint filers), US dollars. |
| taxExemptInterest | number | Tax-exempt interest, US dollars a year. Default 0. |
| qualifiedDividends | number | Qualified dividends, US dollars a year. Default 0. |
| nonQualifiedDividends | number | Non-qualified dividends, US dollars a year. Default 0. |
| traditionalPriorYearEnd | number | Your traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at RMD age when traditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
| spouseTraditionalPriorYearEnd | number | Spouse's traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at their RMD age when spouseTraditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filingStatus",
"birthYear",
"spending"
],
"properties": {
"cash": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cash available to spend, US dollars."
},
"roth": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Roth IRA balance, US dollars."
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tax year. Defaults to 2026, the latest year with published tables."
},
"lines": {
"type": "array",
"items": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "A line to stay under: bracket-N = top of the N% federal bracket; ltcg-zero = 0% long-term capital gains ceiling; irmaa-N = below Medicare IRMAA tier N (estimate); aca = ACA premium tax credit line at 400% of the poverty guideline."
},
"maxItems": 8,
"description": "Lines to stay under, highest priority first, e.g. [\"aca\", \"bracket-12\"]. Taxable withdrawals stop at the tightest line; cash and Roth cover the rest."
},
"state": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"type": "string",
"description": "State of residence, two-letter code. Leave out for federal figures only."
},
"wages": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Wages, US dollars a year. Default 0."
},
"pensions": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Pensions and annuities, US dollars a year. Default 0."
},
"spending": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "After-tax spending the year must fund, US dollars a year."
},
"birthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Your birth year."
},
"fillOrder": {
"enum": [
"traditional-first",
"taxable-first"
],
"type": "string",
"description": "Which taxable source to draw first. Default traditional-first."
},
"lineMargin": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Dollars to stay under every line, room for dividends or interest that land late in the year. Default 0."
},
"convertUpTo": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "Also convert to Roth up to this line; it must be one of `lines`."
},
"harvestUpTo": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "After the conversion, realize long-term gain in the taxable account (sell and buy back) up to this line; it must be one of `lines`, usually ltcg-zero."
},
"traditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional IRA and 401(k) balance, US dollars."
},
"filingStatus": {
"enum": [
"single",
"mfj"
],
"type": "string",
"description": "Federal filing status: single, or mfj (married filing jointly)."
},
"convertAmount": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Also convert this fixed amount to Roth, US dollars."
},
"otherOrdinary": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Other ordinary income, US dollars a year. Default 0."
},
"socialSecurity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Gross household Social Security benefits, US dollars a year. Default 0."
},
"taxableBalance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable brokerage account balance, US dollars."
},
"spouseBirthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Spouse's birth year; required when filing jointly."
},
"taxableInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable interest, US dollars a year. Default 0."
},
"acaHouseholdSize": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Household size for the aca line. Defaults to 2 when filing jointly, 1 otherwise."
},
"taxableCostBasis": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cost basis of the taxable account; required when it has a balance, US dollars."
},
"spouseTraditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional IRA and 401(k) balance (joint filers), US dollars."
},
"taxExemptInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Tax-exempt interest, US dollars a year. Default 0."
},
"qualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Qualified dividends, US dollars a year. Default 0."
},
"nonQualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Non-qualified dividends, US dollars a year. Default 0."
},
"traditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at RMD age when traditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
},
"spouseTraditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at their RMD age when spouseTraditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
}
}
}Answers "what is my RMD this year" and "when do my RMDs start": an IRA owner’s required minimum distribution from last December 31’s balance and birth year (IRS Uniform Lifetime Table, SECURE 2.0 start ages), its due date and the first RMD year. Owner accounts only; a sole-beneficiary spouse more than 10 years younger uses the Joint and Last Survivor table (Table II); inherited IRAs are not covered. Read-only.
| Argument | Type | Description |
|---|---|---|
| year | integer | Tax year of the distribution. Defaults to 2026, the latest year with published tables. |
| birthYear* | integer | The IRA owner's birth year. |
| spouseBirthYear | integer | The spouse's birth year; needed when the spouse is the sole beneficiary. |
| priorYearEndBalance* | number | Traditional IRA balance on December 31 of the year before, US dollars. |
| spouseSoleBeneficiary | boolean | The owner's spouse is the sole designated beneficiary all year. Default false. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"birthYear",
"priorYearEndBalance"
],
"properties": {
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tax year of the distribution. Defaults to 2026, the latest year with published tables."
},
"birthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "The IRA owner's birth year."
},
"spouseBirthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "The spouse's birth year; needed when the spouse is the sole beneficiary."
},
"priorYearEndBalance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Traditional IRA balance on December 31 of the year before, US dollars."
},
"spouseSoleBeneficiary": {
"type": "boolean",
"description": "The owner's spouse is the sole designated beneficiary all year. Default false."
}
}
}Answers "how much can I convert to Roth this year", "Roth conversion IRMAA" and "how much can I convert without losing the ACA subsidy": the largest Roth conversion that stays under a chosen line (an IRMAA tier, the ACA 400% line, the top of a federal bracket, the 0% capital gains ceiling), or the effect of a given amount. At RMD age, ask for priorYearEndBalance from the preceding December 31 statement; never substitute the current balance. Do not ask before RMD age. Returns the added federal tax, the estimated RMD taken first, and where AGI and MAGI land against the IRMAA, ACA and bracket lines, with the tables used. Federal tax only; one tax year; read-only.
| Argument | Type | Description |
|---|---|---|
| age* | integer | Your age on December 31. |
| line* | string | The line the conversion must stay under (see the other choices for its meaning). Example: irmaa-1 to convert without triggering an IRMAA surcharge, aca to keep the ACA premium tax credit, bracket-12 to fill the 12% bracket. |
| year | integer | Tax year. Defaults to 2026, the latest year with published tables. |
| amount | number | A specific conversion to check instead of the largest one under the line, US dollars. |
| margin | number | Dollars to stay under the line, room for dividends or interest that land late in the year. Default 0. |
| interest | number | Taxable interest and non-qualified dividends, US dollars a year. Default 0. |
| spouseAge | integer | Spouse's age on December 31; required when filing jointly. |
| traditional* | number | Current traditional IRA or 401(k) balance to convert from, counted as yours, US dollars. |
| filingStatus* | string | Federal filing status: single, or mfj (married filing jointly). |
| wagesPensions | number | Wages, pensions and annuities, US dollars a year. Default 0. |
| socialSecurity | number | Gross household Social Security benefits, US dollars a year. Default 0. |
| qualifiedDividends | number | Qualified dividends, US dollars a year. Default 0. |
| priorYearEndBalance | number | Balance on December 31 before the tax year (IRS Pub. 590-B). Required at or after your RMD start age; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filingStatus",
"age",
"traditional",
"line"
],
"properties": {
"age": {
"type": "integer",
"maximum": 120,
"minimum": 18,
"description": "Your age on December 31."
},
"line": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "The line the conversion must stay under (see the other choices for its meaning). Example: irmaa-1 to convert without triggering an IRMAA surcharge, aca to keep the ACA premium tax credit, bracket-12 to fill the 12% bracket."
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tax year. Defaults to 2026, the latest year with published tables."
},
"amount": {
"type": "number",
"maximum": 10000000000,
"minimum": 0,
"description": "A specific conversion to check instead of the largest one under the line, US dollars."
},
"margin": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Dollars to stay under the line, room for dividends or interest that land late in the year. Default 0."
},
"interest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable interest and non-qualified dividends, US dollars a year. Default 0."
},
"spouseAge": {
"type": "integer",
"maximum": 120,
"minimum": 18,
"description": "Spouse's age on December 31; required when filing jointly."
},
"traditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Current traditional IRA or 401(k) balance to convert from, counted as yours, US dollars."
},
"filingStatus": {
"enum": [
"single",
"mfj"
],
"type": "string",
"description": "Federal filing status: single, or mfj (married filing jointly)."
},
"wagesPensions": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Wages, pensions and annuities, US dollars a year. Default 0."
},
"socialSecurity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Gross household Social Security benefits, US dollars a year. Default 0."
},
"qualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Qualified dividends, US dollars a year. Default 0."
},
"priorYearEndBalance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Balance on December 31 before the tax year (IRS Pub. 590-B). Required at or after your RMD start age; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
}
}
}Answers "how much should I convert to Roth each year to keep my RMDs down" for a subscriber: a year-by-year Roth conversion path from the latest tax year toward a goal (the first RMD at or under an amount, or the traditional balance at an age at or under an amount), either the smallest constant annual conversion that meets it or converting up to a chosen line each year. Each year shows the conversion, RMD, balances and the cost of converting (income tax, IRMAA surcharge two years later, and with a marketplace benchmark the ACA credit given up). Tables are held at the latest published year, amounts in today’s dollars; the real return is the user’s assumption. Read-only.
| Argument | Type | Description |
|---|---|---|
| roth | number | Roth IRA balance, US dollars. |
| state | string | State of residence, two-letter code. Leave out for federal figures only. |
| maxRmd | number | Largest acceptable first RMD, in today’s dollars (target rmd-at-start-age), US dollars. |
| target* | string | The goal: rmd-at-start-age = keep the first required minimum distribution (the year the account owner reaches the RMD start age) at or under maxRmd; balance-at-age = bring the owner’s traditional balance at the end of the year they reach targetAge to or under maxBalance. |
| pensions | number | Your pensions and annuities, today's dollars, US dollars a year. Default 0. |
| birthYear* | integer | Your birth year. |
| targetAge | integer | Owner’s age for the balance target (target balance-at-age). |
| fillToLine | string | Convert each year up to this line instead of the same amount every year. Leave out for the smallest constant annual conversion that meets the target. |
| maxBalance | number | Largest acceptable traditional balance at targetAge, in today’s dollars (target balance-at-age), US dollars. |
| realReturn* | number | Real (after-inflation) annual return on the traditional and Roth balances, as a decimal: 0.03 is 3%. The user's assumption; ask for it. |
| convertFrom | string | Whose traditional account the conversions come from. Default you. |
| moveToState | string | A move to another state, resident there from moveFromYear on. |
| filingStatus* | string | Federal filing status: single, or mfj (married filing jointly). |
| moveFromYear | integer | |
| otherOrdinary | number | Other ordinary income, every year, US dollars a year. Default 0. |
| socialSecurity | number | Your Social Security benefit, today's dollars, US dollars a year. Default 0. |
| spousePensions | number | Spouse's pensions and annuities, today's dollars, US dollars a year. Default 0. |
| spouseBirthYear | integer | Spouse's birth year; required when filing jointly. |
| taxableInterest | number | Taxable interest, every year, US dollars a year. Default 0. |
| acaHouseholdSize | integer | Marketplace (ACA) coverage before Medicare: tax household size. With acaBenchmarkMonthly, the premium tax credit a conversion gives up is counted. |
| pensionsStartYear | integer | First tax year your pension is received. Default: already received in 2026. |
| taxExemptInterest | number | Tax-exempt interest, every year, US dollars a year. Default 0. |
| qualifiedDividends | number | Qualified dividends, every year, US dollars a year. Default 0. |
| acaBenchmarkMonthly | number | Benchmark (second-lowest-cost silver) premium a month for everyone on the plan in 2026, US dollars. |
| spouseSocialSecurity | number | Spouse's Social Security benefit, today's dollars, US dollars a year. Default 0. |
| nonQualifiedDividends | number | Non-qualified dividends, every year, US dollars a year. Default 0. |
| socialSecurityStartYear | integer | First tax year your Social Security is received. Default: already received in 2026. |
| spousePensionsStartYear | integer | First tax year the spouse's pension is received. Default: already received in 2026. |
| traditionalPriorYearEnd* | number | Your traditional IRA and 401(k) balance on December 31, 2025, from the year-end statement, US dollars. |
| socialSecurityCutPercent | number | Stress scenario the user sets, not a forecast: Social Security pays this percent less from socialSecurityCutFromYear on. |
| socialSecurityCutFromYear | integer | |
| spouseSocialSecurityStartYear | integer | First tax year the spouse's Social Security is received. Default: already received in 2026. |
| spouseTraditionalPriorYearEnd | number | Spouse's traditional balance on December 31, 2025 (joint filers), US dollars. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filingStatus",
"birthYear",
"traditionalPriorYearEnd",
"realReturn",
"target"
],
"properties": {
"roth": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Roth IRA balance, US dollars."
},
"state": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"type": "string",
"description": "State of residence, two-letter code. Leave out for federal figures only."
},
"maxRmd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Largest acceptable first RMD, in today’s dollars (target rmd-at-start-age), US dollars."
},
"target": {
"enum": [
"rmd-at-start-age",
"balance-at-age"
],
"type": "string",
"description": "The goal: rmd-at-start-age = keep the first required minimum distribution (the year the account owner reaches the RMD start age) at or under maxRmd; balance-at-age = bring the owner’s traditional balance at the end of the year they reach targetAge to or under maxBalance."
},
"pensions": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your pensions and annuities, today's dollars, US dollars a year. Default 0."
},
"birthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Your birth year."
},
"targetAge": {
"type": "integer",
"maximum": 105,
"minimum": 50,
"description": "Owner’s age for the balance target (target balance-at-age)."
},
"fillToLine": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "Convert each year up to this line instead of the same amount every year. Leave out for the smallest constant annual conversion that meets the target."
},
"maxBalance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Largest acceptable traditional balance at targetAge, in today’s dollars (target balance-at-age), US dollars."
},
"realReturn": {
"type": "number",
"maximum": 0.2,
"minimum": -0.5,
"description": "Real (after-inflation) annual return on the traditional and Roth balances, as a decimal: 0.03 is 3%. The user's assumption; ask for it."
},
"convertFrom": {
"enum": [
"you",
"spouse"
],
"type": "string",
"description": "Whose traditional account the conversions come from. Default you."
},
"moveToState": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"type": "string",
"description": "A move to another state, resident there from moveFromYear on."
},
"filingStatus": {
"enum": [
"single",
"mfj"
],
"type": "string",
"description": "Federal filing status: single, or mfj (married filing jointly)."
},
"moveFromYear": {
"type": "integer",
"maximum": 2100,
"minimum": 2000
},
"otherOrdinary": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Other ordinary income, every year, US dollars a year. Default 0."
},
"socialSecurity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your Social Security benefit, today's dollars, US dollars a year. Default 0."
},
"spousePensions": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's pensions and annuities, today's dollars, US dollars a year. Default 0."
},
"spouseBirthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Spouse's birth year; required when filing jointly."
},
"taxableInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable interest, every year, US dollars a year. Default 0."
},
"acaHouseholdSize": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Marketplace (ACA) coverage before Medicare: tax household size. With acaBenchmarkMonthly, the premium tax credit a conversion gives up is counted."
},
"pensionsStartYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1950,
"description": "First tax year your pension is received. Default: already received in 2026."
},
"taxExemptInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Tax-exempt interest, every year, US dollars a year. Default 0."
},
"qualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Qualified dividends, every year, US dollars a year. Default 0."
},
"acaBenchmarkMonthly": {
"type": "number",
"maximum": 100000,
"minimum": 0,
"description": "Benchmark (second-lowest-cost silver) premium a month for everyone on the plan in 2026, US dollars."
},
"spouseSocialSecurity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's Social Security benefit, today's dollars, US dollars a year. Default 0."
},
"nonQualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Non-qualified dividends, every year, US dollars a year. Default 0."
},
"socialSecurityStartYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1950,
"description": "First tax year your Social Security is received. Default: already received in 2026."
},
"spousePensionsStartYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1950,
"description": "First tax year the spouse's pension is received. Default: already received in 2026."
},
"traditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional IRA and 401(k) balance on December 31, 2025, from the year-end statement, US dollars."
},
"socialSecurityCutPercent": {
"type": "number",
"maximum": 100,
"minimum": 0,
"description": "Stress scenario the user sets, not a forecast: Social Security pays this percent less from socialSecurityCutFromYear on."
},
"socialSecurityCutFromYear": {
"type": "integer",
"maximum": 2100,
"minimum": 2000
},
"spouseSocialSecurityStartYear": {
"type": "integer",
"maximum": 2100,
"minimum": 1950,
"description": "First tax year the spouse's Social Security is received. Default: already received in 2026."
},
"spouseTraditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional balance on December 31, 2025 (joint filers), US dollars."
}
}
}Saves a plan_this_year plan (same inputs, plus an optional title) to the signed-in user’s Dipperfield account. It is encrypted before it leaves this server so only the user’s browser can open it, and it joins their saved plans the next time they open them with their passphrase. Needs a Dipperfield subscription. Until the user has saved one plan on dipperfield.com, it returns a link to save the plan there instead. Call it only when the user asks to save. Give each save a requestId and reuse it when retrying that save, so a retry does not save twice.
| Argument | Type | Description |
|---|---|---|
| cash | number | Cash available to spend, US dollars. |
| roth | number | Roth IRA balance, US dollars. |
| year | integer | Tax year. Defaults to 2026, the latest year with published tables. |
| lines | array | Lines to stay under, highest priority first, e.g. ["aca", "bracket-12"]. Taxable withdrawals stop at the tightest line; cash and Roth cover the rest. |
| state | string | State of residence, two-letter code. Leave out for federal figures only. |
| title | string | A short name for the saved plan, shown in the user’s Dipperfield account. Default "<year> withdrawal plan". |
| wages | number | Wages, US dollars a year. Default 0. |
| pensions | number | Pensions and annuities, US dollars a year. Default 0. |
| spending* | number | After-tax spending the year must fund, US dollars a year. |
| birthYear* | integer | Your birth year. |
| fillOrder | string | Which taxable source to draw first. Default traditional-first. |
| requestId | string | An id for this save, 8 to 64 letters, digits, "_" or "-". Reuse the same id when retrying the same save; a new save gets a new id. |
| lineMargin | number | Dollars to stay under every line, room for dividends or interest that land late in the year. Default 0. |
| convertUpTo | string | Also convert to Roth up to this line; it must be one of `lines`. |
| harvestUpTo | string | After the conversion, realize long-term gain in the taxable account (sell and buy back) up to this line; it must be one of `lines`, usually ltcg-zero. |
| traditional | number | Your traditional IRA and 401(k) balance, US dollars. |
| filingStatus* | string | Federal filing status: single, or mfj (married filing jointly). |
| convertAmount | number | Also convert this fixed amount to Roth, US dollars. |
| otherOrdinary | number | Other ordinary income, US dollars a year. Default 0. |
| socialSecurity | number | Gross household Social Security benefits, US dollars a year. Default 0. |
| taxableBalance | number | Taxable brokerage account balance, US dollars. |
| spouseBirthYear | integer | Spouse's birth year; required when filing jointly. |
| taxableInterest | number | Taxable interest, US dollars a year. Default 0. |
| acaHouseholdSize | integer | Household size for the aca line. Defaults to 2 when filing jointly, 1 otherwise. |
| taxableCostBasis | number | Cost basis of the taxable account; required when it has a balance, US dollars. |
| spouseTraditional | number | Spouse's traditional IRA and 401(k) balance (joint filers), US dollars. |
| taxExemptInterest | number | Tax-exempt interest, US dollars a year. Default 0. |
| qualifiedDividends | number | Qualified dividends, US dollars a year. Default 0. |
| nonQualifiedDividends | number | Non-qualified dividends, US dollars a year. Default 0. |
| traditionalPriorYearEnd | number | Your traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at RMD age when traditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
| spouseTraditionalPriorYearEnd | number | Spouse's traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at their RMD age when spouseTraditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filingStatus",
"birthYear",
"spending"
],
"properties": {
"cash": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cash available to spend, US dollars."
},
"roth": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Roth IRA balance, US dollars."
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tax year. Defaults to 2026, the latest year with published tables."
},
"lines": {
"type": "array",
"items": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "A line to stay under: bracket-N = top of the N% federal bracket; ltcg-zero = 0% long-term capital gains ceiling; irmaa-N = below Medicare IRMAA tier N (estimate); aca = ACA premium tax credit line at 400% of the poverty guideline."
},
"maxItems": 8,
"description": "Lines to stay under, highest priority first, e.g. [\"aca\", \"bracket-12\"]. Taxable withdrawals stop at the tightest line; cash and Roth cover the rest."
},
"state": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"type": "string",
"description": "State of residence, two-letter code. Leave out for federal figures only."
},
"title": {
"type": "string",
"maxLength": 80,
"minLength": 1,
"description": "A short name for the saved plan, shown in the user’s Dipperfield account. Default \"<year> withdrawal plan\"."
},
"wages": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Wages, US dollars a year. Default 0."
},
"pensions": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Pensions and annuities, US dollars a year. Default 0."
},
"spending": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "After-tax spending the year must fund, US dollars a year."
},
"birthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Your birth year."
},
"fillOrder": {
"enum": [
"traditional-first",
"taxable-first"
],
"type": "string",
"description": "Which taxable source to draw first. Default traditional-first."
},
"requestId": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,64}$",
"description": "An id for this save, 8 to 64 letters, digits, \"_\" or \"-\". Reuse the same id when retrying the same save; a new save gets a new id."
},
"lineMargin": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Dollars to stay under every line, room for dividends or interest that land late in the year. Default 0."
},
"convertUpTo": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "Also convert to Roth up to this line; it must be one of `lines`."
},
"harvestUpTo": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "After the conversion, realize long-term gain in the taxable account (sell and buy back) up to this line; it must be one of `lines`, usually ltcg-zero."
},
"traditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional IRA and 401(k) balance, US dollars."
},
"filingStatus": {
"enum": [
"single",
"mfj"
],
"type": "string",
"description": "Federal filing status: single, or mfj (married filing jointly)."
},
"convertAmount": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Also convert this fixed amount to Roth, US dollars."
},
"otherOrdinary": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Other ordinary income, US dollars a year. Default 0."
},
"socialSecurity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Gross household Social Security benefits, US dollars a year. Default 0."
},
"taxableBalance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable brokerage account balance, US dollars."
},
"spouseBirthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Spouse's birth year; required when filing jointly."
},
"taxableInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable interest, US dollars a year. Default 0."
},
"acaHouseholdSize": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Household size for the aca line. Defaults to 2 when filing jointly, 1 otherwise."
},
"taxableCostBasis": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cost basis of the taxable account; required when it has a balance, US dollars."
},
"spouseTraditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional IRA and 401(k) balance (joint filers), US dollars."
},
"taxExemptInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Tax-exempt interest, US dollars a year. Default 0."
},
"qualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Qualified dividends, US dollars a year. Default 0."
},
"nonQualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Non-qualified dividends, US dollars a year. Default 0."
},
"traditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at RMD age when traditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
},
"spouseTraditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at their RMD age when spouseTraditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
}
}
}Answers "am I on track this year" and "how much more can I convert before December 31" for a subscriber: this year’s plan (the same inputs as plan_this_year) against what was actually withdrawn, sold and converted so far. Give traditional balances as of the start of the year, or today’s balance plus what was already taken. Returns how tax, AGI and MAGI moved from the plan, the RMD still to take, and engine-computed options for the rest of the year: the plan’s remaining conversion, no more conversion, and converting up to each line, with the added tax of each. Read-only.
| Argument | Type | Description |
|---|---|---|
| cash | number | Cash available to spend, US dollars. |
| roth | number | Roth IRA balance, US dollars. |
| year | integer | Tax year. Defaults to 2026, the latest year with published tables. |
| lines | array | Lines to stay under, highest priority first, e.g. ["aca", "bracket-12"]. Taxable withdrawals stop at the tightest line; cash and Roth cover the rest. |
| state | string | State of residence, two-letter code. Leave out for federal figures only. |
| wages | number | Wages, US dollars a year. Default 0. |
| cashUsed | number | Cash spent so far this year, US dollars. Default 0. |
| pensions | number | Pensions and annuities, US dollars a year. Default 0. |
| spending* | number | After-tax spending the year must fund, US dollars a year. |
| birthYear* | integer | Your birth year. |
| fillOrder | string | Which taxable source to draw first. Default traditional-first. |
| lineMargin | number | Dollars to stay under every line, room for dividends or interest that land late in the year. Default 0. |
| convertUpTo | string | Also convert to Roth up to this line; it must be one of `lines`. |
| harvestUpTo | string | After the conversion, realize long-term gain in the taxable account (sell and buy back) up to this line; it must be one of `lines`, usually ltcg-zero. |
| taxableSold | number | Sold from the taxable account so far this year, US dollars. Default 0. |
| traditional | number | Your traditional IRA and 401(k) balance, US dollars. |
| filingStatus* | string | Federal filing status: single, or mfj (married filing jointly). |
| convertAmount | number | Also convert this fixed amount to Roth, US dollars. |
| otherOrdinary | number | Other ordinary income, US dollars a year. Default 0. |
| rothWithdrawn | number | Withdrawn from Roth so far this year, US dollars. Default 0. |
| socialSecurity | number | Gross household Social Security benefits, US dollars a year. Default 0. |
| taxableBalance | number | Taxable brokerage account balance, US dollars. |
| spouseBirthYear | integer | Spouse's birth year; required when filing jointly. |
| taxableInterest | number | Taxable interest, US dollars a year. Default 0. |
| acaHouseholdSize | integer | Household size for the aca line. Defaults to 2 when filing jointly, 1 otherwise. |
| taxableCostBasis | number | Cost basis of the taxable account; required when it has a balance, US dollars. |
| spouseTraditional | number | Spouse's traditional IRA and 401(k) balance (joint filers), US dollars. |
| taxExemptInterest | number | Tax-exempt interest, US dollars a year. Default 0. |
| qualifiedDividends | number | Qualified dividends, US dollars a year. Default 0. |
| traditionalConverted | number | Converted to Roth from your traditional accounts so far this year, US dollars. Default 0. |
| traditionalWithdrawn | number | Withdrawn from your traditional accounts (RMD included) so far this year, US dollars. Default 0. |
| nonQualifiedDividends | number | Non-qualified dividends, US dollars a year. Default 0. |
| traditionalPriorYearEnd | number | Your traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at RMD age when traditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
| spouseTraditionalConverted | number | Converted to Roth from the spouse's traditional accounts so far this year, US dollars. Default 0. |
| spouseTraditionalWithdrawn | number | Withdrawn from the spouse's traditional accounts (RMD included) so far this year, US dollars. Default 0. |
| spouseTraditionalPriorYearEnd | number | Spouse's traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at their RMD age when spouseTraditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"filingStatus",
"birthYear",
"spending"
],
"properties": {
"cash": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cash available to spend, US dollars."
},
"roth": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Roth IRA balance, US dollars."
},
"year": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Tax year. Defaults to 2026, the latest year with published tables."
},
"lines": {
"type": "array",
"items": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "A line to stay under: bracket-N = top of the N% federal bracket; ltcg-zero = 0% long-term capital gains ceiling; irmaa-N = below Medicare IRMAA tier N (estimate); aca = ACA premium tax credit line at 400% of the poverty guideline."
},
"maxItems": 8,
"description": "Lines to stay under, highest priority first, e.g. [\"aca\", \"bracket-12\"]. Taxable withdrawals stop at the tightest line; cash and Roth cover the rest."
},
"state": {
"enum": [
"AL",
"AK",
"AZ",
"AR",
"CA",
"CO",
"CT",
"DE",
"DC",
"FL",
"GA",
"HI",
"ID",
"IL",
"IN",
"IA",
"KS",
"KY",
"LA",
"ME",
"MD",
"MA",
"MI",
"MN",
"MS",
"MO",
"MT",
"NE",
"NV",
"NH",
"NJ",
"NM",
"NY",
"NC",
"ND",
"OH",
"OK",
"OR",
"PA",
"RI",
"SC",
"SD",
"TN",
"TX",
"UT",
"VT",
"VA",
"WA",
"WV",
"WI",
"WY"
],
"type": "string",
"description": "State of residence, two-letter code. Leave out for federal figures only."
},
"wages": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Wages, US dollars a year. Default 0."
},
"cashUsed": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cash spent so far this year, US dollars. Default 0."
},
"pensions": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Pensions and annuities, US dollars a year. Default 0."
},
"spending": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "After-tax spending the year must fund, US dollars a year."
},
"birthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Your birth year."
},
"fillOrder": {
"enum": [
"traditional-first",
"taxable-first"
],
"type": "string",
"description": "Which taxable source to draw first. Default traditional-first."
},
"lineMargin": {
"type": "number",
"maximum": 10000000,
"minimum": 0,
"description": "Dollars to stay under every line, room for dividends or interest that land late in the year. Default 0."
},
"convertUpTo": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "Also convert to Roth up to this line; it must be one of `lines`."
},
"harvestUpTo": {
"enum": [
"bracket-10",
"bracket-12",
"bracket-22",
"bracket-24",
"bracket-32",
"bracket-35",
"ltcg-zero",
"irmaa-1",
"irmaa-2",
"irmaa-3",
"irmaa-4",
"irmaa-5",
"aca"
],
"type": "string",
"description": "After the conversion, realize long-term gain in the taxable account (sell and buy back) up to this line; it must be one of `lines`, usually ltcg-zero."
},
"taxableSold": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Sold from the taxable account so far this year, US dollars. Default 0."
},
"traditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional IRA and 401(k) balance, US dollars."
},
"filingStatus": {
"enum": [
"single",
"mfj"
],
"type": "string",
"description": "Federal filing status: single, or mfj (married filing jointly)."
},
"convertAmount": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Also convert this fixed amount to Roth, US dollars."
},
"otherOrdinary": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Other ordinary income, US dollars a year. Default 0."
},
"rothWithdrawn": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Withdrawn from Roth so far this year, US dollars. Default 0."
},
"socialSecurity": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Gross household Social Security benefits, US dollars a year. Default 0."
},
"taxableBalance": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable brokerage account balance, US dollars."
},
"spouseBirthYear": {
"type": "integer",
"maximum": 2010,
"minimum": 1900,
"description": "Spouse's birth year; required when filing jointly."
},
"taxableInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Taxable interest, US dollars a year. Default 0."
},
"acaHouseholdSize": {
"type": "integer",
"maximum": 20,
"minimum": 1,
"description": "Household size for the aca line. Defaults to 2 when filing jointly, 1 otherwise."
},
"taxableCostBasis": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Cost basis of the taxable account; required when it has a balance, US dollars."
},
"spouseTraditional": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional IRA and 401(k) balance (joint filers), US dollars."
},
"taxExemptInterest": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Tax-exempt interest, US dollars a year. Default 0."
},
"qualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Qualified dividends, US dollars a year. Default 0."
},
"traditionalConverted": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Converted to Roth from your traditional accounts so far this year, US dollars. Default 0."
},
"traditionalWithdrawn": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Withdrawn from your traditional accounts (RMD included) so far this year, US dollars. Default 0."
},
"nonQualifiedDividends": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Non-qualified dividends, US dollars a year. Default 0."
},
"traditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Your traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at RMD age when traditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
},
"spouseTraditionalConverted": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Converted to Roth from the spouse's traditional accounts so far this year, US dollars. Default 0."
},
"spouseTraditionalWithdrawn": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Withdrawn from the spouse's traditional accounts (RMD included) so far this year, US dollars. Default 0."
},
"spouseTraditionalPriorYearEnd": {
"type": "number",
"maximum": 1000000000,
"minimum": 0,
"description": "Spouse's traditional balance on December 31 before the tax year (IRS Pub. 590-B). Required at their RMD age when spouseTraditional is supplied; omit before then. Use the year-end statement, not the current balance; enter 0 if there was no balance, US dollars."
}
}
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 21, 2026.