Skip to main content
Glama

compute_state_return

Compose a STATE return's printed-form line set deterministically (2025 IL-1040 / VA 760 / CA 540 / NY IT-201 / PA-40 / NJ-1040 / OH IT 1040 / NC D-400 / GA 500 / MD 502 / MO-1040 / WI Form 1 / MN M1 / SC1040 / AL Form 40 / OR-40) — correct line NUMBERS from the printed forms and whole-dollar rounding, with the state tax computed by the oracle targets internally. NC and GA start from federalAGI: NC runs the AGI-tiered child deduction, the independent itemize-vs-standard selection, and the Bailey/military/SS auto-subtractions; GA FORCES itemizing for federal itemizers (pass gaFederalItemized), runs the per-spouse retirement exclusion and Low Income Credit targets, and caps total credits at the line 16 tax. PA is CLASS-BASED and NJ is CATEGORY-BASED: transcribe the pa*/nj* class-or-category fields (PA: Box 16 compensation, per-spouse loss classes; NJ: the line 15-26 category nets — a category loss is suppressed per the printed rule, and the composer runs the pension-exclusion, Worksheet H deduction-vs-credit, EITC/CTC/CDCC targets itself) — federalAGI is NOT the PA or NJ base. OH starts from federal AGI: pass federalAGI + ohBusinessIncome and the composer runs the Business Income Deduction, MAGI-tiered exemptions, and the Schedule of Credits ordering (retirement/senior/CDCC/exemption credits before the joint filing credit's line-11 base). Workflow: run compute_return first for the federal substrate, compute any state-specific components the citations describe (additions, subtractions, credits without targets — disclose each), then call this ONCE and report its line set VERBATIM. Never hand-assemble state line numbers: transposed lines on correct dollars are the dominant state error mode. ALWAYS pass taxableSocialSecurity and unemploymentCompensation when nonzero (VA/CA/NY subtractions are applied by the composer). ALWAYS transcribe the intake's state-specific block (e.g. ca_tax_return.ca_form540_schca: AB 5 employee-classification additions; va_sch_a fields; county/use-tax questions) — those fields drive composer inputs. For VA MFJ, pass vaYourVagi/vaSpouseVagi (the separate-VAGI worksheet) so the composer can run the Spouse Tax Adjustment worksheet itself. For MD, pass mdSubdivision (the mandatory county tax — line 28), mdEicQualifyingChild for the 50%/100%/45% EIC routing, and mdNetCapitalGainSubject from an agent-completed Form 502CG when FAGI exceeds $350,000; the composer runs the pension-exclusion, exemption-chart, CTC, poverty-credit, and local EIC/poverty worksheets itself. Maryland part-year returns (Form 502 line 12 proration) are not composed. For MO, split each income item per spouse (moFagiYou/moFagiSpouse etc. — Missouri combined returns compute a SEPARATE chart tax per spouse), pass the line 9/10 federal-tax amounts per the printed lists, and remember the NEW TY2025 100% capital-gains subtraction (moCapitalGainYou/Spouse); Kansas City/St. Louis 1% earnings taxes are separate city returns the composer does not produce. For WI, pass wiScheduleIAdjustments (IRC frozen at 12/31/2022 — post-2022 federal changes convert on Schedule I), wiCapitalGainSubtraction from Schedule WD (30%/60% LTCG exclusion), and note the Act 15 SB-16 retirement subtraction FORFEITS every credit — the composer enforces the forfeiture; compute both ways before electing it. For MN, remember the IRC is frozen at May 1, 2023 (2025 OBBBA items convert on Schedule M1NC → mnAdditions/mnSubtractions), pass mnSsAlternativeMethod when AGI exceeds the SS threshold (the composer takes the greater), mnAmt whenever M1MT preferences exist, and mnNetInvestmentIncome for the 1% NIIT; M1C/M1REF credit schedules are transcribed buckets. For SC, the base is FEDERAL TAXABLE INCOME — pass scFederalTaxableIncome (Form 1040 line 15 verbatim; a negative amount is preserved via subtraction line r), NOT federalAGI; pass scNetLtcgAfterLosses for the 44% LTCG deduction (net LT gains against ALL capital losses first), the per-person retirement/military/age-65 fields (military retirement is 100% deductible and REDUCES the same person's other two deductions — the composer handles the interplay), and federalEITC (the composer adds the 125% NONREFUNDABLE SC EITC into line 13 itself — never also put it in nonrefundableCredits); the 2025 state-tax addback for federal itemizers goes in scAdditions. For AL, the composer builds Alabama AGI from transcribed lines (alWages = W-2 Box 16, alOtherIncome, alTaxableRetirement* for the Schedule RS 65+ $6,000 exclusion — still $6,000 in 2026, HB388 died) — federalAGI is NOT the base; pass alFederalTaxPlusNiit (1040 line 22 + Form 8960) and alFederalRefundableCredits (EIC+ACTC+AOC+adoption+2439) for the UNLIMITED line 12 federal tax deduction, and remember overtime earned Jan-Jun 2025 is exempt and already out of Box 16. For OR, pass the federal-tax-worksheet components (orFederal1040Line22, orFederalPtc from 8962 line 24, orFederalAoc/orFederalRefundableAdoption — the EITC/ACTC are NOT subtracted) for the AGI-capped line 10 subtraction, taxableSocialSecurity (subtracted in full), or2024TaxLiability for the 9.863% kicker, and the Kids Credit inputs (orKidsUnder6 + addbacks); OBBBA tips/overtime/vehicle-interest are CLAIMED for Oregon via OR-ASC codes 390/391/392 in orSubtractions but added back for the Kids Credit test.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
asOfYesyear-end date, e.g. 2025-12-31 — REQUIRED
caAmtNoOVERRIDE for Form 540 line 61 — prefer caIsoPreference + caAmtTaxesAddback so the composer builds Schedule P AMTI and evaluates us.ca.amt itself; a passed caAmt wins.
mnAmtNoM1 line 11: Schedule M1MT alternative minimum tax (6.75% broadened base, agent-computed — REQUIRED whenever AMT preference items exist; disclose)
njSrpNoNJ-1040 line 53c Shared Responsibility Payment (Worksheet L/Schedule NJ-HCC, hand-computed from coverage months; composer zeroes it below the filing threshold)
wagesNofederal line 1a wages (NY IT-201 line 1)
caBhstNous.ca.bhst result (pass the oracle target's answer) — Form 540 line 62 Behavioral Health Services Tax (R&TC § 17043, 1% of CA taxable income over $1,000,000); added into line 64 total tax when nonzero.
caYCTCNous.ca.yctc result (pass the oracle target's answer)
useTaxNoconsumer use / sales-use tax owed on the return
alWagesNoForm 40 line 5b: W-2 BOX 16 state wages from ALL states (Schedule W-2 col I+J; Alabama state wages often EXCEED federal Box 1 — deferrals are AL-taxable). Overtime earned Jan 1-Jun 30, 2025 is exempt and already EXCLUDED from Box 16 (W-2 Box 14 'EX OT WAGES'). Falls back to the shared wages input.
njWagesNoNJ-1040 line 15: W-2 BOX 16 state wages total (falls back to the shared wages input; NJ taxes cafeteria/125 benefits and some items federal Box 1 excludes)
additionsNototal state additions to federal AGI (e.g. NY 414(h) A-104 + IRC-125 A-101; VA Schedule ADJ line 2 codes). GATE RULE: coded addition/subtraction line-item arrays sitting under a false 'do you have additions/subtractions' boolean are inactive template rows (especially $1-$4 placeholder amounts) — transcribe $0 for them and disclose; the gate controls for these arrays
alIs65YouNoprimary taxpayer was 65 or older — enables their $6,000 retirement exclusion (NOTE: still $6,000 for 2026; the reported $12,000 increase was HB388, which died May 2025)
caCalEITCNous.ca.caleitc result (pass the oracle target's answer)
filingHohNo
moFagiYouNoMO-1040 line 1Y: the PRIMARY taxpayer's share of federal AGI — Missouri combined returns SPLIT total FAGI between spouses per the AGI worksheet (each spouse's own income; joint items allocated). Defaults to the full federalAGI when omitted (one-income couple).
njPensionNoNJ-1040 line 20a TAXABLE pension/annuity/IRA distributions (NJ three-year rule / general rule basis recovery already applied; Social Security and Railroad Retirement are exempt and never entered)
orPenaltyNoOR-40 line 43: penalty AND interest for filing or paying late (one combined printed line — 5% late-pay penalty, +20% over 3 months late, 100% for 3 consecutive unfiled years, plus the late-payment interest)
scIs65YouNoprimary taxpayer was 65 or older by December 31 — raises the retirement cap to $10,000 and enables the $15,000 age-65 deduction (line q-1, reduced by the retirement + military deductions claimed)
dependentsNodependent count (CA dependent exemption credits; NY $1,000 exemptions)
exemptionsNopersonal + dependent exemption COUNT (self + spouse + dependents)
federalAGINofederal Form 1040 line 11 (from compute_return, verbatim). REQUIRED for il/va/ca/ny/or — the composer refuses without it. NOT used by PA (class-based: pass the pa* class fields instead).
mdMw506nrsNoMD line 42: tax withheld on Form MW506NRS (nonresident real property sale)
mnItemizedNoSchedule M1SA Minnesota itemized deductions AFTER M1SA's own 3%/10%/80% limitation — the composer takes the larger of this or the computed standard deduction (MFS: standard barred when the spouse itemizes; pass mnMfsSpouseItemizes)
mnStdBoxesNo65-or-older (born before January 2, 1961) and blind boxes for you/spouse — each adds $2,000 (single/HOH) or $1,550 (married statuses) to the standard deduction
njExcessDiNoNJ-1040 line 60 excess disability insurance withheld (over $380.42; NJ-2450)
njRentPaidNorent paid on the NJ principal residence (tenants) — the composer enters 18% of it on line 40a
njScorpNetNoNJ-1040 line 22 net pro rata share of S corporation income (NJ-K-1; negative suppressed)
orInterestNoOR-40 line 44: interest on UNDERPAYMENT OF ESTIMATED TAX from Form OR-10 (boxes 44a/44b) — late-payment interest goes in line 43 instead
orStdBoxesNoOR-40 boxes 17a-d: count of 65-or-older (born before January 2, 1961... turned 65 by January 1, 2026) and blind boxes for you/spouse — each adds $1,200 (single/HOH) or $1,000 (other statuses) to the standard deduction
paGamblingNoPA-40 line 8: gambling and lottery winnings net of wager costs (noncash PA Lottery prizes exempt; cash prizes taxable)
paInterestNoPA-40 line 2: PA-taxable interest (gross class — no expenses; includes commercial-annuity interest taxable as PA interest)
vaYourVagiNoPRIMARY taxpayer's separate VAGI (MFJ only — the 760 instructions' 'Worksheet for Determining Separate Virginia Adjusted Gross Income': own wages/SE/pensions, own share of joint items 50/50, own age deduction and subtractions). Enables the composer's Spouse Tax Adjustment worksheet (Form 760 line 17). vaYourVagi + vaSpouseVagi must equal line 9 VAGI.
alDonationsNoForm 40 line 34: Schedule DC donation check-offs total (reduces the refund)
alPenaltiesNoForm 40 line 31: Schedule ATP Part II penalties (estimated-tax penalty Form 2210AL etc.) — added to an amount owed, or SUBTRACTED from the refund per the printed line 35 formula
federalEITCNofederal EIC, line 27a (from compute_return)
filingJointNo
mdItemizingNotaxpayer itemized FEDERALLY and elects Maryland itemized deductions — the composer computes 17a−17b−17c (with the H.B. 352 7.5% phase-out over $200,000/$100,000-MFS FAGI) and still takes the standard deduction if larger (Maryland allows either)
mnAdditionsNoM1 line 2: Schedule M1M line 10 + M1MB line 9 additions (non-MN municipal bond interest, federal bonus-depreciation/§ 179 addbacks, positive M1NC adjustments — Minnesota's IRC is frozen at May 1, 2023, so 2025 OBBBA items convert on Schedule M1NC)
moItemizingNotaxpayer itemized FEDERALLY and wants Missouri itemized deductions — the composer computes MO-A Part 2 (federal itemized + payroll-tax addback − net state income taxes) and takes the LARGER of that or the standard deduction unless moRequiredToItemize
njArcherMsaNoArcher MSA contributions (federal Form 8853; NJ has NO HSA deduction — never enter HSA amounts)
njCojCreditNoNJ-1040 line 44 credit for income taxes paid to other jurisdictions (Schedule NJ-COJ, hand-computed; composer caps at the line 43 tax). NO credit for Pennsylvania-reciprocal WAGES (the PA/NJ agreement) — Philadelphia wage tax DOES qualify.
njDividendsNoNJ-1040 line 17 dividends
njExcessFliNoNJ-1040 line 61 excess family leave insurance withheld (over $545.82; NJ-2450)
njWwcCreditNoNJ-1040 line 62 Wounded Warrior Caregivers Credit (Schedule NJ-WWC; gross income ≤ $100,000 MFJ/HOH/QSS, ≤ $50,000 single/MFS)
orAdditionsNoOR-40 line 8: Schedule OR-ASC line A5 additions (non-Oregon municipal interest, federal-state depreciation differences, 529 recapture)
paDividendsNoPA-40 line 3: PA-taxable dividends INCLUDING mutual-fund capital-gain distributions (PA classifies them as dividends, not gains)
scAdditionsNoSC1040 line 2 total additions (lines a-e: the state income/sales tax deducted in federal itemized deductions MUST be added back on line a; out-of-state rental/business losses; non-SC municipal bond interest; expenses on reserve/subsistence income). CRITICAL for TY2025: SC REJECTED OBBBA conformity (IRC conformity frozen at December 31, 2024) — line e must ADD BACK every OBBBA deduction in federal taxable income (tips exclusion, overtime premium, the $6,000 senior deduction, car-loan interest, OBBBA business items).
vaItemizingNotaxpayer itemized federally (VA requires the same election, Va. Code § 58.1-322.03(1)) — enables the VA Schedule A computation from the component inputs below; Form 760 line 10 replaces the line 11 standard deduction
wiDonationsNoForm 1 line 24: Schedule 3 fund donations total
alDependentsNoForm 40 line 14 dependent count — Alabama's OWN relationship list (§ 40-18-19: child/stepchild/parent/grandparent/sibling/in-laws/blood uncle-aunt-nephew-niece with over-50% support; NOT federal § 152) — $1,000/$500/$300 each by AL AGI (us.al.dependent_exemption); falls back to the shared dependents input
alIs65SpouseNospouse was 65 or older — enables their own $6,000 exclusion
filingStatusNoREQUIRED in practice: the federal filing status — drives the state bracket schedule, standard deduction column, and exemption structure. The filingJoint/filingHoh/filingHohOrQss booleans are legacy aliases; when filingStatus is present it wins.
gaLic65CountNoLow Income Credit Worksheet line 3: 1 if filer or spouse is 65+, 2 if both
gaUetPenaltyNoForm 500 line 42: Form 500 UET estimated tax penalty
jurisdictionYes
mdPensionYouNoprimary taxpayer's qualifying § 401(a)/403/457(b) pension in FAGI for the Worksheet 13A pension exclusion — ONLY if 65+/totally disabled (or spouse totally disabled); IRAs/SEP/Keogh never qualify. The composer evaluates us.md.pension_exclusion per spouse.
mnDependentsNodependents on Schedule M1DQC — $5,200 each (2025), phased 2% per $2,500 ceil-step of AGI over $358,550 MFJ/QSS, $239,050 single, $298,800 HOH, $179,275 MFS (gone once the excess passes $122,500/$61,250-MFS); $0 for dependent-claimed filers
mo529DepositNoMO-1040 line 52: refund deposited to a Missouri 529 (MOST) account (minimum $25, Form 5632)
moFagiSpouseNoMO-1040 line 1S: the spouse's share of federal AGI (combined returns). 1Y + 1S must equal the federal AGI. A NEGATIVE share triggers the 12 CSR 10-2.710 zeroing the composer applies (negative spouse $0, other spouse the netted joint FAGI; both $0 when combined FAGI is negative).
moNrPaymentsNoMO-1040 lines 39+40: MO-2NR/MO-2ENT nonresident partner/entertainer payments
ncCharitableNoNC Schedule A: IRC § 170 charitable contributions allowed for the year (no NC dollar cap)
ncTaxCreditsNoD-400 line 16: D-400TC total (other-state credit worksheet, historic rehab) — hand-computed; the composer caps at the line 15 tax. NC has NO EITC and NO child/dependent care credit.
njBaitCreditNoNJ-1040 line 63 pass-through Business Alternative Income Tax credit (PTE-K-1)
njBlindCountNoline 8 count (0-2): filer/spouse blind or disabled — $1,000 each
orFederalAocNoAmerican Opportunity Credit (1040 line 29) — subtracted in the federal tax worksheet
orFederalPtcNopremium tax credit from Form 8962 LINE 24 (the full allowable credit regardless of advance payments) — subtracted. NOTE: the EITC and additional child tax credit are NOT subtracted.
orKidsUnder6Nodependents age 5 or younger at the end of 2025 (max 5 count) — $1,050 each Oregon Kids Credit (us.or.kids_credit, refundable, MFS denied). A child claimed only via a RELEASED dependent exemption does not count.
scDependentsNoSC line w dependent count (must equal the federal return's) — $4,930 each for 2025 (us.sc.dependent_exemption); falls back to the shared dependents input
scIs65SpouseNospouse was 65 or older by December 31 (lines p-2/q-2)
scLumpSumTaxNoSC1040 line 7: tax on lump-sum distribution (SC4972, agent-computed, attached)
subtractionsNototal state subtractions OTHER than the automatic ones (taxable social security / unemployment have their own inputs below; e.g. NY S-136 alimony paid, IL retirement subtraction)
vaFamilyVagiNoSchedule ADJ line 10 total family VAGI (you + spouse + dependents' VAGI) for the Credit for Low-Income Individuals poverty test; defaults to line 9 VAGI when omitted
vaSpouseVagiNospouse's separate VAGI for the STA worksheet (Form 760 line 17 box; MFJ only)
wi2441CreditNoSchedule WI-2441 line 14 — Wisconsin's additional child and dependent care credit (its own recomputation; transcribe the schedule's result)
wiAge65BoxesNocount of 65-or-older boxes (taxpayer/spouse) — $250 each on line 10b (Wisconsin has no blindness exemption; the $700 line 10a exemptions come from the shared `exemptions` count)
wiMarriedHohNothe Form 1 'Head of household, married' checkbox applies — shares the MFS $150 school property tax credit cap
alAdjustmentsNoForm 40 line 9 / Part II total (per-spouse IRA deduction, Keogh/SEP, early-withdrawal penalty, alimony paid, adoption expenses, MOVING EXPENSES (Alabama kept them), SE health insurance, College Counts 529/PACT, small-employer health premiums, wind/flood retrofit, catastrophe savings, HSA, First/Second-Chance Home Buyer, firefighter insurance, ABLE)
alOtherIncomeNoForm 40 Part I lines 1-3 and 5-7 total EXCLUDING retirement (alimony received, business income/loss, gains — the 1/1/2025+ precious-metal-bullion gain is EXEMPT, rents/royalties/partnerships, farm; negative allowed). Retirement goes in the alTaxableRetirement* fields for the Schedule RS exclusion.
gaNolUtilizedNoForm 500 line 15b: Georgia NOL utilized (Schedule 4; cannot exceed line 15a or the 80% limitation — composer caps at 15a)
ilK12ExpensesNoIL qualified K-12 education expenses (before the $250 floor)
md502crPartBBNoMD line 31: local tax credit from Form 502CR Part BB line 1
mdCtcChildrenNoMaryland CTC qualified children (dependents under 6, or over 5 and under 17 with a disability) — the composer evaluates us.md.ctc ($500/child, phased out $50 per $1,000 of FAGI over $15,000, $0 above $24,000; refundable via 502CR Part CC into line 45)
mdSubdivisionNoREQUIRED for MD: the taxing county where the filer resided on the LAST day of the tax year (Form 502 political-subdivision box) — one of baltimore_city, allegany, anne_arundel, baltimore_county, calvert, caroline, carroll, cecil, charles, dorchester, frederick, garrett, harford, howard, kent, montgomery, prince_georges, queen_annes, st_marys, somerset, talbot, washington, wicomico, worcester, nonresident. Drives the mandatory local tax (line 28: flat 2.25%-3.30%; Anne Arundel bracketed with its own printed table; Frederick tiered on the WHOLE income with real cliffs).
mnStateRefundNoM1 line 6: state income tax refund from federal Schedule 1 line 1 (its own subtraction line)
moFederalTax9NoMO-1040 line 9 'Tax from federal return': federal 1040 line 22 MINUS lines 27a and 29, MINUS Schedule 2 Part 1 line 3, MINUS Schedule 3 Part 2 line 9 — never withholding; the EIC must be subtracted
moSsExemptYouNothe primary's MO-A Section C exemption: their TAXABLE Social Security/SSD (1040 line 6b share), 100% exempt — pass ONLY if 62+ by December 31 (the MO-1040 age box) or on Social Security Disability (attested)
njAlimonyPaidNoNJ-1040 line 32 court-ordered alimony PAID (still deductible for NJ; never child support)
njBusinessNetNoNJ-1040 line 18 net profits from business (Schedule NJ-BUS-1 Part I; negative allowed — the composer suppresses a net category loss per the printed rule)
njFederalCdccNothe federal Form 2441 child and dependent care credit — enables the line 64 NJ CDCC (us.nj.cdcc: 50%→10% of it by NJ taxable income, $150,000 cap)
njGamblingNetNoNJ-1040 line 24 net gambling winnings (losses net WITHIN the category; NJ Lottery prizes of $10,000 or less are exempt)
njMfsSameHomeNoMFS and both spouses maintained the SAME main home — halves the property-tax deduction cap ($7,500) and credit ($25)
njNjclassPaidNoNJ-1040 line 37b NJCLASS loan principal+interest paid (composer caps at $2,500)
njOtherIncomeNoNJ-1040 line 26 other income
njSeniorCountNoline 7 count (0-2): filer/spouse 65 or older (born 1960 or earlier for TY2025) — $1,000 each
njTuitionPaidNoNJ-1040 line 37c NJ-institution tuition paid (composer caps at $10,000)
ohEicOverrideNoOVERRIDE: us.oh.eic oracle answer — wins over the composer's 30%-of-federalEITC line 13 computation
or529DepositsNoOR-40 line 51: Oregon 529 deposits from Schedule OR-529 (reduce the refund)
orPtePaymentsNoOR-40 line 36: estimated payments from Schedule OR-K-1 line 20 (PTE owner payments via Form OR-19)
orStateRefundNoOR-40 line 12: OREGON state income tax refund from federal Schedule 1 line 1 (never other states' or local refunds)
paBusinessNetNoPA-40 line 4, TAXPAYER's own net business/profession/farm income or LOSS (negative allowed; within-class netting of the taxpayer's own activities only — a loss never crosses classes or spouses)
paEstateTrustNoPA-40 line 7: estate/trust income (PA Schedule J; an estate or trust cannot distribute a loss — never negative)
paPropertyNetNoPA-40 line 5, taxpayer's own net gain/loss from sale/exchange/disposition of property (negative allowed; no carryover)
caHsaDeductionNofederal HSA deduction (Form 8889 line 13) — California does not conform to § 223: the composer ADDS it back for CA
filingHohOrQssNo
gaIndCrCreditsNoForm 500 line 20: IND-CR Summary total OTHER than the CDCC (the composer adds us.ga.cdcc itself from gaFederalCdccAllowed)
ilChildUnder12NoIL CTC gate: a QUALIFYING CHILD (§ 152(c) lineage — child/stepchild/foster/sibling or their descendants) under age 12. A qualifying-relative/ODC-only dependent does NOT satisfy this even if under 12; leave false.
ilEitcOverrideNous.il.eitc oracle target's answer (35 ILCS 5/212(a)(vi), (b-5), (b-10): 20% of the federal EITC recomputed WITHOUT the § 32(c)(1)(A)(ii) childless age gate) — WINS over the generic 20%-of-federalEITC line-29 computation when present. MUST be used (not merely optional) for a taxpayer age 18-24 or 65+ with NO qualifying children: federalEITC alone is correctly $0 for that population under federal law, so line 29 = 20% x federalEITC would wrongly zero out Illinois' decoupled credit — pass us.il.eitc's computed answer instead. Safe to pass for every IL EITC claimant (agrees with the generic computation outside the decoupled population).
mdEarnedIncomeNoMD line 1b earned income (wages + net SE profit, no loss netting) — the poverty level credit base (us.md.poverty_level_credit) and the local poverty credit (19C)
mdStateRefundsNoMD line 8: taxable state/local income tax refunds included in federal AGI (subtraction)
mnSubtractionsNoM1 line 7 subtractions (M1M line 40 + M1MB line 22) EXCLUDING the composer-computed Social Security subtraction: U.S. government interest, K-12 education expenses, charitable over $500 for non-itemizers (50% of the excess), bonus-depreciation recovery, M1R age-65+/disabled, M1QPEN public pension, military items, the new 2025 items (coerced debt, consumer enforcement, foreign service, SEIU stipends)
moAdditionsYouNoMO-A Part 1 line 7Y: the primary's additions (non-Missouri state/local bond interest, PTE/NOL addbacks, nonqualified 529/ABLE distributions, food pantry, nonresident property tax)
moLtcDeductionNoMO-1040 line 16: qualified long-term care insurance premiums (12+ month policies, net of federally deducted amounts, per the worksheet)
njEitcOverrideNoOVERRIDE: us.nj.eitc oracle answer — wins over the composer's 40%-of-federalEITC / $260 computation
njHezDeductionNoNJ-1040 line 34 Health Enterprise Zone deduction (TB-56)
njVeteranCountNoline 9 count (0-2): filer/spouse honorably-discharged veterans — $6,000 each
ohAge65OrOlderNofiler (or spouse) was 65 or older at year end — $50 senior citizen credit (once per return; NOT available if the lump sum distribution credit was ever taken)
orKickerDonateNofiler elects to donate the ENTIRE kicker to the State School Fund (irrevocable after the due date) — line 32 becomes $0 and box 55 is checked
orSubtractionsNoOR-40 line 13: Schedule OR-ASC line B7 subtractions — including the OBBBA-conforming tips/overtime/passenger-vehicle-interest deductions (codes 390/391/392: Oregon lets you claim the same amounts as federal), US government interest, the federal pension percentage subtraction, OR-HOME first-time home buyer savings, tier 2 Railroad Retirement. Do NOT include Social Security (automatic via taxableSocialSecurity).
scCareChildrenNocount of qualifying care children/dependents — 2+ raises the SC CDCC cap from $210 to $420
scCareExpensesNofederal Form 2441 child/dependent care EXPENSES (not the credit) — SC line 11 pays 7%, max $210/$420 (us.sc.cdcc); DENIED to married filing separately
scI290PaymentsNoSC1040 line 19: nonresident real estate withholding paid on Form I-290
vaAgeDeductionNoOVERRIDE ONLY — pass vaAgeQualifyingFull/vaAgeQualifyingTested instead and the composer computes the age deduction itself (including the AFAGI social-security exclusion agents routinely miss). When splitting an odd joint total between spouses (Form 760 lines 4a/4b), the odd dollar goes to the SPOUSE.
ageOrBlindBoxesNocount of age-65+/blind boxes checked (taxpayer/spouse, per box)
alAtpOtherTaxesNoSchedule ATP Part I taxes OTHER than the use tax (which uses the shared useTax input): catastrophe-savings recapture (+2.5%), etc.
caIsoPreferenceNoISO exercise spread AMT preference (§ 56(b)(3) as modified by R&TC § 17062) — with caAmtTaxesAddback this lets the composer BUILD Schedule P AMTI itself (AMTI = line 19 taxable income + taxes deducted in the CA itemized deduction + this preference; standard deduction added back instead when not itemizing) and evaluate us.ca.amt internally; caAmt (a precomputed answer) wins if both are given
caRentersCreditNous.ca.renters_credit result (pass the oracle target's answer) — nonrefundable, joins the exemption credits in the line-48 subtraction from tax.
cityWithholdingNoNY line 73 NYC withholding
gaExclusionTierNoprimary taxpayer's GA retirement-exclusion tier: 62-64 during any part of the year or permanently/totally disabled ($35,000 cap) vs 65+ ($65,000 cap) (us.ga.retirement_exclusion)
gaLicExemptionsNoLow Income Credit Worksheet line 2: self + spouse + natural/legally adopted children (never other dependents or unborn) (us.ga.low_income_credit)
mdContributionsNoMD lines 35-39: voluntary fund contributions total (reduces the refund)
mdHouseholdSizeNopersons in the family/household from the federal return — enables the poverty level credit computation (2025 guideline $15,650 + $5,500 each additional person)
mdPensionSpouseNospouse's qualifying pension for their own 13A column (same gates)
mdRangerPensionNoMD line 10b: Retired Forest/Park/Wildlife Ranger pension exclusion (Worksheet 13E, agent-computed, disclosed)
mnOtherTaxes14aNoM1 line 14a: M1HOME/M1529 recapture, M1LS lump-sum tax, and the Schedule NIIT amount if computed outside the composer
mnRrTier1OffsetNoTier 1 Railroad Retirement benefits already subtracted on M1M line 17 — the SS worksheet (steps 25-29) reduces the simplified-method subtraction by this amount (no double subtraction)
moHcsmDeductionNoMO-1040 line 17: health care sharing ministry contributions not deducted federally
moOtherTaxesYouNoMO-1040 line 34Y: 10% of the Federal Form 4972 lump-sum distribution tax, and/or recapture of the low income housing credit (Form 8611) — the printed checkboxes. (Form 4970 trust accumulation amounts are a SUBTRACTION, not a line 34 tax.)
ncScorpPaymentsNoD-400 line 21d: NC tax paid by an S corporation on the filer's behalf
njExcessUiWfSwfNoNJ-1040 line 59 excess UI/WF/SWF withheld (two+ employers over $184.02; Form NJ-2450)
scContributionsNoSC1040 line 28: check-off contributions total (I-330 attached; reduces the refund)
scLatePenaltiesNoSC1040 line 32: late filing/late payment penalties and interest
scTuitionCreditNoSC1040 line 21: REFUNDABLE tuition tax credit (Form I-319: 50% of qualifying SC-institution tuition within the form's limits — agent-computed with disclosure, form attached)
vaItemizedOtherNoVA Sch A other itemized deductions
wiBothSpouses67Noboth spouses 67+ on December 31 (joint returns) — raises the SB-16 cap to $48,000
extensionPaymentNopayment made with an extension request. VA 760 line 22 (its own line, never folded into the estimated-payments line). NY IT-201 line 75 is the COMBINED line — 'estimated tax payments and amount paid with Form IT-370' — so for NY this is added into the same line as estimatedPayments, not kept separate.
gaDependentCountNoForm 500 line 7c total dependents (7a qualified + 7b unborn-with-heartbeat; never self/spouse) — $4,000 each (us.ga.dependent_exemption)
moCapitalGainYouNothe primary's share of federally reported capital gains (Form 1040 line 7a) — the composer subtracts 100% (MO-A line 18, H.B. 594, NEW for TY2025; a negative amount enters as $0)
moSsExemptSpouseNothe spouse's Section C SS/SSD exemption on the same gates
ncUseTaxEstimateNouse the printed no-receipts consumer use tax table (keyed to line 14 taxable income, us.nc.use_tax) instead of the useTax input
njAbcaAdjustmentNoNJ-1040 line 35 Alternative Business Calculation Adjustment (Schedule NJ-BUS-2 line 11 — the only cross-category loss softener, 20-year carryforward)
njChildrenUnder6Nocount of line 10/11 dependents age 5 or younger on 12/31 (born 2020 or later for TY2025) — the line 65 NJ Child Tax Credit multiplier ($1,000→$200 each by taxable income ≤ $80,000; MFS ineligible)
njDispositionNetNoNJ-1040 line 19 net gains from disposition of property (Schedule NJ-DOP; NO capital-gain preference, NO loss carryover; negative allowed — suppressed)
njGoldStarCreditNoNJ-1040 line 47 Gold Star Family Counseling Credit (hours × TRICARE rate)
njPartnershipNetNoNJ-1040 line 21 distributive share of partnership income (NJK-1; negative suppressed)
njRentRoyaltyNetNoNJ-1040 line 23 net rents/royalties/patents/copyrights (negative suppressed)
nycTaxableIncomeNoNYC taxable income (IT-201 line 47) if NYC resident
ohBusinessIncomeNoOH Schedule of Business Income Part 1 line 10: total business income (Schedule B/C/D/E/F + guaranteed payments to 20%+ owners + § 4797) — the composer runs the $250,000/$125,000 Business Income Deduction and the flat-3% line 6/8b arithmetic from it
ohResidentCreditNoOH Schedule of Credits line 39 resident credit for taxes paid other states (Ohio IT RC, hand-computed)
orSpouseItemizesNoMFS only: the other spouse itemizes — the Oregon standard deduction becomes $0
orYoungestUnder3Nothe youngest dependent was younger than 3 at year end — raises the Oregon EIC from 9% to 12% of the federal EITC (us.or.eic)
paRentRoyaltyNetNoPA-40 line 6, taxpayer's own net rents/royalties/patents/copyrights (short-term rentals under 30 days are BUSINESS income, line 4)
paResidentCreditNoPA-40 line 22: resident credit for tax paid other states (Schedule G-L; not for reciprocal-state compensation: IN/MD/NJ/OH/VA/WV). Subtracts BEFORE Tax Forgiveness — the composer handles the ordering.
scActiveTradeTaxNoSC1040 line 8: I-335 flat 3% tax on active trade or business income (agent-computed; the electing income must also appear in scSubtractionsOther as the line l subtraction)
scCatastropheTaxNoSC1040 line 9: tax on excess Catastrophe Savings Account withdrawals
stateWithholdingNostate income tax withheld (IL line 25 / VA 19a / CA 71 / NY 72). CONVENTIONS: IL line 25 sums state withholding from EVERY document (W-2s + all 1099s). NY line 72 = W-2 box 17 NYS withholding PLUS NY-coded state withholding from 1099s whose PAYER has an in-state (NY) address; NY-coded withholding printed by an OUT-OF-STATE-addressed payer is NOT included; disclose any excluded amount in notes. VA 19a = the PRIMARY taxpayer's withholding from EVERY document type (W-2, 1099, VK-1 — Form 760 line 19 instructions name all three; the payer's address does NOT matter for VA, unlike NY); a jointly-issued document's state withholding splits 50/50 between 19a/19b with the odd dollar to the primary.
vaRefundableEitcNoOVERRIDE ONLY — the composer now computes the Form 760 line 23 credit itself from federalEITC + the eligibility inputs below. If passed, this refundable amount wins over the computed selection.
wiFarmlandCreditNoForm 1 line 31: farmland preservation credit (Schedules FC/FC-A, transcribed)
wiOtherPenaltiesNoForm 1 line 26 other penalties (see instructions p.25)
wiVeteransCreditNoForm 1 line 34: eligible veterans and surviving spouses property tax credit
yonkersSurchargeNous.ny.yonkers_surcharge result (pass the oracle target's answer) — 16.75% of the Yonkers worksheet's netted base (nyYonkersBase). Added into line 62's total and printed on its own line (IT-201 LINE 55, not 54 — line 54 is MCTMT) when nonzero.
caAmtTaxesAddbackNotaxes actually included in the CA itemized deduction (property taxes etc. surviving the Schedule CA SALT adjustments) — the Schedule P line 2 addback used when the composer builds AMTI from caIsoPreference; $0 when not itemizing (the composer adds back the standard deduction instead)
estimatedPaymentsNostate estimated payments ONLY (extension payments and prior-year credited overpayments have their own lines where the form provides them)
gaFederalItemizedNoForm 500 line 12a: federal Schedule A total. Supplying this FORCES Georgia itemizing ('Leave Line 11 blank if you itemize deductions on your Federal return') — a federal standard-deduction filer must omit it.
ilPropertyTaxPaidNoIL property tax on principal residence, net of business-use portion
ilTeacherExpensesNoIL Schedule 1299-C educator materials expenses
mdBusinessCreditsNoMD line 25: business tax credits (Form 500CR — e-file only; transcribed)
mdFederalItemizedNoMD line 17a: total federal itemized deductions (federal Schedule A line 17)
mdInterestChargesNoMD line 51: Form 502UP interest / late-filing interest
mdSsRrBenefitsYouNoprimary taxpayer's TOTAL Social Security + Railroad Retirement benefits (taxable or not) — reduces the $41,200 cap in the primary's 13A column
mnPenaltyInterestNoM1 line 28: late-filing/late-payment penalty and interest (agent-computed per the instructions)
moAdditionsSpouseNoMO-A Part 1 line 7S: the spouse's additions
moFederalItemizedNoMO-A Part 2 line 1: total federal itemized deductions (federal Schedule A total) plus any approved cultural contributions (literary/musical/scholastic/artistic donations, § 143.141)
moOtherDeductionsNoMO-1040 lines 21-24 bucket: beginning farmer, transport facility, foster parent deductions (agent-transcribed)
moSubtractionsYouNoMO-A subtractions for the primary EXCLUDING the composer-computed capital gain (line 18) and business income deduction (line 17): exempt federal-obligation interest, state refund, military retirement (100%), railroad retirement, 529/ABLE contributions ($8,000/taxpayer), qualified health insurance premiums, depreciation adjustments, agriculture disaster relief
ncMedicalExpensesNoNC Schedule A line 7a: medical/dental expenses BEFORE the floor — the composer subtracts 7.5% of federal AGI
ncRealEstateTaxesNoNC Schedule A: real estate property taxes (NC allows NO income/sales tax deduction) — inside the $20,000 combined cap
njAlimonyReceivedNoNJ-1040 line 25 alimony received (NJ did not adopt the TCJA repeal — still NJ income)
njDomesticPartnerNoregistered NJ domestic partner claimed as a line 6 regular exemption (+$1,000)
njMedicalExpensesNounreimbursed medical expenses (Worksheet F line 1) — the composer applies the 2%-of-line-29 floor
njPensionEligibleNoline 28a gate: filer (or spouse if joint) was 62+ OR blind/disabled per Social Security guidelines on the last day of the year — enables the pension exclusion (us.nj.pension_exclusion)
njTaxableInterestNoNJ-1040 line 16a taxable interest (NJ-exempt: federal obligations, NJ municipal bonds — exclude here, report on 16b)
nyHouseholdCreditNoNYS household credit from table 2 (us.ny.parameters citation)
ohInterestPenaltyNoIT 1040 line 11 interest penalty on underpayment of estimated tax (Ohio IT/SD 2210)
orKidsLossAddbackNoKids Credit worksheet Part B: federal losses + OR-ASC loss-subtraction codes beyond the $20,000 allowance, plus ALL excluded foreign earned income — added back to qualifying income
paNrk1WithholdingNoPA-40 line 17: nonresident tax withheld from PA Schedule(s) NRK-1
refundableCreditsNostate refundable credits, e.g. the NY credit block: ESCC + NYS EIC + IT-216 + NYC EIC + NYC school tax + NYC child care (WITHOUT their own oracle target, self-computed per the us.ny.parameters citation and disclosed) PLUS us.ny.it214 (the Real Property Tax Credit, which DOES have an oracle target as of TY2025 v5 — pass its computed answer here, not a hand-derived percentage of rent)
scSubsistenceDaysNoSC line s: days as a full-time federal/state/local law enforcement officer, firefighter, or EMS worker — $16/day subsistence allowance
vaItemizedMedicalNoVA Sch A line 1: total medical/dental expenses BEFORE any floor (VA applies its own 10%-of-FAGI floor — Virginia deconforms from the federal 7.5% floor)
wiFederalEicForWiNothe federal EIC AS COMPUTED UNDER WISCONSIN'S IRC (Schedule I Part III recomputation when Part I adjustments exist) — defaults to the shared federalEITC when omitted
wiHomesteadCreditNoForm 1 line 33: homestead credit (Schedule H/H-EZ circuit breaker, agent-computed, refundable)
wiRepaymentCreditNoForm 1 line 32: repayment of income previously taxed credit
alCampaignCheckoffNoForm 40 line 20: $1/$2 Alabama Democratic/Republican party checkoffs — these ADD to the tax due (not fund-neutral like the federal checkoff)
claimedAsDependentNosomeone else can claim this taxpayer as a dependent (carry the prior-year 1040 'Someone can claim: You as a dependent' checkbox forward as a continuing condition unless the current-year interview contradicts it). IL: zeroes the line 10 exemption allowance when base income exceeds the exemption amount. VA: limits the standard deduction to earned income.
gaOtherStateCreditNoForm 500 line 18: other state(s) tax credit (printed worksheet, hand-computed; other-state return copy required)
gaOtherWithholdingNoForm 500 line 25: GA tax withheld on G2-A / G2-FL / G2-LP / G2-RP statements (never W-2/1099 amounts — those go in the shared stateWithholding for line 24)
gaRetirementIncomeNoprimary taxpayer's UNEARNED retirement income for the exclusion (pensions, interest, dividends, net rents, capital gains, royalties, military retirement; joint property at 50%; NEVER Social Security — that subtracts automatically)
mdHomebuyerPenaltyNoMD line 51a: first-time homebuyer savings account 10% withdrawal penalty
mdRecapturedCreditNoMD line 21a: recaptured credit from Form 502CR Part DD line 1
moOtherTaxesSpouseNoMO-1040 line 34S
moPublicPensionYouNothe primary's PUBLIC-source pension (federal/state/local government, 1040 line 5b share) — the composer runs MO-A Part 3 Section A (min(pension, $47,633) less their Section C exemption). Military retirement goes in moSubtractionsYou instead (100%, MO-A line 10).
ncBaileyRetirementNoNC Schedule S line 20: Bailey settlement retirement benefits (NC/local government or US government incl. military retirees with 5+ years of creditable service as of Aug 12, 1989; state 401(k)/457 contributed before that date) — fully deducted; enclose the 1099-R
ncMortgageInterestNoNC Schedule A: qualified mortgage interest — the composer applies the $20,000 combined cap with real estate taxes and takes itemized only when it beats the standard deduction
njEitcAgeDecoupledNoflat-$260 NJEITC attested: 18+, no qualifying child, met all federal EIC requirements except age, not claimed as a dependent (NJ eliminated both federal age limits)
njSpecialExclusionNoline 28b Special Exclusion attested: filer (and spouse if joint) will NEVER be eligible for Social Security/Railroad Retirement because the employer did not participate — adds $6,000 (MFJ/HOH/QSS) / $3,000 (single/MFS)
nycHouseholdCreditNoNYC household credit from table 5
ohRetirementIncomeNoretirement income received on account of retirement still INCLUDED in Ohio AGI, both spouses combined (NOT Social Security/railroad/uniformed-services amounts — those are deducted and never qualify) — drives the retirement income credit (max $200)
or2024TaxLiabilityNothe filer's 2024 total Oregon personal income tax liability (after the other-state credit, before all other credits/payments — 2024 OR-40 line 24 tax-before-credits MINUS the Schedule OR-ASC code 802/815 credit for taxes paid to another state, per Table 8 / Kicker worksheet Part A) — the composer computes the 9.863% kicker (us.or.kicker). Requires the 2024 return filed before the 2025 return. Prorate by 2024 Oregon-AGI share if the filing status changed (worksheet Parts B/C).
orCreditRecapturesNoOR-40 line 22: tax recaptures from Schedule OR-ASC line C5
orKidsObbbaAddbackNoKids Credit worksheet line 2: tips/overtime/vehicle-interest subtractions claimed (OR-ASC codes 390/391/392) — ADDED BACK to qualifying income
pa529ContributionsNoSchedule O code T: § 529 contributions, ALREADY capped at $19,000 per beneficiary per taxpayer-spouse (2025); no deduction for rollovers/beneficiary changes
paScheduleDcCreditNoPA-40 line 23 component: the Child and Dependent Care Enhancement credit — pass us.pa.cdcc's computed answer (= 100% of the federal Form 2441 line 9a tentative credit; refundable)
scDependentsUnder6NoSC line t: dependents under age 6 on December 31 — the SAME $4,930 again each (on top of their line w exemption)
scOtherWithholdingNoSC1040 line 20: other SC withholding from 1099s (W-2 amounts go in the shared stateWithholding for line 16)
vaItemizedCasualtyNoVA Sch A casualty/theft losses (protected from the overall limitation)
vaItemizedGamblingNoVA Sch A gambling losses (§ 165(d), limited to winnings; protected from the overall limitation)
wiOtherStateCreditNoForm 1 line 20: net income tax paid to another state (Schedule OS, agent-computed)
wiRentHeatIncludedNo2025 rent on the principal Wisconsin residence with heat INCLUDED (line 16a; 2.4% via the printed table's $100-row midpoints)
yonkersWithholdingNoNY line 74 Yonkers withholding (W-2 box 19 with a Yonkers locality)
alAppliedToNextYearNoForm 40 line 33: overpayment applied to 2026 estimated tax
alInterestDividendsNoForm 40 line 6: interest and dividend income (Schedule B attached if over $1,500)
gaMilitaryExclusionNoGA military retirement exclusion for under-62 retirees (Schedule 1 page 3 worksheet: $17,500 + additional $17,500 when GA earned income exceeds $17,500 — hand-computed, per qualifying spouse)
mdChildCareExpensesNoMD line 9: child and dependent care EXPENSES from federal Form 2441 line 6 — an income subtraction in Maryland (separate from any 502CR Part B credit); the composer caps it at $3,000 ($6,000 when mdChildCareTwoOrMoreDependents)
mnAppliedToNextYearNoM1 line 30: refund applied to 2026 estimated tax
mnMfsSpouseItemizesNoMFS only: the other spouse claims Minnesota itemized deductions — bars the standard deduction (the composer then requires mnItemized)
moAppliedToNextYearNoMO-1040 line 50: overpayment applied to 2026 estimated tax
moBusinessIncomeYouNothe primary's MISSOURI-SOURCE net business income per the p.16 worksheet (Schedule C line 31 + Schedule E line 32 + Schedule F/4835 profits, losses netted, MINUS agricultural disaster relief payments already on MO-A line 16; $0 if net loss) — the composer takes the 20% § 143.022 deduction (MO-A line 17Y)
moCapitalGainSpouseNothe spouse's share of federal capital gains for the 100% subtraction
moEnterpriseZoneYouNoMO-1040 line 28Y: enterprise zone / rural empowerment zone income modification
moOtherFederalTax10NoMO-1040 line 10 'Other federal tax': Schedule 2 Part 1 line 3 + Part 2 lines 8/14/15 + recapture in line 21 + Schedule 3 Part 1 line 1 (attach 4255/8611/8828 for recapture)
moPayrollTaxAddbackNoMO-A Part 2 lines 2-7 total: the 2025 employee Social Security tax (capped $10,918 per spouse), Railroad Retirement Tier I+II (capped $17,327 per spouse, net of employer refunds), Medicare tax (with Form 8959 adjustments), and self-employment tax (Schedule 2 line 4 − Schedule 1 line 15 + Form 8959 line 13) — Missouri ADDS payroll taxes into itemized deductions
moPrivatePensionYouNothe primary's PRIVATE-source taxable pension/annuity/IRA/401(k) (1040 lines 4b+5b share) — Section B caps each spouse at $6,000 and phases out by income
moPropertyTaxCreditNoMO-1040 line 43: Form MO-PTS property tax credit (refundable circuit breaker — actual property tax up to $1,100 owners / 20%-of-rent up to $750 renters, from the printed chart; net household income gates $30,000 owners / $27,200 renters; agent-computed from MO-PTS with disclosure)
moRequiredToItemizeNothe filer was REQUIRED to itemize federally (e.g. MFS with an itemizing spouse) — Missouri then requires itemizing even when the standard deduction is larger
moResidentCreditYouNoMO-1040 line 31Y: Form MO-CR credit for taxes paid to other states (agent-computed; the composer caps at line 30Y)
njCollegeDependentsNoline 12 count: dependents under 22 attending college full-time (five months, half support) — $1,000 each ON TOP of the $1,500 line 10/11 exemption (use the shared dependents input for the $1,500 count)
njPensionExcludableNoNJ-1040 line 20b excludable (previously-taxed) pension/annuity/IRA amounts — display only
njPropertyTaxesPaidNoNJ-1040 line 40a: property taxes due and paid on the principal residence (homeowners; after Worksheet G proration). Tenants: use njRentPaid instead and the composer applies the 18% conversion.
njSeHealthInsuranceNoself-employed health insurance deduction (Worksheet F line 5)
njTaxExemptInterestNoNJ-1040 line 16b tax-exempt interest (reported, never taxed)
ohNonresidentCreditNoOH Schedule of Credits line 38 nonresident credit (Ohio IT NRC, hand-computed)
orAppliedToNextYearNoOR-40 line 48: refund applied to 2026 estimated tax
orFederal1040Line22Nofederal Form 1040 LINE 22 (tax after nonrefundable credits) — the federal tax subtraction worksheet's line 1 (from compute_return, verbatim)
orRegularExemptionsNoregular exemption count: 'yourself' + 'spouse' credit boxes (6a/6b) + dependents (6c) — $256 each, $0 cliff above $100,000 federal AGI (single/MFS) or $200,000 (others)
orTaxMethodOverrideNoOR-40 line 20 alternate-method tax: farm income averaging (OR-FIA-40, box 20a), farm capital gain (Worksheet FCG, box 20b), or the IRREVOCABLE Oregon PTE reduced rate (OR-PTE-FY, box 20c) — agent-computed; wins over the table/chart tax
paAbleContributionsNoSchedule O code A: PA ABLE contributions, capped at the federal gift-tax exclusion ($19,000 for 2025)
paGrossCompensationNoPA-40 line 1a: W-2 BOX 16 total (NOT Box 1 — 401(k)/elective deferrals are PA-taxable; eligible retirement distributions are exempt and excluded). Falls back to the shared wages input when omitted (composer discloses). Include taxable early-distribution amounts under the cost-recovery method.
paPenaltiesInterestNoPA-40 line 27: penalties and interest incl. estimated-underpayment penalty (REV-1630)
paScheduleOcCreditsNoPA-40 line 23 component: Schedule OC restricted credits total (transcribed; no oracle target)
paSpouseBusinessNetNoPA-40 line 4, SPOUSE's own net business income or loss (kept separate: PA never nets one spouse's loss against the other's income)
paSpousePropertyNetNoPA-40 line 5, spouse's own net property gain/loss
scAppliedToNextYearNoSC1040 line 27: amount of the line 24 overpayment credited to 2026 estimated tax
scSubtractionsOtherNoSC subtraction lines f/g/h/j/k/l/m/n/v total (state tax refund, total-and-permanent disability retirement, out-of-state non-personal-service income, volunteer firefighter/EMS/police $6,000 (2025), Future Scholar 529 (unlimited), ACTIVE TRADE OR BUSINESS income electing the I-335 3% flat tax (line l — must pair with scActiveTradeTax), US government interest, nontaxable Guard/Reserve pay, other) — EXCLUDING the composer-computed lines i/o/p/q/r/s/t/u/w
vaAgeQualifyingFullNocount of filers (taxpayer/spouse) born ON OR BEFORE January 1, 1939 — each gets the UNCONDITIONAL $12,000 age deduction (no income test)
vaYourAgeBlindBoxesNoSTA worksheet Part 1 line 2: PRIMARY taxpayer's 65+/blind box count (0-2) — per-spouse exemption = boxes x $800 + $930
wiAppliedToNextYearNoForm 1 line 42: overpayment applied to 2026 estimated tax
wiPropertyTaxesPaidNoproperty taxes on the principal residence (line 16b; 12% via the printed $25-wide-row table — a different granularity from the $100-row rent tables) — combined 16a+16b credit caps at $300 ($150 MFS or married-HOH); not claimable with the line 34 veterans credit
wiScheduleUInterestNoForm 1 line 44: Schedule U underpayment interest
alFederalTaxPlusNiitNofederal Form 1040 LINE 22 tax PLUS Form 8960 line 17 NIIT — the line 12 worksheet's gross federal tax (from compute_return, verbatim; NEVER the W-2 federal withholding)
alItemizedDeductionsNoAlabama Schedule A total — differs from federal: FICA/Medicare/SE taxes ARE deductible, medical floor is 4% of AGI, NO federal income tax here (it's line 12), NEW 2025 vehicle-loan interest ≤$10,000 phased out $200 per $1,000 ceil-step of AGI over $100,000/$200,000-MFJ. The composer takes the larger of this or the AGI-phased standard deduction.
alScheduleCpPaymentsNoForm 40 line 26: payments from Schedule CP, Section B line 1 (composite payments)
caAb5NetLossAdditionNonet losses from businesses where the worker is an employee for California (intake ca_form540_schca.add_net_loss) — the federal Schedule C loss is disallowed for CA: Schedule CA BUSINESS addition, col C
caItemizedDeductionsNoCA itemized deduction total (Schedule CA Part II, line 29) — agent-computed per Schedule CA's own itemized rules WITH disclosure (differs from the federal Schedule A: no SALT cap, mortgage/medical add-backs, etc.). Form 540 line 18 takes the GREATER of this or the CA standard deduction; omit to use the standard deduction only.
gaFederalCdccAllowedNofederal Form 2441 line 11 allowed credit — GA IND-CR 202 pays 50% of it (us.ga.cdcc)
mdEicQualifyingChildNothe filer has at least one EIC qualifying child — with married filers this routes line 22 to 50% of the federal EIC (Worksheet 18A) and line 44 to the 45% refundable worksheet (21A); childless single/HOH/QSS filers instead get 100% refundable (18A.1). Also drives the Form 502 EIC checkboxes.
mdSsRrBenefitsSpouseNospouse's TOTAL SS/RR benefits for their 13A column
moActiveDutyMilitaryNoMO-1040 line 18: active duty military income deduction (100%, incl. annual training and — NEW 2025 — National Guard/reserve signing bonuses)
moSubtractionsSpouseNothe spouse's MO-A subtractions on the same terms
moTrustFundDonationsNoMO-1040 line 51: trust fund donations total (51a-51l)
ncMilitaryRetirementNoNC Schedule S line 21: military retirement pay / SBP payments for members with 20+ years of service OR Chapter 61 medical retirement — never severance, never double-claimed with Bailey
ncQualifyingChildrenNoD-400 line 10a: count of qualifying children for whom the federal § 24 child tax credit was ALLOWED (under 17; ODC-only dependents never count) — drives the AGI-tiered child deduction (us.nc.child_deduction)
nonrefundableCreditsNostate NONREFUNDABLE credits without an oracle target — capped at the state tax due by the composer (an excess never creates a refund). VA: do NOT put the low-income credit or any VA EITC election here — passing it forces a legacy capped path; instead pass federalEITC (+ vaFamilyVagi if testing the low-income credit) and the composer computes and SELECTS the Form 760 line 23 credit itself (TY2025 refundable VA EITC = 20% of federal EIC, uncapped — it dominates whenever federal EITC > 0). IL: pass ICR raw inputs instead where fields exist.
ohFederalCdccAllowedNofederal Form 2441 line 11 (liability-limited allowed credit) — the Ohio CDCC pays 25% of it when MAGI is $20,000-$39,999
ohOtherCreditsPreJfcNoOH Schedule of Credits lines 3+5+7+8 (lump sum retirement, lump sum distribution, displaced worker training, campaign contribution) — transcribed; they subtract BEFORE the joint filing credit's line-11 base
orItemizedDeductionsNoSchedule OR-A line 23 OREGON itemized deductions (Oregon's own computation — never the federal Schedule A total). The composer takes the larger of this and the standard deduction.
scConsumerProtectionNoSC line u: identity-theft/consumer protection services purchased after a security breach notification — the composer caps at $300 (individual) / $1,000 (joint or with dependents)
scNetLtcgAfterLossesNonet LONG-TERM capital gain held over one year, AFTER netting ALL capital losses (short-term included — the printed example nets an ST loss against the LT gain first) — the composer takes the 44% deduction (line i)
vaItemizedCharitableNoVA Sch A charitable contributions (federal Schedule A amount)
vaItemizedOtherTaxesNoVA Sch A line 6 other taxes (foreign income tax etc.)
vaItemizedSalesTaxesNoVA Sch A line 5a when the general SALES tax election was made federally — capped at the Virginia SALT cap ($40,000; $20,000 MFS for TY2025)
wiItemizedComponentsNoForm 1 Schedule 1 lines 1-4 total: federal Schedule A medical + interest (EXCLUDING out-of-state second homes, boat residences, and U.S.-security carrying interest) + charity + casualty — the composer takes 5% of the excess over the line 8 standard deduction
wiRetirement67IncomeNoqualified-plan/IRA retirement income of the 67+ individual(s) for the NEW 2025 Act 15 subtraction (SB line 16, $24,000/$48,000 cap) — CAUTION: claiming it FORFEITS every credit on lines 13-20, 30-35, and Schedule CR (the composer enforces this); compare both ways before passing
gaItemizedAdjustmentsNoForm 500 line 12b: state income taxes in the federal Schedule A total plus the disallowed-SALT proration when the $10,000/$5,000 cap bound (printed formula, hand-computed)
gaSpouseExclusionTierNospouse's GA retirement-exclusion tier (each spouse qualifies separately; never shared)
mnAdvanceCtcRepaymentNoM1 line 14b: repayment of 2025 ADVANCE Child Tax Credit payments elected on the 2024 return (reconciliation, NEW for 2025)
mnNetInvestmentIncomeNoSchedule NIIT Minnesota net investment income (federal 8960 concept minus class 2a agricultural-land gains) — the composer evaluates us.mn.niit (1% over $1,000,000) into line 14a
mnSsAlternativeMethodNothe M1M Worksheet ALTERNATIVE-method Social Security subtraction (steps 9-28, agent-computed, NET of the Tier 1 RR offset) — the composer takes the GREATER of this and the oracle simplified method when AGI exceeds the full-subtraction threshold (2025 alternative maxes: $5,840 MFJ/QSS, $4,560 single/HOH, $2,920 MFS)
mnUnderpaymentPenaltyNoM1 line 27: Schedule M15 underpayment penalty
moNetStateIncomeTaxesNoMO-A Part 2 line 11: state/local income taxes from Schedule A line 5a MINUS Kansas City/St. Louis earnings taxes (which stay deductible) — or the Part 2 worksheet result when SALT exceeded $40,000/$20,000-MFS or FAGI exceeded $500,000/$250,000-MFS
moPublicPensionSpouseNothe spouse's public-source pension for their Section A column
moUnderpaymentPenaltyNoMO-1040 line 55: Form MO-2210 underpayment penalty (90% / 66⅔%-farmer safe harbors)
ncPartnershipPaymentsNoD-400 line 21c: NC tax paid by a partnership on the filer's behalf
njNjbestContributionsNoNJ-1040 line 37a NJBEST 529 contributions (composer caps at $10,000; all three 37a-c require gross income ≤ $200,000)
orCarryforwardCreditsNoOR-40 line 30: Schedule OR-ASC line E9 carryforward credits used this year (capped at the remaining tax by the composer)
orCharitableCheckoffsNoOR-40 line 49: Schedule OR-DONATE charitable checkoffs (reduce the refund)
orExcessAptcRepaymentNoexcess advance premium tax credit repayment (1040 Schedule 2 line 1a) — SUBTRACTED in the worksheet (floor 0)
orInstallmentInterestNoOR-40 line 21: interest on installment-sale deferred tax liability (9% annual rate for 2025)
paEligibilityAddbacksNoSchedule SP Section III nontaxable add-backs (gifts, inheritances, insurance proceeds, non-PA income, nontaxable military pay, excluded home-sale gain, educational assistance, outside cash support). NOT Social Security, eligible retirement benefits, child support, or workers' comp.
paMsaHsaContributionsNoSchedule O codes M/H: MSA + HSA contributions at the federally-allowed amounts
paSpDependentChildrenNoSchedule SP dependent CHILDREN count (child/stepchild/adopted; grandchild of a grandparent; foster child of a foster parent — never other relatives) claimable as federal dependents; each adds $9,500 to the Tax Forgiveness eligibility-income threshold
paStudentLoanInterestNoSchedule O code S: student loan interest PAID (new deduction for 2025; the composer caps at $2,500 — pass the uncapped amount)
scRetirementIncomeYouNoprimary taxpayer's qualified retirement income (401(k)/403(b)/457, IRA, Keogh — EXCLUDING military retirement, which goes in scMilitaryRetirementYou) — the composer caps at $3,000 under 65 / $10,000 at 65+ (line p-1; us.sc.retirement_deduction)
scUnderpaymentPenaltyNoSC1040 line 33: underpayment of estimated tax penalty (SC2210 attached)
taxableSocialSecurityNofederally TAXABLE social security (Form 1040 line 6b, from compute_return). REQUIRED whenever nonzero: VA (760 line 5 subtraction), CA (Schedule CA line 6 col B), and NY (IT-201 line 27) all subtract it — the composer applies the subtraction automatically; do NOT also fold it into the generic subtractions total.
vaAgeQualifyingTestedNocount of filers born January 2, 1939 - January 1, 1961 (65+ for 2025 but income-tested): the composer computes $12,000 each, reduced dollar-for-dollar by AFAGI over $50,000 single / $75,000 married — where AFAGI = federal AGI MINUS the federally taxable social security (the SS exclusion is the step agents miss; Va. Code § 58.1-322.03(2))
vaSpouseAgeBlindBoxesNoSTA worksheet Part 1 line 2: spouse's 65+/blind box count (0-2)
vaSpouseTaxAdjustmentNoOVERRIDE ONLY — the composer now computes the VA Spouse Tax Adjustment worksheet itself when vaYourVagi/vaSpouseVagi are provided. If passed, this amount wins.
wiBlindWorkerExpensesNoblind worker transportation services qualifying expenses (Form 1 line 15 credits 50%)
wiRentHeatNotIncludedNorent with heat NOT included (line 16a; 3.0% table)
alTaxableRetirementYouNoprimary taxpayer's OTHERWISE-TAXABLE retirement income (IRA/401(k)/SEP/Keogh/403(b) distributions after basis recovery) — defined-BENEFIT pensions, Social Security, Railroad Retirement, military, and US/AL government retirement are 100% EXEMPT and never entered. The composer applies the 65+ $6,000 Schedule RS exclusion (us.al.retirement_exclusion).
caDepreciationAdditionNoCA depreciation-difference addition: federal depreciation (with § 168(k) bonus, which California NEVER conforms to) minus CA depreciation (plain MACRS on the same asset). Positive = CA income addition (Schedule CA col C on the business/rents line). Compute per-asset and disclose.
mnWildlifeContributionNoM1 line 18: Nongame Wildlife Fund contribution (reduces the refund)
moBusinessIncomeSpouseNothe spouse's net business income for the 20% deduction (17S)
moEnterpriseZoneSpouseNoMO-1040 line 28S
moInactiveDutyMilitaryNoMO-1040 line 19: inactive duty (drill) military income deduction
moPrivatePensionSpouseNothe spouse's private-source pension for Section B
moResidentCreditSpouseNoMO-1040 line 31S (capped at 30S)
ncUnderpaymentInterestNoD-400 line 26e: interest on the underpayment of estimated income tax (Form D-422)
ncUsObligationInterestNoNC Schedule S line 18: interest from US obligations (Treasuries, savings bonds) included in FAGI — fully deducted
njUnderpaymentInterestNoNJ-1040 line 52 interest on underpayment of estimated tax (Form NJ-2210)
ohFederalCdccTentativeNofederal Form 2441 line 9c (tentative credit before the federal liability limit) — the Ohio CDCC pays 100% of it when MAGI < $20,000
orDisabilityExemptionsNosevere-disability boxes (6a/6b) + children with a qualifying disability (6d) — $256 each, $0 cliff above $100,000 federal AGI for EVERY filing status
paSpouseRentRoyaltyNetNoPA-40 line 6, spouse's own net rent/royalty amount
paUnreimbursedExpensesNoPA-40 line 1b: Schedule UE unreimbursed employee business expenses (a compensation-class expense, never a line-10 deduction)
scFederalTaxableIncomeNoREQUIRED for SC: federal Form 1040 line 15 TAXABLE income (from compute_return, verbatim) — the SC1040 line 1 starting point (NOT federal AGI). A NEGATIVE amount is allowed: the composer enters $0 on line 1 and preserves the loss on subtraction line r per the printed instructions.
spouseStateWithholdingNoVA line 19b spouse withholding (spouse's own W-2/1099/VK-1 boxes + spouse's half of jointly-issued documents' withholding, odd dollar to the primary)
wiScheduleIAdjustmentsNoForm 1 line 2: Schedule I net adjustment (may be negative) converting federal AGI to Wisconsin's IRC — Wisconsin conforms to the Code as of December 31, 2022, so post-2022 federal changes (incl. the 2025 OBBBA) need Schedule I conversion per its instructions
mdNetCapitalGainSubjectNoForm 502CG line 9: net capital gain subject to the H.B. 352 2% surtax (line 1c gain minus the six exempt classes — primary-residence sale under $1.5M, retirement-plan assets, livestock, easement land, trade-or-business property, nonprofit affordable housing). The composer zeroes it (with a note) unless FAGI exceeds $350,000.
mnDependentEarnedIncomeNodependent-claimed filer's earned income for the dependent standard-deduction worksheet (lesser of the table amount or max($1,250, earned + $350))
ncClaimOfRightRepaymentNoNC Schedule A line 8: claim-of-right repayments over $3,000 (deducted in full)
njOrganDonationExpensesNoNJ-1040 line 36 organ/bone-marrow donation expenses (composer caps at $10,000)
njPensionEligibleAmountNojoint returns where only ONE spouse is 62+/disabled: that spouse's share of line 20a (the exclusion never covers the ineligible spouse's pension). Defaults to all of line 20a.
orDependentEarnedIncomeNodependent-claimed filer's earned income — the standard deduction is limited to max($1,350, earned + $450), capped at the Table 5 amount
scMilitaryRetirementYouNoprimary taxpayer's military retirement income — 100% deductible since TY2022 (line p-4); per the printed worksheet it REDUCES the same person's retirement-deduction CAP and age-65 deduction (instructions Example 5: $16,000 military at 65+ leaves $0 on lines p-1 and q-1) — the composer handles the interplay
vaScheduleAdjDeductionsNoSchedule ADJ line 9 total deductions (deduction CODES like 105 continuing-teacher-education, 199 other) — prints on Form 760 line 13; these are DEDUCTIONS from VAGI, never income subtractions on line 7
wiDependentEarnedIncomeNoa dependent-claimed filer's earned income for the Standard Deduction Worksheet for Dependents (deduction = smaller of the table amount or max($1,350, earned + $450))
wiEicQualifyingChildrenNofederal-EIC qualifying children — Wisconsin EIC = 4%/11%/34% of the federal credit for 1/2/3+ children (NO childless credit; MFS ineligible; full-year residents only)
caAb5GrossIncomeAdditionNogross income from businesses where the worker is classified as an EMPLOYEE for California (AB 5/Dynamex reclassification; the intake's ca_form540_schca.add_gross_income field) — Schedule CA WAGE addition, col C
caHsaTaxableDistributionNoHSA distribution amount taxed federally (Form 8889 line 16) — not income for California: the composer SUBTRACTS it for CA
gaEligibleItemizerCreditNoForm 500 line 19: Georgia Eligible Itemizer Tax Credit (NEW 2025; up to $300 per taxpayer, itemizers with 183+ GA days or resident at year end) — TRANSCRIBE the worksheet-computed amount, never assume the full $300; composer caps at $300/$600
gaRetirementEarnedIncomeNoprimary taxpayer's earned income — at most $5,000 counts inside the exclusion (Schedule 1 worksheet)
gaSpouseRetirementIncomeNospouse's unearned retirement income for the exclusion
moWftcInvestmentOver4400NoForm MO-WFTC question 3: investment income exceeds $4,400 — denies the credit. The MO credit follows EIC law FROZEN as of January 1, 2021 (MO-1040 instructions p.10), so this is the indexed pre-ARPA limit; compute investment income the pre-2021 way (taxable AND tax-exempt interest, dividends, positive net capital gain per the MO-WFTC instructions), NOT the current federal $11,950 gate.
orPoliticalContributionsNo2025 cash contributions to qualified Oregon political parties/candidates/PACs — the composer caps at $50 ($100 joint) and denies above $75,000/$150,000 federal AGI
orPoliticalPartyCheckoffNoOR-40 line 50: political party $3 checkoff from the refund
scRetirementIncomeSpouseNospouse's qualified retirement income for line p-2 (each spouse's own cap; joint returns)
unemploymentCompensationNounemployment compensation included in federal AGI (Schedule 1 line 7). REQUIRED whenever nonzero: VA fully subtracts it (Va. Code § 58.1-322.02(9), Schedule ADJ) and CA excludes it (Schedule CA line 7 col B) — the composer subtracts automatically for those states; do NOT also fold it into the generic subtractions total. IL and NY tax it (no subtraction).
wiCapitalGainSubtractionNoSchedule SB line 5 capital gain/loss subtraction from Schedule WD (30% net long-term gain exclusion, 60% farm assets; capital loss limit $3,000/$1,500-MFS since TY2023; simple mutual-fund/REIT distributions may take 30% directly)
alTaxableRetirementSpouseNospouse's otherwise-taxable retirement income (Schedule RS Part III)
mdItemizedStateLocalTaxesNoMD line 17b: state and local INCOME taxes claimed in the federal Schedule A (plus preservation-easement contributions claimed as a credit) — subtracted from 17a
njOtherRetirementEligibleNoline 28b Worksheet D gate: filer is 62 or older (the composer auto-computes the unclaimed exclusion when earned income ≤ $3,000 and line 27 ≤ $100,000)
njShelteredWorkshopCreditNoNJ-1040 line 46 Sheltered Workshop Tax Credit (GIT-317)
orFederalOtherIncomeTaxesNoother INCOME taxes from Schedule 2 lines 8, 16, 17 (income-tax recaptures only — never SE tax, SS/Medicare tip tax, household employment taxes, penalties, or excise)
vaItemizedRealEstateTaxesNoVA Sch A line 5b real estate taxes — NOT subject to the SALT cap for Virginia
alFederalRefundableCreditsNothe line 12 worksheet's refundable-credit subtraction: 1040 line 27a EIC + line 28 ACTC + line 29 AOC + line 30 refundable adoption + Schedule 3 Part II line 13a Form 2439 credits
caEducatorExpensesDeductedNofederal educator-expense deduction claimed (§ 62(a)(2)(D)) — California does NOT conform: the composer ADDS it back on Schedule CA (line 11 col C). Pass the federal amount actually deducted (both spouses' combined).
caTaxableEarlyDistributionNoretirement-plan early distribution amount subject to the FEDERAL § 72(t) additional tax — California imposes its own 2.5% additional tax on the same base (R&TC § 17085(c)(1), FTB 3805P); the composer computes 2.5% and prints it on Form 540 line 63
mdTwoIncomeLesserSpouseNetNoWorksheet 13D line 6: the LESSER-income spouse's net Maryland income (their FAGI share + additions share − subtractions share) — the composer caps it at $1,200 for line 14 (joint returns only)
njConservationContributionNoNJ-1040 line 33 qualified conservation contribution (NJ land, federal amount)
njOrganDonorEmployerCreditNoNJ-1040 line 48 employer of organ/bone-marrow donor credit (25% of salary, up to 30 days)
njOtherRetirementExclusionNoOVERRIDE: hand-computed Worksheet D line 9 unclaimed exclusion (required for the $100,001-$150,000 percentage tiers)
scMilitaryRetirementSpouseNospouse's military retirement income (line p-5)
vaItemizedMortgageInterestNoVA Sch A home mortgage interest and points (federal Schedule A amount)
moStandardDeductionOverrideNodependent-claimed filers: the federal DEPENDENT standard deduction limit (greater of $1,350 or earned income + $450, capped at the full amount) — replaces the composer's full standard deduction
orFederalRefundableAdoptionNorefundable adoption credit (1040 line 30) — subtracted
priorYearOverpaymentCreditedNoprior-year state overpayment applied toward this year's estimated tax. VA 760 line 21 (its own printed line — never fold into line 20 estimated payments). Other states: folded into the estimated-payments line.
scLowerQualifiedEarnedIncomeNothe LESSER-earning spouse's SC qualified earned income per the Two Wage Earner worksheet (earned income minus attributable federal adjustments) — line 12 credit = 0.7% capped at $50,000 base / $350 credit; MFJ only (us.sc.two_wage_earner_credit)
vaItemizedInvestmentInterestNoVA Sch A investment interest (protected from the overall limitation)
wiFederalRetirementPenaltiesNothe FEDERAL penalties on IRAs/retirement plans/MSAs etc. — Wisconsin charges 33% of them on line 25 ('x .33' printed)
wiLowerQualifiedEarnedIncomeNothe LESSER-earning spouse's Schedule 2 line 5 qualified earned income (earned income minus the listed federal Schedule 1 adjustments) — married couple credit = 3% up to $480 (joint returns, both spouses employed)
alFederalTaxDeductionOverrideNoOVERRIDE for Form 40 line 12: the RATIOED federal tax for joint-federal/separate-Alabama returns (by each spouse's FAGI share) or part-year residents (AL-AGI/FAGI ratio) — wins over the composer's oracle computation
ohBothSpousesQualifyingIncomeNojoint filing credit gate: EACH spouse has $500+ of qualifying income included in Ohio AGI (not interest/dividends/capital gains/rents, and not BID-deducted business income or deducted Social Security/retirement)
orFederalTaxLiabilityOverrideNoOVERRIDE for the worksheet line 10 result (amended federal returns, foreign income tax, 1040-NR, recapture situations — Publication OR-17 worksheets); the Table 4 AGI cap still applies via the oracle
gaSpouseRetirementEarnedIncomeNospouse's earned income for the exclusion worksheet
mdChildCareTwoOrMoreDependentsNotwo or more care dependents — raises the MD line 9 expense cap from $3,000 to $6,000
vaItemizedPersonalPropertyTaxesNoVA Sch A line 5c personal property taxes — NOT subject to the SALT cap for Virginia
vaItemizedStateLocalIncomeTaxesNoVA Sch A line 5a when INCOME taxes are claimed (mutually exclusive with sales taxes)

TDQS

A4.7/5.0
Behavior5/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full transparency burden and delivers extensively. It discloses determinism, which jurisdiction starts from which base ('NC and GA start from federalAGI', 'federalAGI is NOT the PA or NJ base', 'For SC, the base is FEDERAL TAXABLE INCOME'), what the composer computes internally vs. what the agent must compute, gate rules (e.g., the false-boolean array gate for additions/subtractions), and side effects like the Wisconsin Act 15 forfeiture: 'the SB-16 retirement subtraction FORFEITS every credit — the composer enforces the forfeiture.' It also states exclusions and refusal behaviors (composer 'refuses without' federalAGI for certain states). No contradictions with the (empty) annotations.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extraordinarily long — a dense wall of prose with state-specific rules running together without section markers, bullets, or line breaks (e.g., NC, GA, PA, NJ, OH, MD, MO all flow in one continuous paragraph). While nearly every sentence carries substantive information (so it's not padding), the lack of structure hurts scannability for an agent, and it is not 'front-loaded' — it dives into state minutiae immediately rather than giving a top-level workflow or return-value summary first. It is appropriately sized given the 386-param/16-state complexity, but poorly organized, warranting a 3 rather than higher.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness5/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the extreme complexity (386 parameters, 16 jurisdictions, no annotations, no output schema), the description is remarkably comprehensive. It covers the full workflow, state-specific computational bases, what the composer runs internally (e.g., 'the composer runs the AGI-tiered child deduction', 'the composer evaluates us.sc.retirement_deduction'), which components the agent must compute and disclose, payment/refund-related conventions (e.g., extensionPayment line differences for VA vs NY), and state-specific exceptions and prohibitions. It also addresses edge cases like negative amounts (SC line r, MO negative-share zeroing) and proration rules. With no output schema, the description's role in defining the produced line set is well fulfilled.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 99%, so the baseline is 3, and the main description correctly leaves most parameter detail to the schema. However, the description adds meaningful orchestration-level semantics for parameters whose interactions matter: it flags required-pass-when-nonzero parameters (taxableSocialSecurity, unemploymentCompensation for VA/CA/NY), per-state base inputs (scFederalTaxableIncome, alWages as 'W-2 Box 16', moFagiYou/moFagiSpouse splitting rules), and interplay constraints (SC military retirement 'REDUCES the same person's other two deductions'). It also gives anti-patterns (e.g., do not fold taxableSocialSecurity into generic subtractions, don't put SC EITC in nonrefundableCredits). This raises it above the baseline.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description opens with a specific verb-resource pairing: 'Compose a STATE return's printed-form line set deterministically' for a defined list of 16 U.S. state forms (IL-1040, VA 760, CA 540, etc.). It clarifies scope (deterministic line numbers, whole-dollar rounding) and implicitly distinguishes from sibling compute_return ('run compute_return first for the federal substrate', implying this tool is the state-level counterpart). It also states what it does NOT do (e.g., Maryland part-year returns, Kansas City/St. Louis earnings taxes), further sharpening the purpose.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Provides an explicit Workflow section: 'run compute_return first for the federal substrate, compute any state-specific components the citations describe... then call this ONCE and report its line set VERBATIM.' It gives clear when-to-use guidance (after the federal substrate) and a strong when-not-to instruction: 'Never hand-assemble state line numbers.' It also flags alternatives (e.g., 'Kansas City/St. Louis 1% earnings taxes are separate city returns the composer does not produce'), directing the agent away from this tool for those cases.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

TDQS

A4.1/5.0
Disambiguation5/5

Each tool has a clearly distinct purpose: calculate_tax handles individuals, calculate_business_tax handles entities, calculate_fiduciary_tax handles estates/trusts, compute_return produces the complete federal return, compute_state_return handles state returns, and the remaining tools cover specific lookups (parameters, rules, facts, dependencies, cliffs, tipped occupations) or verification. Even with overlapping domains (explain_rule, lookup_tax_parameter, search_tax_rules, verify_fact, verify_tax_claim), their roles are sharply delineated.

Naming Consistency4/5

Tool names follow a clear pattern: compute_return, compute_state_return, calculate_tax, calculate_business_tax, calculate_fiduciary_tax, determine_dependent, explain_rule, find_tax_cliffs, is_tipped_occupation, list_input_facts, lookup_tax_parameter, search_tax_rules, verify_fact, verify_tax_claim. Most use verb_noun (calculate_tax, lookup_tax_parameter, search_tax_rules, verify_fact). Minor deviations: compare_filing_statuses and compute_return use adjective/noun phrases rather than verb_noun, but they're still readable and follow the 'compute/calculate' theme.

Tool Count5/5

15 tools is well-scoped for a comprehensive tax computation server. Each tool covers a distinct aspect of tax law (federal individual, business, fiduciary, state returns, dependency, rule lookup, parameter lookup, validation, cliff detection, fact verification, search). No tool feels redundant, and the count supports the ambitious scope without bloating.

Completeness5/5

The tool surface covers the full tax workflow: input discovery (list_input_facts), computation (calculate_tax, calculate_business_tax, calculate_fiduciary_tax, compute_return, compute_state_return), dependency determination (determine_dependent), rule/parameter lookup (explain_rule, lookup_tax_parameter, search_tax_rules), verification (verify_fact, verify_tax_claim), and specialized analysis (find_tax_cliffs, is_tipped_occupation, compare_filing_statuses). There's no obvious gap; the only potential missing feature is payroll tax computation, but that's outside the stated domain of income tax.

Resources