{"container_scalar_contract":"CONTAINER SCALAR CONTRACT: omitting a container scalar asserts the schedule DOES NOT EXIST on this return — it does NOT mean $0. A schedule that exists and nets to zero MUST be sent explicitly as 0 (e.g. netLongTermCapGain: 0, scheduleCIncome: 0). Container scalars: netShortTermCapGain, netLongTermCapGain, capGainAggregates, collectibles28Gain, sec1250UnrecapturedGain, priorYearCapLossCarryoverST, priorYearCapLossCarryoverLT, section1256NetGain, scheduleCIncome, scheduleEIncome. This is load-bearing: the §6694 affirmation gates trigger on a schedule's EXISTENCE, so omitting a zero-net schedule silently skips them. THE ENGINE CANNOT DETECT A VIOLATION: omission is indistinguishable from absence, so this obligation is enforced by the caller, not by the engine.","capability_version":"2026-10-25.27","product":"Tax MCP","summary":"Coverage-bounded, §6694-disciplined tax compute. Computes inside the documented supported envelope (per jurisdiction below); returns a deterministic unsupported/needs_review decline outside it. No LLM in the loop.","document_intake":{"read":{"method":"POST","url":"https://tax-mcp-intake-929575446942.us-central1.run.app/api/mcp/intake/read"},"reads":"the 1099-B section of a row-tagged broker CSV export, in one layout, whole or not at all","trust":"Every value is unconfirmed evidence. Nothing reaches compute unless the caller confirms it and sends it to a compute route.","access":"internal-plan keys only","stored":"nothing; Idempotency-Key is refused","not_modeled":"Lot completeness. A read can omit or duplicate lots (a subtotal printed as a lot, a lot printed twice); every read carries lots_unreconciled. Reconcile lots against the document before summing: an omitted gain under-taxes."},"supported_envelope":{"routes":[{"id":"capabilities","method":"GET","path":"/api/mcp/tax-capabilities"},{"id":"federal_compute","method":"POST","path":"/api/mcp/tax-compute/federal"},{"id":"state_compute","method":"POST","path":"/api/mcp/tax-compute/state"},{"id":"reconcile","method":"POST","path":"/api/mcp/tax-compute/reconcile"},{"id":"what_if","method":"POST","path":"/api/mcp/tax-compute/what-if"},{"id":"review_packet","method":"POST","path":"/api/mcp/tax-compute/review-packet"},{"id":"amended_return","method":"POST","path":"/api/mcp/tax-compute/amended-return"},{"id":"efile_readiness","method":"POST","path":"/api/mcp/tax-compute/efile-readiness"},{"id":"return_lines","method":"POST","path":"/api/mcp/tax-compute/return-lines"},{"id":"draft_pdf","method":"POST","path":"/api/mcp/tax-compute/draft-pdf"}],"jurisdictions":{"federal":{"years":[2020,2021,2022,2023,2024,2025,2026],"filing_statuses":["single","married_filing_jointly","married_filing_separately","head_of_household"],"income_fields_modeled":["year","filingStatus","canBeClaimedAsDependent","filerAge65OrOlder","filerBlind","spouseAge65OrOlder","spouseBlind","spouseItemizesDeductions","wages","medicareWages","federalWithholding","priorYearTax","priorYearAGI","priorYearWasFull12MonthReturn","priorYearCitizenOrResidentAllYear","estimatedTaxNextYear","taxableInterest","ordinaryDividends","qualifiedDividends","netShortTermCapGain","netLongTermCapGain","k1s","priorYearCapLossCarryoverST","priorYearCapLossCarryoverLT","capGainAggregates","section1256NetGain","section1256CleanBrokerReportedAffirmed","section1256LossCurrentlyDeductibleAffirmed","section1256AggregateIsFinalNoAdjustmentOrDeferralAffirmed","section1256TaxpayerIsNotOptionsOrCommoditiesDealerAffirmed","section1256NotLimitedPartnerDealerEquityOptionAffirmed","mortgageInterest","mortgageAvgBalance","mortgageInterestSecuresAmtQualifiedDwelling","mortgageInterestSecuresSec121PrincipalResidence","mortgageInterestExcludesExcessRefinancingProceeds","stateLocalIncomeTax","realEstateTax","medicalExpenses","charitableCashContributions","charitableNonCashNotAppreciated","charitableNonCashPublicSecuritiesLongTerm","gamblingWinnings","gamblingLosses","investmentInterestPaid","investmentInterestCarryforward","qualifiedDisasterCasualties","foreignTaxPaid","foreignIncomeAllPassive1099","foreignTaxIsFullyCreditableAffirmed","foreignSourceGrossIncome","foreignQualifiedDividendsAndCapGains","foreignTaxNoCarryoverAffirmed","foreignSourceNoForm1116PartILines2Through5EntryAffirmed","foreignSourceNoForm1116Line16AdjustmentAffirmed","foreignTaxNoForm1116Line12ReductionAffirmed","reit199ADividends","pensionDistributionTaxable","socialSecurityBenefits","taxExemptInterest","scheduleEIncome","scheduleCIncome"],"deduction":"greater_of_standard_or_itemized_salt_and_mortgage","itemized_scope_note":"Itemized = SALT (OBBBA-2025 cap, MAGI-phased) + home mortgage interest (§163(h)(3) $750k limit — supply mortgageAvgBalance; a POSITIVE mortgageInterest also requires mortgageInterestExcludesExcessRefinancingProceeds:true — a §6694 affirmation against cash-out-refinance excess, §163(h)(3)(B)(i)/§56(e)(1) — AND EITHER mortgageInterestSecuresAmtQualifiedDwelling:true or mortgageInterestSecuresSec121PrincipalResidence:true, a §6694 AMT-preference affirmation — Form 6251 Line 3 — or the return declines fail-closed). Single/MFJ/HoH; MFS itemized declines (§63(c)(6)(A)). Also medicalExpenses (above 7.5% of AGI) and charitableCashContributions (cash to public charities, 60% of AGI; 2026+ 30% unless an attestation lifts it — see charitableCashContributions — less 0.5% of AGI), each with its attestations; non-cash gifts by Pub 526 Worksheet 2 (charitableNonCashNotAppreciated 50%, charitableNonCashPublicSecuritiesLongTerm 30%; from 2026 with charitableContributionsCompleteAffirmed); gamblingLosses up to gamblingWinnings (from 2026, 90% of losses); investmentInterestPaid plus investmentInterestCarryforward up to Form 4952 line 6 (interest + nonqualified dividends; current-year short-term items decline), excess carried forward. Other categories are out of scope.","modeled_surfaces":["ordinary tax","NIIT (Form 8960)","Additional Medicare (Form 8959)","preferential LTCG/QDIV bands","QBI §199A — REIT dividends only (qualified REIT dividends as Form 8995 defines them): 20% deduction, never wage/UBIA-limited, capped by the 20%-of-(taxable-income−net-cap-gain) overall limit (binds → declines). Business / PTP-K-1 / SSTB QBI out of scope.","Foreign Tax Credit — §904(j) de-minimis election only: foreignTaxPaid up to $300 ($600 MFJ), compared as whole dollars, with foreignIncomeAllPassive1099, foreignTaxIsFullyCreditableAffirmed and foreignTaxNoForm1116Line12ReductionAffirmed all true (any absent: decline). Above that ceiling the return declines (foreign_tax_credit_needs_review) and a preparer completes Form 1116. The Form 1116 safe harbor that used to compute above the ceiling is switched off.","simple itemized slice — SALT/property tax (OBBBA-2025 cap) + acquisition-debt mortgage interest (§750k limit), greater-of standard; Single/MFJ/HoH (MFS and incomplete mortgage facts decline); plus attested medical, charitable (cash and two non-cash categories), gambling losses and investment interest; itemizing or not, 2025-2026 qualified disaster losses (Form 4684, §63(b)(8)). Not full Schedule A — other categories are out of scope.","capital-loss carryover I/O — prior-year ST/LT capital-loss carryover (priorYearCapLossCarryoverST/LT, caller-asserted POSITIVE magnitudes) applied with the §1211(b) −$3,000 (−$1,500 MFS) annual limit + ST/LT netting; the ending carryover is returned (endingCapLossCarryoverST/LT). An AMT-only carryover (none left on the regular side) must be sent as priorYearCapLossCarryoverST/LT 0 and declines. ANY Schedule D input on the return ALSO REQUIRES capLossCarryoverNoAmtDifferenceAffirmed:true — presence of any of netShortTermCapGain/netLongTermCapGain/capGainAggregates/collectibles28Gain/sec1250UnrecapturedGain/priorYearCapLossCarryoverST/LT/section1256NetGain, of any sign, including exactly $0. NOT a positive-carryover test: a caller who nets the carryover into netLongTermCapGain before it arrives and supplies no carryover field keeps regular tax CORRECT while Form 6251 line 2k silently loses its adjustment, an executed $10,600 under-tax. Attest EITHER that no carryover exists at all, for regular tax or AMT (the common case) OR that its entering AMT-side amount equals the regular-tax amount; it covers a carryover however it reached the engine, pre-netted included. Note the scalar contract: netShortTermCapGain/netLongTermCapGain are CURRENT-YEAR nets BEFORE any carryover, never Schedule D line 15/16 — supplying a carryover-netted scalar AND the carryover field applies it twice, an executed $12,120 under-tax the engine cannot detect (Form 6251's own \"Lines 13, 14, and 15\" instruction names a different AMT-side capital-loss carryover as an independent trigger for the AMT-side Schedule D Tax Worksheet this engine does not model). Supplying the affirmation on a return with NO Schedule D input at all is a contradictory orphan affirmation → decline. Pre-netted SCALAR gains — lot-level / Form 8949 detail and covered-basis remain decline on the scalar path (a broker-reported wash-sale disallowance COMPUTES via the capGainAggregates washSaleDisallowed path under its two affirmations — see the wash_sale surface; it cannot be expressed as a pre-netted scalar); the §1250-unrecaptured (25%) and §1(h) 28%-collectibles special-rate portions ARE modeled (every SUPPORTED_TAX_YEARS year with a derivable 24%-ordinary-bracket ceiling — currently all of 2020-2026, verified; see the special-rate surface below) via sec1250UnrecapturedGain / collectibles28Gain; and a §1256-contract net (Form 6781) is modeled via section1256NetGain — TAX YEAR 2025 ONLY (a certification-evidence boundary, not an arithmetic one; other SUPPORTED_TAX_YEARS years decline) — a POSITIVE net AND, C-slice-2b, a net LOSS as the NO-ELECTION default (Form 6781 box D unchecked → the full loss splits 40/60 into the same §1211(b) −$3,000 cap + carryover + the §1411 NIIT base, which the loss reduces ONLY by the capped amount) — ALL require section1256CleanBrokerReportedAffirmed, section1256AggregateIsFinalNoAdjustmentOrDeferralAffirmed (attesting no Form 6781 line-4 adjustment and no QOF deferral upstream of the supplied aggregate), section1256TaxpayerIsNotOptionsOrCommoditiesDealerAffirmed (a registered options/commodities dealer's §1256 gain stays capital but also owes §1401 self-employment tax under §1402(i), which this engine does not compute), AND section1256NotLimitedPartnerDealerEquityOptionAffirmed (a §1256(f)(4) dealer-equity-option gain/loss allocable to a limited partner must be 100% short-term, not the standard 40/60 split, which this engine does not compute), and the LOSS additionally requires section1256LossCurrentlyDeductibleAffirmed (no §1092 straddle-loss deferral — broker box 11 cannot see an offsetting non-§1256 position, deducting a deferred loss now would UNDER-tax — and no §1212(c) carryback election); a §1256 net of exactly ZERO and a capGainAggregates §1256-flagged box still decline — see the special-rate + §1256 surfaces below. Also declines: any §1256 affirmation supplied WITHOUT section1256NetGain, and a §1256 net alongside a special-rate gain (sec1250UnrecapturedGain / collectibles28Gain — that interaction is not independently certified).","special-rate capital gain — Schedule D Tax Worksheet. The UNRECAPTURED §1250 gain (25% max, Schedule D line 19, sec1250UnrecapturedGain) and the 28%-rate gain (collectibles §408(m) + §1202 taxable portion, Schedule D line 18, collectibles28Gain) — caller-asserted PORTIONS of netLongTermCapGain — are taxed as their own stacked layers ABOVE the 0/15/20 bands, with the line-47 MAX-RATE FLOOR (a low-income filer's §1250 is taxed at their ordinary rate, not a flat 25%). §6694: a real portion omitted from these fields while still included in netLongTermCapGain UNDER-taxes it at 0/15/20, so a preparer must assert it. NOT required to be ≤ netLongTermCapGain: the IRS's own Unrecaptured §1250 Gain Worksheet / 28% Rate Gain Worksheet reduce these figures only by the 28%-rate group's own net loss, the current-year net short-term loss, and long-term capital-loss carryovers — never by an unrelated current-year long-term capital loss, which can legitimately reduce netLongTermCapGain without reducing these figures (a real-estate-plus-stock-loss pattern). The Schedule D Tax Worksheet's own line 12 (min(line 9, line 11)) safely caps the amount actually taxed at 25/28% regardless of how large these fields are relative to netLongTermCapGain — a prior pre-worksheet decline gate encoding a stricter bound was removed as its premise was refuted by primary source. The AMT is refigured with the same special rates (Form 6251 Part III — §1250 at 25%, 28%-collectibles in the 26/28 ordinary AMT base). A binding-AMT special-rate return computes ONLY when specialRateGainNoAmtScheduleDDifferenceAffirmed:true is ALSO supplied (Form 6251's own \"Lines 13, 14, and 15\" instruction conditions substituting the regular-tax Schedule D Tax Worksheet values into Part III on three statements not applying, most commonly a different AMT basis from pre-1999 §1250 straight-line ADS depreciation; the engine has no AMT-side Schedule D Tax Worksheet field at all, so it declines rather than guess when this affirmation is absent). Modeled for every SUPPORTED_TAX_YEARS year whose ordinary brackets contain a derivable 24%-rate entry — currently all of 2020-2026, verified (a future year lacking one → special_rate_gain_unmodeled decline, fail-closed rather than guessing); scalar netLongTermCapGain path (not capGainAggregates). The PRESENCE of ANY Schedule D input on the return — any of netShortTermCapGain, netLongTermCapGain, capGainAggregates, collectibles28Gain, sec1250UnrecapturedGain, priorYearCapLossCarryoverST, priorYearCapLossCarryoverLT or section1256NetGain, whatever its sign or magnitude, INCLUDING a supplied value of exactly $0 — REQUIRES collectibles28NoSec1202ExclusionPreferenceAffirmed:true — collectibles28Gain conflates §408(m) ordinary-collectibles gain with the §1202 TAXABLE portion of qualified-small-business-stock gain, and only a PRE-2010-09-28-acquired §1202 stock's EXCLUDED gain carries a Form 6251 Line 2h §57(a)(7) AMT preference (7% of the excluded amount; post-2010-09-27 stock is preference-free because §57(a)(7) reaches only stock acquired ON OR BEFORE 2010-09-27 -- Pub. L. 119-21 (OBBBA) §70431(a)(4) struck §1202(a)(4)(C) and wrote that acquisition limit into §57(a)(7) itself, RETROACTIVE to 2010-09-27 under §70431(a)(6)(B) (captioned 'Continued treatment as not item of tax preference'), so amended §57(a)(7) is the operative authority for EVERY supported year, not a TY2026+ rule. The limits are NOT identical: old §1202(a)(4)(C) reached only stock within (a)(4), while amended §57(a)(7) has no upper bound -- which is why the §1202(a)(5) tiers added for stock acquired after 2025-07-04 (50% at 3 years, 75% at 4, 100% at 5) are preference-free too, though NOT 100%-excluded); the engine hardcodes AMT otherPreferences to 0 and does not model the excluded-gain operand, so the affirmation (no §1202 involved at all, OR every §1202 exclusion is post-2010-09-27 stock) fail-closes the alternative. Supplying the affirmation on a return carrying NO Schedule D input at all is a contradictory orphan affirmation → decline, same contract as the §1256 affirmations above.","simple passive rental (Schedule E) — a NON-NEGATIVE scheduleEIncome (final Schedule E line-26 net) COMPUTES into Schedule 1 line 5 → Schedule 1 line 10 → Form 1040 line 8 → AGI AND the §1411 NIIT base, REQUIRING scheduleERentalIsPassiveFinalNet:true (final passive net — post depreciation/§465 at-risk/absorbed §469 suspended losses, no property disposition/§1250 recapture, rental real estate only, no royalties/K-1) AND scheduleERentalNotSection162Business:true (NOT a §162 trade/business → no §199A QBI) AND scheduleERentalNoAmtDifferenceAffirmed:true (attests the post-1986 depreciation AND passive-activity differences are both identical between AMT and regular tax for this activity — this field is SHARED with, not distinct from, the §469(g) disposition-release trigger described below, one attestation per activity per request). A rental LOSS (negative scheduleEIncome) COMPUTES under EITHER of two mutually-exclusive mechanisms, routed by which affirmations are supplied: (1) the §469(i) up-to-$25,000 active-participation allowance (allowance = $25,000 − 50%×(modified-AGI − $100,000), phased to $0 at MAGI ≥ $150k; MAGI = PRE-LOSS AGI over all income; the allowed portion reduces AGI, the excess SUSPENDS as an advisory Form-8582 carryforward; NIIT floors the passive rental at max(0,…) so the loss never reduces the NII base — over-tax-safe) — ONLY with ALL of scheduleERentalActiveParticipationAffirmed + scheduleERentalNoPriorSuspendedPALAffirmed + scheduleERentalAtRiskAffirmed + scheduleERentalNotRealEstateProfessionalAffirmed + ALL THREE of the non-negative-route affirmations (scheduleERentalIsPassiveFinalNet + scheduleERentalNotSection162Business + scheduleERentalNoAmtDifferenceAffirmed — the AMT-parity attestation is REQUIRED on this route), filing status ≠ married_filing_separately, and NO Social Security benefits (a §469-MAGI add-back); OR (2) the IRC §469(g)(1)(A) FULL-DISPOSITION passive-loss RELEASE, routed by asserting ANY ONE of scheduleERentalEntireInterestDisposedAffirmed / scheduleERentalFullyTaxableCashSaleAffirmed / scheduleERentalUnrelatedPartyAffirmed / scheduleERentalDispositionAtRiskAffirmed true — a taxpayer who disposes of their ENTIRE interest in a passive activity in a FULLY TAXABLE transaction (cash sale) to an UNRELATED PARTY gets the current-year loss PLUS ALL PRIOR-YEAR §469-suspended losses from that SAME activity fully deducted, UNCAPPED (no $25k limit, no MAGI phase-out — the loss is no longer characterized as passive), ONLY with ALL FOUR disposition affirmations above PLUS scheduleERentalNotRealEstateProfessionalAffirmed + scheduleERentalNotSection162Business + scheduleERentalDispositionGainReflectedAffirmed (FIVE things: (a) the property was held MORE THAN ONE YEAR — one year or less is not §1231 property, its entire gain/loss is ordinary; (b) combined with EVERY OTHER §1231 property transaction this same year, the annual §1231 netting is a NET GAIN (a net LOSS makes even this disposition's own gain wholly ordinary under §1231(a)(2)), with NO unrecaptured 5-year §1231(c) lookback recharacterizing any part as ordinary; (c) only the disposition's own FINAL RESIDUAL long-term-capital amount after that determination IS reflected in netLongTermCapGain, not omitted; (d) any unrecaptured §1250 gain in that residual is included WITHIN netLongTermCapGain (a subset) AND SEPARATELY declared via sec1250UnrecapturedGain — declaring it only within netLongTermCapGain without the separate declaration under-taxes it at 0/15/20 instead of 25%; AND (e) NO Form 4797/§1231 ordinary gain or loss of any kind exists (recapture, or lookback-recharacterized gain; the YEAR-LEVEL net §1231 loss case is already excluded by (b)'s net-gain requirement, and a DISPOSITION-level loss within a net-gain year is itself a long-term capital loss, not ordinary, and is not excluded by (e)) — the engine has no §1231-netting algorithm, no 5-year-lookback state, and no field for ordinary Form 4797 amounts, NOT wages) + scheduleERentalNoAmtDifferenceAffirmed (the AMT-side §469/§465 figures and disposition gain/loss are IDENTICAL to the regular-tax figures for this activity — this is the PRIMARY AMT safety mechanism; a computed AMT-binding check runs at the pre-release and post-release configurations as an extra, belt-and-suspenders decline, but cannot by itself rule out a cross-track AMT divergence Form 6251's own PAL/at-risk worksheet would reveal), filing status ≠ married_filing_separately. NIIT: rather than unconditionally floor the released loss for the NII base, the engine proves whether the un-modeled Form 8960 same-activity NII deduction (bounded between $0 and the full released amount) COULD change the §1411 tax owed on this specific return (an exact base-invariance test, not a proxy) — computes when provably immaterial, declines otherwise. Any other loss case (MFS, SS present with the §469(i) route, a missing affirmation, a real-estate-professional loss, an installment sale/like-kind exchange/gift/death, a related-party sale, a partial/grouped disposition, a §469(i) loss missing scheduleERentalNoAmtDifferenceAffirmed; a §469(g) release where the engine's OWN computed AMT binds at the pre- or post-release configuration (a deliberately conservative extra decline — a same-track computed check is NOT a proof of AMT safety, since the un-modeled Form 6251 line-2m amount is itself capable of pushing tentative minimum tax above regular tax on a return where this engine computes no AMT at all), or a materially NIIT-sensitive NII/MAGI shape) → schedule_e_needs_review decline, each with its own named reason. QBI is never granted on rental (affirmed absent). All declines are no-tax-number-leakage.","self-employment (Schedule C + Schedule SE) — a POSITIVE scheduleCIncome (Schedule C line-31 sole-proprietor net) COMPUTES self-employment tax (§1401/§1402: net × 0.9235 → 12.4% OASDI up to the $176,100 (2025) Social-Security wage base, COORDINATED with the SE earner's W-2 box-3 wages so the OASDI cap is not double-counted, then 2.9% Medicare uncapped) → Schedule 2, PLUS the §164(f) one-half-SE-tax above-the-line deduction (Schedule 1 line 15 → reduces AGI), and the net flows to Schedule 1 line 3 → 1040 line 8 → AGI as ordinary income (NOT the §1411 NIIT base). Net SE earnings are also pulled into Additional Medicare (Form 8959) so a combined wages+SE base over the threshold is surtaxed. The §199A QBI 20% deduction on this income is an OPT-IN via scheduleCQbiEligible (BELOW-THRESHOLD only): 20% × (net − half-SE), capped by 20% × (taxable income − net capital gain) [Form 8995]; the engine DECLINES the at/above-threshold case ($197,300 single/HoH/MFS, $394,600 MFJ, 2025 — Form 8995-A wage/UBIA/SSTB is a preparer surface). REQUIRES scheduleCIsSingleSolePropFinalNetAffirmed:true AND scheduleCNoAmtAdjustmentAffirmed:true whenever scheduleCIncome is EXPLICITLY supplied, INCLUDING exactly $0 (widened from a positive-only trigger, since a $0 regular-tax net can still embed a genuine AMT preference; the SS-wage-coordination gate below is separately exempted at exactly $0) (attesting the net contains NO Form 6251 AMT preference — depletion line 2d, circulation costs line 2o, long-term contracts line 2p, mining exploration/development costs line 2q, R&E costs line 2r, or IDCs line 2t; absent → schedule_c_needs_review, since this engine's AMT computation otherwise passes otherPreferences:0 unconditionally for a computed Schedule C, which is correct ONLY when none of these differ between regular tax and AMT); and, when the return has W-2 wages, socialSecurityWages (the SE earner's box 3) — absent → schedule_c_se_needs_social_security_wages (box-1/box-5 cannot substitute; assuming $0 over-collects OASDI and, via the half-SE deduction, under-taxes a phase-out). A Schedule C LOSS → schedule_c_loss_needs_review. OUT OF SCOPE → schedule_c_needs_review: depreciation/§179/bonus, multiple Schedule Cs, two-spouse SE allocation (the OASDI cap is per-individual), SE health-insurance (§162(l)), home-office (§280A), farm (Schedule F)/clergy/statutory-employee, the §1402 optional methods, and above-threshold / SSTB / wage-limited QBI (Form 8995-A). STATE: CA CONFORMS — a CA return with a Schedule C net taxes it in CA AGI as ordinary income (no CA SE tax, no CA §199A QBI — QBI is below-AGI and never reaches the CA base), requiring TWO CA attestations: caScheduleCSelfEmployedForCaPurposesAffirmed (AB5/ABC worker classification — CA disallows the half-SE for a reclassified employee) AND caScheduleCNoStateBusinessAdjustmentsAffirmed (zero Schedule CA 540 line-3 business-income adjustment — no CA/federal depreciation-§179 difference, no bonus depreciation, no PPP/grant exclusion difference), absent either → decline. NY ALSO CONFORMS — a NY return with a Schedule C net taxes it in NY AGI as ordinary income, requiring nyScheduleCNoStateBusinessAdjustmentsAffirmed (zero Form IT-225 §168(k)-bonus / 2025-R&E / §179-SUV business addition; NY needs no worker-classification affirmation as it has no AB5/§164(f) disallowance), absent → decline (ny_schedule_c_adjustment_needs_review). A VERIFY flag names the separate NY MCTMT (for an individual, reported on Form IT-201 lines 54a–54e; SE earnings in the MCTD over $50k) + NYC UBT (Form NYC-202), which the engine does not compute.","fully-taxable pension / annuity / IRA distribution (1040 lines 4b/5b, 1099-R box 2a) — a POSITIVE pensionDistributionTaxable COMPUTES as ORDINARY income → AGI + ordinary tax ALWAYS (NEVER the Additional-Medicare base — not wages; this field is 1099-R-ONLY — §457(f)/§409A nonqualified deferred compensation and a nongovernmental §457(b) plan are reported on Form W-2 for employee participants and on other information returns for nonemployees and beneficiaries of deceased participants, NEVER this field), REQUIRING pensionDistributionFullyTaxableAffirmed:true AND pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed:true. WHENEVER pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed:true (relying on a §72(t)/(q) exception, not age 59½+ specifically) AND pensionDistributionIsNonqualifiedAnnuityNii is NOT explicitly false, ALSO REQUIRES pensionDistributionNonqualifiedAnnuityEarlyWithdrawalBasisIsValidUnder72qAffirmed:true — §72(q)(2)'s exception list for nonqualified annuities is materially SHORTER than §72(t)(2)'s (no IRS-levy exception, among others), so a nonqualified-annuity distribution could otherwise skip the 10% additional tax on an invalid basis; absent → pension_needs_review decline. WHENEVER pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed:true (REGARDLESS of which specific basis — the engine cannot distinguish age-59½+ from a substantially-equal-periodic-payments (SEPP) basis or any other exception from that single generic field), ALSO REQUIRES pensionDistributionNoSeppModificationRecaptureAffirmed:true — §72(t)(4) (qualified plans/IRAs) and §72(q)(3) (nonqualified annuities) are PARALLEL rules (IRS Notice 2022-6 §2.07): IF the SEPP basis was ever relied upon, a series later modified (a balance addition, partial transfer, or rollover — not only a payment-amount change) before the later of 5 years or age 59½ triggers a recapture tax plus interest this engine does not compute; if no distribution ever relied on SEPP, this affirmation is trivially true; absent → pension_needs_review decline. WHENEVER pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed:true (REGARDLESS of basis), ALSO REQUIRES pensionDistributionEarlyWithdrawalBasisIsAvailableForThisPlanTypeAffirmed:true — 26 U.S.C. §72(t)(2)/(3)/(10) contains MANY plan-type-restricted exceptions (§72(t)(2) has further plan-type-restricted bases including reservist distributions (§72(t)(2)(G), uncapped), birth/adoption and emergency-personal-expense (§72(t)(2)(H)/(I), excluded from a defined benefit plan), domestic abuse (§72(t)(2)(K), excluded from a DB plan or a §§401(a)(11)/417 QJSA plan), ESOP stock dividends (§404(k)), federal phased-retirement annuities, §408(d)(4) IRA-only withdrawals, §402A(e) pension-linked emergency savings accounts, and §401(a)(39) long-term-care distributions effective for distributions after 2025-12-29) — the caller must independently verify plan-type eligibility for WHATEVER basis is claimed; these plan-type restrictions cut BOTH ways and two of them were published REVERSED until 2026-09-09 (certify-leaf round 6 on fix-simple-ira-early-distribution-prose; direction: UNDER-tax, because a caller who believed an exception applied to an IRA would affirm one they do not have). Corrected against the 2025 Instructions for Form 5329, fetched raw: separation-at-55 (exception 01) and QDRO (exception 06) are QUALIFIED-PLAN bases and each is annotated \"doesn't apply to IRAs\" -- they are NOT available to an IRA or SIMPLE-IRA holder; whereas unemployed-health-insurance (07), higher-education (08) and first-home (09) ARE IRA-only, each written \"IRA distributions made ...\". Post-separation SEPP is separately restricted (see the round-12 note below). The qualified-HSA-funding distribution is unavailable from a SEP or SIMPLE IRA — both plan types, per §408(d)(9)(B), which defines the term as a distribution from an IRA 'other than a plan described in subsection (k) or (p)'; IRS Notice 2008-51 and Pub. 969 narrow that bar to an ONGOING such plan, and an unsubstantiated ongoing status should be treated as ongoing. FEDERALLY §408(d)(9)(A) excludes it from gross income, so it is not a fully-taxable 1040 line-5b amount. This text does NOT summarize the rest of §408(d)(9): the §408(d)(9)(C) dollar cap and one-time-transfer rule, and the §408(d)(9)(D) testing-period recapture with its own (ii) death/disability exception. Read §408(d)(9) in full rather than relying on a one-sentence compression of it. CALIFORNIA DOES NOT CONFORM, and carrying the federal treatment across is an UNDER-tax: R&TC §17215.4 conforms IRC §223 out of California entirely, and per the FTB 3805P instructions 'any distribution from an IRA to an HSA must be added to adjusted gross income (AGI) on the taxpayer's California return and would be subject to a 2 1/2% additional tax under the rules for premature distributions under IRC Section 72' — owed even where NO federal §72(t) tax is. This engine models NEITHER the federal exclusion NOR the CA add-back. These few are a non-exhaustive teaching aid, not a checklist; THERE IS NO SHORTCUT: the OUTCOME CONDITION BELOW GOVERNS and is the only thing that discharges this affirmation. Neither a nonqualified annuity NOR an age-59½/death/disability/levy basis discharges it on its own. In particular neither discharges §72(m)(5), which reaches a 5-percent owner's excess-over-plan-formula amounts AT ANY TIME with no age, death, disability or levy exception and is reported on Schedule 2 line 17j, not Form 5329 Part I). IT IS NOT TRIVIALLY TRUE MERELY BECAUSE A DISTRIBUTION IS OUTSIDE §72(t): a §7702A MODIFIED ENDOWMENT CONTRACT is outside §72(t) AND §72(q) and still owes §72(v)(1)'s 10%, whose §72(v)(2) exception list is only age 59½, disability and SEPP — NO death and NO levy exception, per Form 5329 Exception 04. §72(m)(5) is a further such regime. The affirmation is keyed on the OUTCOME: affirm only if no FEDERAL CHAPTER 1 additional tax on this distribution is owed, whichever form reports it (Form 5329 Part I for §72(t)/(q)/(v); Schedule 2 for §72(m)(5)). The §1411 NII tax and state analogues are OUT OF SCOPE here — they are handled by pensionDistributionIsNonqualifiedAnnuityNii and by their own state surfaces. (the generic SEPP basis is NOT trivially true for an employer qualified plan — §72(t)(3)(B) requires the series begin post-separation, no IRA analogue); absent → pension_needs_review decline. NOT modeled (a deliberate over-decline, not a §6694 exposure): a real plan-to-plan transfer/rollover (§72(t)(4)(C)) or §1035 exchange (§72(q)(3)(B)) safe harbor added by SECURE 2.0 — this engine cannot verify either safe harbor's own precondition (combined distributions still satisfying the SEPP schedule), so it declines rather than risk a caller misjudging that test; see the field's own OpenAPI/schema doc-comment for the full citation. §1411 NIIT status is a SEPARATE whole-scalar affirmation, pensionDistributionIsNonqualifiedAnnuityNii: false (or a return whose MAGI/NII shape makes the classification immaterial) keeps it OUT of the §1411 NIIT base (a qualified-plan distribution under §401(a)/403(a)/403(b)/408/408A/457(b), IRC §1411(c)(5)); A §7702A MODIFIED ENDOWMENT CONTRACT HAS NO TRUTHFUL POLE on this field and must be left ABSENT — it is life insurance, so it is neither a nonqualified commercial annuity nor a qualified-plan distribution, and it reaches this engine legitimately as a 1099-R box 7 code D; absent is fail-closed, declining wherever the classification would change the NIIT owed. Whether a MEC distribution belongs in the §1411 NII base is NOT asserted either way. true puts the FULL amount IN the NIIT base (a nonqualified commercial annuity — annuities are explicitly named net investment income under §1411(c)(1)(A)(i)); absent AND material (MAGI over the filing-status NIIT threshold with the classification actually changing the NIIT owed) → pension_needs_review decline (exact base-invariance test, not a MAGI-threshold proxy — a return where other NII already saturates the MAGI excess computes even unaffirmed). SEPARATELY, on the /state (NY) endpoint this field is required UNCONDITIONALLY whenever nyPrivatePensionQualifiesFor20kExclusion:true is claimed on a positive pension — NY's own $20,000 exclusion has its own negative list excluding a nonqualified commercial annuity, independent of federal NIIT materiality (ny_private_pension_exclusion_classification_needed decline). The same NY endpoint ALSO requires nyPrivatePensionIsEntirelyRecipientsOwnNotInheritedAffirmed whenever the line-29 exclusion is claimed — IT-201-I's line-29 'Beneficiaries' rule gives an inherited pension a different, decedent-keyed entitlement this engine does not model; absent → ny_private_pension_beneficiary_classification_needed, affirmed false → ny_private_pension_beneficiary_allocation_unsupported. NOT modeled (a caller must NOT affirm the base pension affirmations → pension_needs_review decline): box-2b 'taxable amount not determined', basis/after-tax contributions, QCD, rollover, Roth conversion, NUA, and the early-distribution additional tax (Form 5329 10%/25%, or its CA analogue FTB 3805P — CA's rate is 2.5% under R&TC §17085(c)(1), raised to 6% where §72(t)(6) applies per §17085(c)(2), and per the 2025 FTB 3805P instructions California 'does not conform to all of the federal exceptions to the additional tax on early distributions', so a federally-valid §72(t) exception does NOT guarantee $0 of CA additional tax). NY EXCLUDES the pension on the state return (iteration 30 — IT-201 line 26 govt full / line 29 private $20k@59½; see the ny jurisdiction block below) — asserting pensionDistributionIsNonqualifiedAnnuityNii:true together with either NY pension-classification affirmation is a flat contradiction → decline (pension_exclusion_classification_ambiguous). CA CONFORMS to federal pension taxation by default — a CA pension return COMPUTES and TAXES the pension in CA AGI. ONE MODELED DIVERGENCE: caPensionIsUniformedServicesRetiredPayOrDodSbpAffirmed:true excludes min($20,000, line 5b) as uniformed-services retirement pay / a DoD Survivor Benefit Plan annuity (R&TC §§17132.9/17132.10), GATED on federal AGI — a HARD CLIFF, not a phase-out — at ≤$250,000 for married_filing_jointly or ≤$125,000 for every other filing status; absent/false → $0 excluded (not a decline). caPensionIsUniformedServicesRetiredPayOrDodSbpAffirmed:true is a flat contradiction with pensionDistributionIsNonqualifiedAnnuityNii:true (a self-funded commercial annuity cannot also be federal uniformed-services retired pay) → decline (ca_pension_exclusion_classification_ambiguous). A VERIFY flag (CA-PENSION-TAXED-CONFORMING) names this and the unmodeled CA divergences enumerated in CA_COMPUTE_CAPABILITY.state_adjustments.pension (served on GET /api/mcp/tax-compute/state), which is the single authoritative list — this text states no count of its own, because a count restated in many places is a claim that must be maintained in many places, and on this surface it was not. Nor does it restate the list: a pointer carrying its own partial copy is how a stale two-item enumeration survived beside a correct three-item one.","Social Security benefit taxation (§86 worksheet → 1040 line 6b) — a POSITIVE socialSecurityBenefits (SSA-1099 box 5 gross) COMPUTES the TAXABLE portion (0/50/85% tiers by provisional income = other AGI + tax-exempt interest + ½ benefits; base $25k single / $32k MFJ / $0 MFS-lived-with-spouse, adjusted $34k / $44k) as ORDINARY income → AGI + ordinary tax ONLY (NOT the §1411 NIIT or Additional-Medicare base). REQUIRES socialSecurityStandardCaseAffirmed:true AND taxExemptInterest supplied — a positive value also requires taxExemptInterestNoPrivateActivityBonds:true (line 2a may include PAB interest, an AMT preference the engine does not model) — AND, for MFS, socialSecurityMfsLivedWithSpouse. NOT modeled (→ social_security_needs_review decline): §86(e) lump-sum election, negative box 5 (repayment/§1341, schema-rejected), foreign/totalization SS, railroad RRB-1099 Tier-1, a §911, §931, §933, §135, §137 or §85(c) exclusion on the return. CA/NY fully EXCLUDE the taxable Social Security on the state return (Schedule CA (540) line 6 col B / IT-201 line 27; see the ca/ny jurisdiction blocks below).","underpayment-of-estimated-tax penalty — Form 2210 SAFE-HARBOR determination (IRC §6654). OPT-IN via priorYearTax: the response carries underpaymentPenalty naming the exemption that zeroes the penalty with certainty — §6654(e)(1) $1,000 de-minimis (current tax − withholding < $1,000), §6654(d)(1)(B) withholding ≥ the required annual payment = min(90% of current tax, safe-harbor% × prior-year tax) where safe-harbor% is 110% if prior AGI > $150k/$75k-MFS else 100% and the prior-year harbor needs a full 12-month prior return, or §6654(e)(2) prior-year tax $0 on a 12-month return AND the taxpayer was a US citizen/resident throughout the prior year (§6654(e)(2)(C)). When none holds → status:needs_preparer (a penalty MAY be owed). In that case the response ALSO carries an advisory penaltyCeiling — a conservative UPPER BOUND on the §6654 penalty computed under the taxpayer-least-favorable assumptions (single maximum quarterly rate, full accrual to the April 15 due date, no estimated payments); it is guaranteed ≥ the true penalty and is explicitly NOT a Form 1040 line-38 filed value (the exact per-installment amount is a preparer task). The ceiling is emitted only for a tax year whose IRS underpayment rates are fully published (fail-closed otherwise). Withholding is treated as paid evenly (§6654(g)); withholding base = federal + Additional-Medicare withholding. It is a SEPARATE line and does not change tax/AGI/refund. Federal only.","Child Tax Credit + Credit for Other Dependents (Schedule 8812 Part I, NON-refundable). qualifyingChildrenForCtc × the year's per-child amount ($2,000; $2,200 from 2025) + otherDependentsForOdc × $500 (a 2021 count of either declines), phased out 5% of AGI-over-$400k-MFJ/$200k-others (excess rounded UP to the next $1,000), then limited to tax liability → reduces 1040 line 22. REQUIRES TWO independent affirmations per credit: childTaxCreditChildrenQualifyAffirmed / otherDependentsQualifyForOdcAffirmed (the CHILD/DEPENDENT's own eligibility — valid SSN/TIN by due date, dependency, residency, support, age-under-17 — engine-invisible), AND, separately, the filer-level ID affirmation (the filer's, and if MFJ the spouse's, SSN or ITIN by the due date: odcFilerAndSpouseValidTinAffirmed; from 2025 the CTC/ACTC needs a valid SSN for the filer, or on a joint return one spouse: ctcActcFilerAndSpouseValidSsnAffirmed). Over-claim under-taxes → a positive count missing EITHER affirmation declines child_tax_credit_needs_review. The REFUNDABLE Additional Child Tax Credit (ACTC, Schedule 8812 Part II) is ALSO modeled (from 2026 subject to Schedule 3-A: federalPublicBenefitAffirmed): unused CTC → refund, capped at min(unused CTC, qualifying-children × the year's refundable per-child cap ($1,400 in 2020 to $1,700 from 2024), 15% × (earned income − $2,500)); earned income (Schedule 8812 line 18a, the Earned Income Worksheet) = W-2 wages PLUS net self-employment earnings (Schedule C line 31) MINUS one-half self-employment tax — a retiree/investment-only filer with $0 earned income gets $0 ACTC; it lands in owedOrRefund (line 28, refundable — can make owed negative). For 3+ children where the 15%-earned-income formula is the binding constraint, Schedule 8812 Part II-B (the withheld-Social-Security/Medicare-tax alternate, which may yield MORE) is NOT modeled — rather than return a possibly-too-low refund as final, the WHOLE RETURN declines child_tax_credit_needs_review. Federal only — the CA exemption credit + NY Empire State Child Credit use their own dependent inputs.","premium tax credit (Form 8962 Parts I-III, one Form 1095-A), 2020 and 2022-2025 only (2020 repays no excess advance payment, ARPA §9662): form8962Required:true with premiumTaxCredit figures line 2a from this return (Worksheet 1-1), adds the excess advance payment repayment to tax before credits (a binding AMT or the nonrefundable credits can absorb it) and subtracts the net credit in owedOrRefund; the response's premiumTaxCredit carries lines 3 and 5, the repayment and the net credit. Other cases decline premium_tax_credit_needs_review, naming the reason.","Schedule D / Form 8949 lot/evidence contract v0 (capGainAggregates) — per-box 1099-B aggregates or individual lots ({broker, form8949Box A–L (or legacy boxType A/B/D/E), proceeds, reportedBasis}) netted by the engine into ST/LT, across MULTIPLE brokers, feeding the same §1211(b) cap + carryover worksheet. COMPUTES only a COVERED NON-DIGITAL (A/D) box/lot with a positive reportedBasis, NO adjustment code / correctedBasis / lot-linkage (a broker-reported washSaleDisallowed amount NOW computes NARROWLY under its own TWO affirmations — see the wash_sale entry; every other wash shape still declines), an active non-conflicting source with a COMPLETE corrected-version lineage (sourceDocumentRef.correctionWithoutObservedOriginal:true — the doc's dedupe advisory carries correction_without_observed_original, i.e. a CORRECTED form whose original was never observed — declines for mandatory review; ABSENCE of that field is NOT an attestation the original was observed, it means the advisory was not consulted — that consultation is the preparer's §6694 obligation; distinct from correctedConflict, where two corrected versions conflict), dates consistent with the box term, AND — REQUIRED — cleanCoveredNoAdjustmentsAffirmed:true. That affirmation attests the box is uniformly clean covered, correctly classified, AND that NO wash sale is disallowed ACROSS ANY ACCOUNT, SPOUSE OR CORPORATION THE TAXPAYER CONTROLS (Pub 550) for any lot (a per-1099 'no code W' is NOT sufficient — a cross-broker/cross-spouse §1091 wash shows no code W on either 1099-B; the preparer bears that cross-account §6694 obligation). ANY other input (noncovered B/E, no-1099 C/F, digital G–L, an adjustment code, a corrected basis, a same-scope box↔lot mix, a date-vs-term mismatch, a superseded/duplicate source, or a missing affirmation) → WHOLE-RETURN decline, no tax-number leakage. Mutually exclusive with the pre-netted scalars. Lot-level dates/holding-period and equity-comp $0-basis (without the equity-comp affirmation chain) remain out of scope (decline); a broker-reported wash-sale disallowance COMPUTES NARROWLY via washSaleDisallowed + its two affirmations (see the wash_sale surface — every other wash shape still declines). Tag an equity-comp sale with equityCompType (RSU/ESPP/ISO/NSO): a COVERED (A/D) RSU, NSO, ESPP, or ISO (disqualifying disposition only) LOT (granularity:'lot' is REQUIRED — a granularity:'box' aggregate, the default, ALWAYS declines for equity-comp, since a box can aggregate many lots with different acquisition/sale dates and a single date pair can't honestly represent it) COMPUTES a comp-adjusted-basis gain when the preparer supplies equityCompOrdinaryIncome (the W-2/1099-NEC ordinary income already taxed at vest/exercise/disposition) AND affirms equityCompBasisIsCompAdjustedAffirmed:true — the engine adds that comp back to the reported basis (basis = reportedBasis + equityCompOrdinaryIncome; the 1099-B routinely reports a $0/uncorrected basis that would double-tax the comp) and nets it through the same covered-equity path (§1211(b) + §1(h) 0/15/20 + §1411 NIIT), with a loud VERIFY flag that the comp-adjusted basis is preparer-attested, not IRS-reported (the §6694 responsibility is the preparer's; the engine only enforces equityCompOrdinaryIncome ≥ 0 so the correction never LOWERS the reported basis). An ISO lot ALSO REQUIRES equityCompIsoDisqualifyingDispositionAffirmed:true AND acquiredDate/soldDate in the SAME CALENDAR YEAR (fail-closed — the engine never assumes disqualifying, and an affirmed-true CONTRADICTED by cross-year dates still declines): a same-year exercise(acquiredDate)-and-sale(soldDate) is PROVABLY disqualifying under §422(a)(1) regardless of grant date (the max intra-year gap, 365 days, can never satisfy either qualifying leg), so it is the ONLY ISO disqualifying-disposition shape the engine computes — a cross-year exercise/sale needs Form 6251 line-2k remeasurement, which the engine does not model, and a QUALIFYING ISO disposition is out of scope entirely (see below). ESPP computes for EITHER a qualifying or disqualifying §423 disposition WITHOUT the ISO-specific acquiredDate/soldDate same-year constraint (the soldDate-in-tax-year rule above still applies to every equity-comp lot including ESPP; the caller-attested equityCompOrdinaryIncome covers whichever figure applies — the engine does not derive the §423 'lesser-of' itself — and ESPP triggers no AMT preference either way, so no ISO-style same-year gate applies to it; RSU/NSO also have no same-year constraint, since neither has a qualifying/disqualifying classification risk). An equity-comp lot ALSO REQUIRES (else declines): acquiredDate + soldDate as EXACT ISO yyyy-mm-dd calendar dates (not 'VARIOUS' or any other non-lot convention), soldDate strictly AFTER acquiredDate, soldDate in the SAME calendar year as the return's tax year (a lot sold in a different year doesn't belong on this return — acquiredDate MAY be a prior year for RSU/NSO/ESPP, e.g. a normal vest-then-sell-later shape), and holding-period evidence consistent with the box term (a short-term sale asserted long would be under-taxed); a sourceDocumentRef (the broker 1099-B lot provenance); an ordinaryIncomeSourceRef (a TYPED reference — stock_plan_supplement / w2_employer_stock_plan_record / form_1099_nec / taxpayer_record — substantiating the equityCompOrdinaryIncome amount SPECIFICALLY, with an ACTIVE status; superseded/draft = conflicting source support → decline; and a COMPLETE corrected-version lineage — ordinaryIncomeSourceRef.correctionWithoutObservedOriginal:true, the comp record's dedupe advisory carrying correction_without_observed_original, declines the whole return for mandatory review BEFORE any comp-basis compute, because the comp amount RAISES basis and an over-stated comp element under-states the gain; ABSENCE of that field is NOT an attestation the original was observed — it means the advisory was not consulted, the preparer's §6694 obligation); and the comp-adjusted basis MUST NOT create/increase a LOSS (a comp adjustment only reduces a gain toward zero; a comp-created loss — a fabricated-loss / §1091 wash-sale risk — declines to a preparer). NOT modeled and NOT implied by any of the above: broad equity-comp completeness, a caller-free derivation of the §422(c)(2) cap or the §423 'lesser-of' figure, filing, live, deploy, or real-data support — every figure remains preparer-attested and every gap declines rather than guesses. A COMPUTED equity-comp return exposes the ENGINE-DERIVED correction per lot (response field equityCompDerivation): Form 8949 code-B POSTURE — col (e) keeps the broker-reported basis, col (f) = code B, col (g) = basisAdjustmentAmount (NEGATIVE: roundedReportedBasis − derivedCorrectedBasis, i.e. −the comp element after round-once); derivedCorrectedBasis = round(reportedBasis + equityCompOrdinaryIncome) is the engine's INTERNAL basis operand, NOT a col-(e) entry (transcribing it into col (e) AND applying col (g) would double-count); identities: gain = roundedProceeds − derivedCorrectedBasis = roundedProceeds − roundedReportedBasis + basisAdjustmentAmount. The caller must NOT set an adjustmentCode — the engine applies the code-B-equivalent correction internally. A COMPUTED ISO-disqualifying lot ALSO carries an ISO-DISQUALIFYING-DISPOSITION VERIFY flag naming the §422(c)(2) cap: if the disposition is AT A LOSS relative to the exercise-date FMV, ordinary income is capped at the actual gain (amount realized − strike price), never the full bargain element — caller-attested, not engine-verified. NOT modeled (still decline, equity_comp_basis_adjustment_needs_review): a QUALIFYING ISO disposition (no ordinary income for regular tax, but the AMT-side basis can differ from the regular-tax basis — a Form 6251 §56(b)(3) exercise-year-preference adjustment the engine does not model; computing it as a plain capital gain would silently mis-state AMT); a CROSS-YEAR ISO exercise/sale (the engine CANNOT determine from dates alone whether this is qualifying or disqualifying — grant date is unknown to it, so being cross-year is not itself a disqualifying signal, only the complement of the one window the engine CAN prove; either classification declines: a qualifying disposition has no ordinary income but an AMT-side basis divergence the engine does not model, and a DISQUALIFYING cross-year disposition DOES carry real §421(b) ordinary income but requires tracking the exercise-year Form 6251 line-2k AMT preference and its disposition-year reversal, prior-year AMT facts this engine does not carry); ISO exercise-and-hold (no disposition — this lot shape has no path to express it, `proceeds` is a required field); and any lot missing the affirmation/equityCompOrdinaryIncome/dates/sourceDocumentRef/ordinaryIncomeSourceRef, on a noncovered box, creating a loss, or carrying any dirty flag (wash/adjustment/date-mismatch) — all no tax-number leakage. Tag a §1256 contract with sec1256:true → a §1256-specific decline (section_1256_needs_review) FROM THE BOX PATH; to COMPUTE §1256 (tax year 2025 only, not alongside a special-rate gain) supply the affirmed aggregate via section1256NetGain (a positive net, or a net LOSS under the additional section1256LossCurrentlyDeductibleAffirmed — the no-election default) with section1256CleanBrokerReportedAffirmed, section1256AggregateIsFinalNoAdjustmentOrDeferralAffirmed, section1256TaxpayerIsNotOptionsOrCommoditiesDealerAffirmed, AND section1256NotLimitedPartnerDealerEquityOptionAffirmed, which the box path can't attest clean of §475(f) mark-to-market / straddles / loss-carryback / line-4 or QOF adjustment / dealer status / limited-partner dealer-equity-option status. Tag a crypto disposition with digitalAsset:true → a TY2026+ COVERED (box A/D, IRS-reported basis) crypto box whose units were ALL acquired by purchase AND are NOT collectibles AND are CAPITAL-not-ordinary (digitalAssetAllAcquiredByPurchase:true + digitalAssetNoneAreCollectible:true + digitalAssetIsCapitalNotOrdinary:true) COMPUTES proceeds−basis via the same covered-equity netting path (feeds §1211(b) + §1411 NIIT + §1(h) 0/15/20 LT bands); every other crypto box — pre-2026 (2025 1099-DA is proceeds-only, basis not IRS-reported), a noncovered B/E box, a missing affirmation (purchase or non-collectible), or a wash-flagged box — → digital_asset_needs_review decline. §1091 wash-sale does not apply to crypto (property) other than a tokenized security, which is not modeled; staking/mining/airdrop receipt is separately ordinary income at FMV (Rev. Rul. 2023-14), invisible to a disposition compute, which is why the purchase-only affirmation gates it; a §408(m) collectible NFT (Notice 2023-27) is taxed at 28% not 0/15/20, which the non-collectible affirmation gates; dealer/inventory/§988/Box-6 crypto is ORDINARY not capital (§1221, Notice 2014-21), which the capital-not-ordinary affirmation gates. Crypto affirmations require a tagged capGainAggregates digitalAsset box (rejected on scalar cap-gain inputs)."],"decline_codes":["year_not_modeled","special_rate_gain_unmodeled","capital_loss_carryover_amt_difference_unmodeled","estate_trust_amt_adjustment_unmodeled","k1_needs_review","dependent_filer_needs_review","out_of_scope_income","surtax_additional_medicare","itemized_deduction_needs_review","foreign_tax_credit_needs_review","capital_gain_lots_need_review","equity_comp_basis_adjustment_needs_review","section_1256_needs_review","digital_asset_needs_review","schedule_c_needs_review","schedule_c_loss_needs_review","schedule_c_se_needs_social_security_wages","schedule_e_needs_review","pension_needs_review","social_security_needs_review","child_tax_credit_needs_review","premium_tax_credit_needs_review","engine_declined"]},"ca":{"years":[2025],"filing_statuses":["single","married_filing_jointly","married_filing_separately","head_of_household"],"modeled_surfaces":["exact-rate schedule (all statuses)","Behavioral Health Services Tax (+1% > $1M)","exemption phase-out","single-status tax table","clean state-conforming non-wage income (taxable interest, ordinary/qualified dividends, net capital gain) taxed at ORDINARY CA brackets — requires stateIncomeConformsToFederal:true","Form 540 line 18 deduction = greater-of(CA standard deduction, caller-asserted caItemizedDeductions). caItemizedDeductions is the FINAL Schedule CA 540 Part II line 30 — AFTER the CA state-income-tax disallowance AND the high-income itemized-reduction worksheet — NOT the federal Schedule A total (over-asserting UNDER-taxes). REQUIRES itemizedDeductionsAreFinalStateAmount:true (a §6694 affirmation; absent → the itemized amount fail-closed declines); MFS + itemized declines (§63(c)(6)(A) spouse-itemizes election). The engine consumes it (like a W-2 box), does not derive it; a VERIFY flag also surfaces the contract.","Schedule CA (540) Part I line 2 col B — US-government-obligation interest SUBTRACTION (R&TC §17143; US-Treasury interest is federally taxable but CA-exempt). caUsObligationInterestSubtraction is a caller-asserted amount of the DIRECT US-obligation interest included in federal taxable interest (1040 line 2b), subtracted from CA AGI ONLY (never federal AGI → the exemption phase-out is untouched). REQUIRES caUsObligationInterestAffirmed:true, and is CAPPED at the supplied taxableInterest (exceeds → declines). SCOPE: direct US-obligation interest only — a RIC/§17145 fund distribution (1099-DIV/line 3b) is out of scope for THIS field (use caUsObligationRicDividendSubtraction). A subtraction over-claimed UNDER-taxes, so it fails closed without the attestation.","Schedule CA (540) Part I line 2 col B — RIC/mutual-fund US-government-obligation DIVIDEND subtraction (R&TC §17145). caUsObligationRicDividendSubtraction is the caller-asserted US-obligation-interest PORTION of a RIC/mutual-fund ORDINARY dividend (1099-DIV box 1a / 1040 line 3b), for a fund holding ≥50% US-obligation assets AT EACH QUARTER-END, subtracted from CA AGI ONLY (never federal AGI). REQUIRES the TWO-PART caUsObligationRicDividendAffirmed:true (amount per the fund's WRITTEN shareholder statement AND the fund MET the 50%-asset test), and is CAPPED at non-qualified ordinary dividends (ordinaryDividends − qualifiedDividends; US-obligation interest is never a qualified dividend). The 50%-asset test is a CLIFF — below 50%, NONE is CA-exempt (do NOT supply; prorating a sub-50% fund UNDER-taxes by the whole amount). A subtraction over-claimed UNDER-taxes, so it fails closed without the attestation.","Schedule CA (540) Part I line 2 col C — out-of-state exempt-interest-dividend ADDITION. caOutOfStateMuniInterestAddition is the caller-asserted CA-taxable portion of box-12 exempt-interest dividends / tax-exempt interest from NON-California municipal obligations (federally tax-exempt, never in federal AGI, but CA-taxable), ADDED to CA AGI ONLY (never federal AGI → the exemption phase-out is untouched). REQUIRES caOutOfStateMuniInterestAffirmed:true (the SOLE guard — exempt-interest dividends have no engine-visible cap). CA munis AND US-territory munis (PR/Guam/USVI) stay CA-exempt and are EXCLUDED, BUT California's 50%-asset test makes the ENTIRE fund dividend CA-taxable (incl. the CA portion) when the fund holds <50% CA/US-territory/US-obligation assets. NOT conformity-gated (a wages-only filer may supply it). An ADDITION is over-tax-safe; absent the affirmation it fails closed.","Schedule CA (540) Part I line 6 col B — U.S. Social Security benefits, FULLY EXCLUDED. CA does not tax Social Security; the engine recomputes the federal §86 taxable portion (1040 line 6b) in-process from socialSecurityBenefits and SUBTRACTS exactly that amount from CA AGI ONLY (never federal AGI → the exemption-credit phase-out, defined on federal AGI, correctly stays SS-inclusive). DERIVED not caller-asserted → the cap is built in (subtracts exactly what was federally included; federal 6b=$0 → $0). REQUIRES the SAME §86 gates as the federal endpoint (socialSecurityStandardCaseAffirmed:true; socialSecurityMfsLivedWithSpouse for MFS) — an unaffirmed SS return declines federally → declines CA. Tax-exempt interest (line 2a) is accepted as a §86 operand but any positive amount DECLINES (state_tax_exempt_interest_unsupported — the Schedule CA line 2 col C out-of-state-muni add-back is not sized in this slice).","Federal pension/IRA (1040 lines 4b/5b) — CA CONFORMS and TAXES it by default. A fully-taxable pension stays in CA AGI and is taxed as ordinary income (Schedule CA 540 line 5a/5b: 'generally no adjustments'). Requires BOTH pensionDistributionFullyTaxableAffirmed AND pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed (this second gate, its conditional pensionDistributionNonqualifiedAnnuityEarlyWithdrawalBasisIsValidUnder72qAffirmed requirement per fed-pension-5b-72q-levy-exception-fix above, and its pensionDistributionNoSeppModificationRecaptureAffirmed requirement per fed-pension-5b-sepp-modification-recapture-gate above, fire on the shared federal recompute this state engine calls — no separate CA-side code). ONE MODELED DIVERGENCE: caPensionIsUniformedServicesRetiredPayOrDodSbpAffirmed:true excludes min($20,000, line 5b), AGI-gated (R&TC §§17132.9/17132.10, tax years 2025-2029 — this engine only computes CA for 2025, so no separate year gate is needed) — a HARD CLIFF at federal AGI ≤$125,000 single/HOH/MFS or ≤$250,000 MFJ, confirmed against the actual R&TC section text (not just the FTB instructions summary); a flat contradiction with pensionDistributionIsNonqualifiedAnnuityNii:true declines (ca_pension_exclusion_classification_ambiguous). A VERIFY flag (CA-PENSION-TAXED-CONFORMING) fires on every CA pension return naming this and the unmodeled CA divergences enumerated in CA_COMPUTE_CAPABILITY.state_adjustments.pension (served on GET /api/mcp/tax-compute/state), which is the single authoritative list — this text states no count of its own, because a count restated in many places is a claim that must be maintained in many places, and on this surface it was not. (1) On the INCOME side: Tier-2 RAILROAD retirement (RRB-1099-R), which CA EXCLUDES (45 U.S.C. §231m) — either omitted income-side case OVER-taxes the retiree, so a preparer must subtract the applicable amount on Schedule CA 540. (2) On the ADDITIONAL tax rather than the income side, which this engine computes for NEITHER jurisdiction: California's early-distribution additional tax is 2.5% (R&TC §17085(c)(1)), raised to 6% where §72(t)(6) applies — a SIMPLE-IRA distribution within the 2-year period beginning when the taxpayer FIRST PARTICIPATED (§17085(c)(2), FTB 3805P line 4) — and per the 2025 FTB 3805P instructions California 'does not conform to all of the federal exceptions to the additional tax on early distributions', so a federally-valid §72(t) exception does NOT guarantee $0 of CA additional tax; a preparer must complete FTB 3805P by hand. Omitting THIS one UNDER-taxes, the severe direction. (3) A THIRD divergence, on the INCOME side and running the OPPOSITE way from (1): an IRA-to-HSA one-time funding distribution under §408(d)(9) is EXCLUDED from federal gross income under §408(d)(9)(A), but CA conforms IRC §223 out (R&TC §17215.4) and the FTB 3805P instructions require it ADDED BACK to CA AGI, and — where the distribution is premature under the §72(t) rules — a 2 1/2% additional tax, which can be owed even where no federal §72(t) tax is. Omitting THAT one UNDER-taxes California too, and this engine does not compute it: a CA return with pensionDistributionTaxable declines unless caNoIraToHsaFundingDistributionAffirmed is true, and with no pension field it is not detected, so such a return must not be filed from this output without adding it back by hand. A CA return with pensionDistributionTaxable also requires caPensionNoEarlyDistributionAdditionalTaxAffirmed (no R&TC §17085 additional tax) and caNoIraToHsaFundingDistributionAffirmed (no IRA-to-HSA funding distribution); either absent declines (ca_early_distribution_additional_tax_unmodeled). Not detected: an IRA-to-HSA funding distribution on a CA return with no pensionDistributionTaxable.","Schedule CA (540) Part I HSA add-backs (R&TC §17215.4 (IRC §223 HSA non-conformity; §17131.4 governs the §106(d) employer-contribution piece) — CA does not recognize HSAs). Three caller-asserted ADDITIONS to CA AGI ONLY (never federal AGI), each requiring caHsaAddbacksAffirmed:true (fail-closed): caHsaEmployerContributionAddition (W-2 box 12 code W employer/cafeteria contribution → Section A line 1h col C); caHsaInterestAddition (interest earned inside the HSA → line 2 col C); caHsaDividendAddition (taxable dividends earned inside the HSA → line 3 col C). All over-tax-safe. NOT modeled (declined/omitted): the SELF-contribution HSA deduction add-back (the engine takes no federal Form 8889 deduction → adding it back would double-count/over-tax); HSA distributions (line 8f); Archer-MSA rollover (R&TC §17215 / IRC §220, +12.5%); and the IRA-to-HSA one-time qualified-HSA-funding distribution, which is EXCLUDED federally under §408(d)(9)(A) but which CA requires added back to CA AGI (and, where the distribution is premature under the §72(t) rules, a 2 1/2% additional tax) (R&TC §17215.4; FTB 3805P instructions). That last one is the ONE item in this paragraph whose omission UNDER-taxes rather than over-taxes — the 'all over-tax-safe' statement above governs the three modeled ADDITIONS, not this omission. Do NOT also report HSA in-account earnings in taxableInterest/ordinaryDividends."],"non_wage_conformity_note":"CA taxes conforming non-wage income at ordinary brackets (no preferential capital-gains rate). Requires stateIncomeConformsToFederal:true affirming NO tax-exempt/out-of-state-muni interest, NO exempt-interest dividends OTHER THAN the out-of-state portion supplied as caOutOfStateMuniInterestAddition (a CA addition), and NO US-Treasury-obligation interest needing a CA subtraction OTHER THAN the explicitly-supplied caUsObligationInterestSubtraction (direct interest) or caUsObligationRicDividendSubtraction (RIC dividend, §17145), capital-gain basis == federal, and NO federal §1202/QSBS gain exclusion (California repealed its own QSBS exclusion for sales in taxable years beginning on or after 2013-01-01 — AB 1412, Stats. 2013 ch. 546, amending and repealing R&TC §18152.5 — so a federal exclusion, which never reaches federal AGI, is a CA ADDITION this engine cannot see; NY still conforms, so this carve is CA-only). (HSA add-backs are orthogonal — a separate over-tax-safe set of caller-asserted additions, see modeled_surfaces.) Without it, non-wage income declines. Schedule C sole-prop income NOW COMPUTES for CA (CA conforms, taxes it in CA AGI; requires caScheduleCSelfEmployedForCaPurposesAffirmed + caScheduleCNoStateBusinessAdjustmentsAffirmed + the federal sole-prop affirmation). Schedule E, non-2025, part-year/nonresident always decline.","decline_note":"Outside the modeled surface (other-status tax tables, credits, payments, OTHER Schedule CA additions/subtractions beyond the four accepted below, unaffirmed non-wage income) declines deterministically. CA itemized IS accepted as a caller-asserted line-30 total (REQUIRES itemizedDeductionsAreFinalStateAmount:true; MFS declines §63(c)(6)(A)); the DIRECT US-obligation interest subtraction IS accepted (caUsObligationInterestSubtraction, REQUIRES caUsObligationInterestAffirmed:true, capped at taxableInterest, direct-only); the RIC/mutual-fund US-obligation DIVIDEND subtraction IS accepted (caUsObligationRicDividendSubtraction, §17145, REQUIRES the two-part caUsObligationRicDividendAffirmed:true, capped at non-qualified ordinary dividends, 50%-asset cliff); the out-of-state exempt-interest-dividend addition IS accepted (caOutOfStateMuniInterestAddition, REQUIRES caOutOfStateMuniInterestAffirmed:true, over-tax-safe, CA + US-territory munis excluded, CA 50%-asset test surfaced); the HSA add-backs ARE accepted (caHsaEmployerContributionAddition / caHsaInterestAddition / caHsaDividendAddition, REQUIRES caHsaAddbacksAffirmed:true, over-tax-safe, §17215.4 (IRC §223; §17131.4 for §106(d) employer contributions) — but the self-contribution deduction add-back, HSA distributions, Archer rollover (R&TC §17215 / IRC §220), and the IRA-to-HSA one-time qualified-HSA-funding distribution are NOT modeled — that last one is federally excluded under §408(d)(9)(A) but CA adds it back to CA AGI (and, where the distribution is premature under the §72(t) rules, a 2 1/2% additional tax) (§17215.4; FTB 3805P), so unlike the others its omission UNDER-taxes CA). See modeled_surfaces.","decline_codes":["year_not_modeled","unsupported_state","nonresident_or_part_year","dependent_filer_needs_review","non_wage_income_unsupported","ambiguous_supersession_underreport_risk","itemized_needs_final_amount_affirmation","mfs_itemized_needs_review","us_obligation_subtraction_needs_review","out_of_state_muni_addition_needs_review","us_obligation_ric_subtraction_needs_review","hsa_addback_needs_review","state_tax_exempt_interest_unsupported","federal_declined","ca_pension_exclusion_classification_ambiguous","ca_early_distribution_additional_tax_unmodeled","ca_military_retirement_agi_near_limit"]},"ny":{"years":[2025],"filing_statuses":["single","married_filing_jointly","married_filing_separately","head_of_household"],"nyc_note":"New York City (NYC) resident tax is modeled for a full-year NYC resident (nycResident) within the NY 2025 surface; NYC is not a separate route — supply the NY return with NYC residency. Part-year/nonresident NYC declines.","modeled_surfaces":["selected NY 2025 compute paths (incl. NYC resident / New York City resident tax)","clean state-conforming non-wage income (interest / dividends / net capital gain) taxed at ordinary NY brackets — requires stateIncomeConformsToFederal:true AND nyWageAdditions","IT-201 line 34 deduction = greater-of(NY standard deduction, caller-asserted nyItemizedDeductions). nyItemizedDeductions is the FINAL Form IT-196 line 49 — AFTER the NY state/local income-tax ADDBACK and the NY high-income itemized LIMITATION worksheet (IT-196-I line 47: itemized limited to 50% of line-19 charity for NYAGI $1M–$10M, 25% for NYAGI over $10M; line 48 then adds the college-tuition itemized deduction) — NOT the federal Schedule A total (over-asserting UNDER-taxes). The engine consumes it (like a W-2 box), does not derive it or apply the IT-196 limitation; a VERIFY flag surfaces the contract (enhanced, tier-correct, over $1M AGI). The recapture worksheet correctly handles the resulting low-taxable-income/high-AGI case (IT-201-I worksheets 1-11).","IT-201 line 27 — taxable amount of Social Security benefits, FULLY EXCLUDED. NY does not tax Social Security; the engine recomputes the federal §86 taxable portion (1040 line 6b) in-process from socialSecurityBenefits and SUBTRACTS exactly that amount from NY AGI (line 33), NY taxable income (line 38), AND the NY recapture base — never from the Empire State Child Credit phase-out base or IT-201 line 19, which use FEDERAL AGI (correctly SS-inclusive). DERIVED not caller-asserted → cap built in (federal 6b=$0 → $0). REQUIRES the SAME §86 gates as the federal endpoint (socialSecurityStandardCaseAffirmed:true; socialSecurityMfsLivedWithSpouse for MFS) + nyWageAdditions — an unaffirmed SS return declines federally → declines NY. Tax-exempt interest (line 2a) is accepted as a §86 operand but any positive amount DECLINES (state_tax_exempt_interest_unsupported — the IT-225 A-101 non-NY-muni add-back is not sized in this slice).","IT-201 line 26 (government pension) / line 29 (private pension/annuity) — NY EXCLUDES pension, DERIVED from the computed federal line 5b and subtracted from NY AGI (line 33) / taxable income / recapture base ONLY (never the ESC phase-out base or IT-201 line 19, which use federal AGI, correctly pension-INCLUSIVE). Line 26 = NYS/local/federal GOVERNMENT-EMPLOYER pension (incl. U.S. military, its territories/possessions or any political subdivision thereof, or DC; also a nonemployee spouse's QDRO/DRO distribution from a government pension plan), FULL exclusion uncapped (§612(c)(3)), gated by nyPensionIsGovernmentPension:true. ORP PORTION LIMIT: an Optional Retirement Program participant may only affirm this for the SUNY/CUNY/NYSED-attributable portion -- a mixed ORP distribution must not affirm the whole scalar, and MUST now ALSO affirm nyGovernmentPensionNotOrpOrEntirelySunyCunyNysedAttributableAffirmed:true (EITHER not-ORP-at-all OR entirely SUNY/CUNY/NYSED-attributable) whenever nyPensionIsGovernmentPension:true is claimed -- absent/false → decline (ny_pension_orp_portion_unsupported), since this engine cannot isolate a partial ORP amount from the single line-5b scalar and will not silently grant the full exclusion to a genuinely mixed distribution. Per IT-201-I, IRC §457 GOVERNMENT deferred-comp is EXPLICITLY NOT line 26 — it goes to line 29 (capped). Line 29 = PRIVATE pension/annuity (incl. IRC §457 govt deferred comp / IRA / §403(b) / Keogh), min($20,000, line 5b) (§612(c)(3-a)), gated by nyPrivatePensionQualifiesFor20kExclusion:true (attests, for the recipient's OWN pension, 59½ before Jan 1 2025 (on a joint return, each spouse who received any of it), all of pensionDistributionTaxable is qualifying pension/annuity income per IT-201-I's PER-SOURCE periodic/lump-sum matrix (for IRA, Keogh and cafeteria/§401(k): none from contributions made after retiring) — NOT a uniform periodic-only rule: an IRA qualifies periodic or lump-sum; a Keogh qualifies periodic or lump-sum only if Form 4972 is NOT used for the lump sum; §457 govt deferred-comp, §403(b), cafeteria/§401(k), AND an ordinary employer pension (IT-201-I's own first line-29 bullet) distributions are all PERIODIC-ONLY with no lump-sum exception — and NONE of it is a nonqualified commercial annuity / QDRO nonemployee-spouse distribution / SECURE 2.0 Roth employer contribution / a government-employer pension including U.S. military retired pay (that belongs on line 26, uncapped — routing it here over-taxes by capping at $20,000) — IT-201-I's own negative list). NQDC (nonqualified deferred compensation, W-2 box 11) is a SEPARATE income source from line 5b entirely -- nyNqdcPensionWagesAmount lets a caller assert the NQDC-attributable portion of wages (bounded: must not exceed wages), REQUIRES nyNqdcPensionQualifiesFor20kExclusionAffirmed:true (attests 59½, PERIODIC payments before retirement, and NONGOVERNMENTAL plan -- absent/false decline, ny_nqdc_pension_exclusion_unsupported; supplied without a positive amount declines as an orphan affirmation), and SHARES the SAME $20,000 cap with any line-29 private pension on the same return (additive independent caps would double the ceiling and under-tax). A NY-PENSION-RAILROAD-TIER2-NOT-MODELED VERIFY flag fires on every NY pension return, naming NY's own unmodeled Tier-2 railroad-retirement exclusion (IT-225 S-122, 45 U.S.C. §231m) — the NY-side mirror of CA's already-disclosed identical divergence. A positive pension ALSO requires pensionDistributionIsNonqualifiedAnnuityNii to be explicitly true or false whenever this line-29 exclusion is claimed, UNCONDITIONALLY — not just when federal §1411 NIIT happens to make the classification material (absent → ny_private_pension_exclusion_classification_needed decline) — AND requires nyPrivatePensionIsEntirelyRecipientsOwnNotInheritedAffirmed to be explicitly true or false: IT-201-I's line-29 'Beneficiaries' rule gives an inherited pension a decedent-keyed entitlement (net of the decedent's own usage, allocated among beneficiaries) this engine does not model, so absent/false → decline (ny_private_pension_beneficiary_classification_needed / ny_private_pension_beneficiary_allocation_unsupported) rather than guess an allocation. Line 26 is unaffected — its own instruction already extends the full exclusion to a beneficiary with no allocation or decedent-age test. Each affirmation attests ALL of pensionDistributionTaxable (IRA distributions included) is of its class — a MIXED govt+private (or qualifying+non-qualifying) 5b affirms NEITHER (pension stays NY-taxable, or a preparer splits). Both affirmed → decline (pension_exclusion_classification_ambiguous). Neither affirmed → pension stays NY-taxable (over-tax-safe). Requires BOTH pensionDistributionFullyTaxableAffirmed AND pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed (this second gate's own conditional pensionDistributionNonqualifiedAnnuityEarlyWithdrawalBasisIsValidUnder72qAffirmed requirement per fed-pension-5b-72q-levy-exception-fix above, and its pensionDistributionNoSeppModificationRecaptureAffirmed requirement per fed-pension-5b-sepp-modification-recapture-gate above, also fire here, via the shared federal recompute) + nyWageAdditions."],"non_wage_conformity_note":"NY taxes conforming non-wage income at ordinary brackets / recapture (no preferential rate). Requires stateIncomeConformsToFederal:true (same attestation as CA) AND nyWageAdditions. Without the affirmation, non-wage income declines. Schedule C CONFORMS with nyScheduleCNoStateBusinessAdjustmentsAffirmed (else ny_schedule_c_adjustment_needs_review) + a VERIFY flag for the separate MCTMT/NYC-UBT. Schedule E RENTAL CONFORMS (NARROW — positive passive net, NY only) with nyScheduleENoStateBusinessAdjustmentsAffirmed (straight-line real property, no §168(k)/cost-seg/§179; else ny_schedule_e_adjustment_needs_review) AND the three FEDERAL rental affirmations, since NY re-runs the federal pipeline — all four must be supplied together. NY conforms to §469 PAL (CA Sch E stays declined: separate §469 track). non-2025, part-year/nonresident always decline.","decline_note":"Fails closed without nyWageAdditions; credits/payments beyond the modeled set and unaffirmed non-wage income decline deterministically. NY itemized IS accepted as a caller-asserted IT-196 line-49 total (see modeled_surfaces) but REQUIRES itemizedDeductionsAreFinalStateAmount:true (else declines), and MFS + itemized declines (§63(c)(6)(A) spouse-itemizes election).","decline_codes":["year_not_modeled","unsupported_state","nonresident_or_part_year","dependent_filer_needs_review","non_wage_income_unsupported","itemized_needs_final_amount_affirmation","mfs_itemized_needs_review","federal_declined","state_tax_exempt_interest_unsupported","pension_exclusion_classification_ambiguous","ny_private_pension_exclusion_classification_needed","ny_private_pension_beneficiary_classification_needed","ny_private_pension_beneficiary_allocation_unsupported","ny_pension_orp_portion_unsupported","ny_nqdc_pension_exclusion_unsupported","ny_schedule_c_adjustment_needs_review","ny_schedule_e_adjustment_needs_review","ny_wage_addback_undeterminable","ny_recapture_worksheet_boundary"]},"no_income_tax":{"states":["ak","fl","nv","sd","tx","wy","tn","nh","wa"],"years":[2020,2021,2022,2023,2024,2025,2026],"answer":"$0 state income tax for a full-year resident, or a decline. Not evaluated: business and payroll taxes, the filing requirement (notEvaluated).","required_attestations":{"nhInterestDividendsTaxNotOwedAffirmed":"NH 2020-2024: Interest & Dividends tax not owed","tnHallTaxNotOwedAffirmed":"TN 2020: Hall income tax not owed","waCapitalGainsExciseNotOwedAffirmed":"WA 2022-2026: capital gains excise not owed"},"state_income_tax_may_apply":"a required attestation is missing, any attestation is false, or interest and dividends (TN: plus net long-term gain) exceed the largest NH exemption or the TN exemption","decline_codes":["year_not_modeled","nonresident_or_part_year","state_income_tax_may_apply"]},"il":{"tool":"compute_state_return","state":"il","years":[2020,2021,2022,2023,2024,2025,2026],"residency":"full_year_resident_only","computes":["IL-1040 line 1 federal AGI","line 2 federally tax-exempt interest and dividends","line 5 Social Security and attested qualified retirement income","line 10 exemption with the federal-AGI cliff","line 12 tax at 4.95%"],"required":["canBeClaimedAsDependent","noForeignOrTerritoryExclusionAffirmed","taxExemptInterest","ilNoAdditionsOrRecaptureAffirmed","ilFilingStatusMatchesFederalAffirmed"],"optional":["ilPensionIsQualifiedRetirementIncomeAffirmed","ilDependentsClaimed","ilFilerAge65OrOlder","ilFilerBlind","ilSpouseAge65OrOlder","ilSpouseBlind"],"decline_codes":["year_not_modeled","nonresident_or_part_year","dependent_filer_needs_review","federal_declined","il_needs_review"],"not_modeled":["credits (Schedule CR other-state tax, Schedule ICR property tax and K-12 education, Illinois EITC and child tax credit) — over-tax","Schedule M subtractions (e.g. U.S. Treasury interest) and line 5 amounts other than Social Security and attested retirement income — over-tax","a married non-joint filer's spouse exemptions (allowed by 35 ILCS 5/204(c) and (d) when the spouse has no gross income and is not another taxpayer's dependent) — over-tax","household employment tax, use tax and surcharges (IL-1040 lines 20-22) — under-tax when owed","line 1 is federal AGI; the same return rounded otherwise can show a different AGI (not_modeled.cents_rounding), or a different line 5 when the pension field combines IRA and pension amounts, moving the tax by up to 4.95% of the difference plus $1; within $100 of the exemption cliff the return declines, and a larger difference there can flip the whole exemption undetected","Illinois payments, refund and the filing requirement"]},"nc":{"tool":"compute_state_return","state":"nc","years":[2020,2021,2022,2023,2024,2025,2026],"residency":"full_year_resident_only","computes":["D-400 line 6 federal AGI","line 7 interest on other states' obligations (all of taxExemptInterest)","line 9 taxable Social Security","line 10b child deduction","line 11 standard deduction","line 15 tax at the year's rate"],"required":["canBeClaimedAsDependent","noForeignOrTerritoryExclusionAffirmed","taxExemptInterest","ncNoAdditionsAffirmed","ncFilingStatusMatchesFederalAffirmed","ncStandardDeductionAllowedAffirmed"],"optional":["ncChildrenAllowedFederalCtc"],"decline_codes":["year_not_modeled","nonresident_or_part_year","dependent_filer_needs_review","federal_declined","nc_needs_review"],"not_modeled":["2026: the child deduction keys on the federal child tax credit under the Code as of January 1, 2023 (G.S. 105-228.90); a return whose credit under that Code is $0 declines","credits (Form D-400TC: tax paid to another state or country, rehabilitation and business credits) — over-tax","Schedule S deductions other than taxable Social Security (U.S. obligation interest, Bailey-settlement and uniformed-services retirement, Tier 2 railroad retirement in the pension line) — over-tax","North Carolina itemized deductions (mortgage interest and property tax up to $20,000, charitable, medical) — the standard deduction is used — over-tax","interest on North Carolina obligations is added with the rest of taxExemptInterest — over-tax","for 2021, the child deduction counts children under 17 only (the D-401 worksheet), not the federal 2021 age — at most an over-tax","consumer use tax (D-400 line 18) — under-tax when owed","line 6 is federal AGI; the same return rounded otherwise can show a different AGI (not_modeled.cents_rounding), moving the tax by up to the year's rate times the difference plus $1; with children, within $100 of a child-deduction band edge the return declines, and a larger difference there can change the band undetected","North Carolina payments, refund, estimated-tax interest (Form D-422) and the filing requirement"]},"mi":{"tool":"compute_state_return","state":"mi","years":[2020,2021,2022,2023,2024,2025,2026],"residency":"full_year_resident_only","irc_basis":"the Internal Revenue Code in effect for the tax year (an MCL 206.12(3) option)","computes":["MI-1040 line 10 federal AGI","line 11 interest on other states' obligations (all of taxExemptInterest)","line 13 Schedule 1: taxable Social Security, and with miRetirementFactsAffirmed the Tier 2/3 standard deduction or Form 4884 Section D","line 15 exemption allowance","line 17 tax at the year's rate"],"required":["canBeClaimedAsDependent","noForeignOrTerritoryExclusionAffirmed","taxExemptInterest","miNoAdditionsAffirmed","miFilingStatusMatchesAffirmed"],"required_one_of":["miNoRetirementOrAgeDeductionsAffirmed","miRetirementFactsAffirmed"],"required_with_retirement_facts":["miFilerBirthYear","miSpouseBirthYear (joint returns)"],"required_with_capital_gains":["miCapitalGainsSameForMichiganAffirmed"],"required_when_section_d_can_win":["miQualifyingRetirementBenefits"],"optional":["miDependentsClaimed","miFilerBornOnJanuary1","miSpouseBornOnJanuary1"],"decline_codes":["year_not_modeled","nonresident_or_part_year","dependent_filer_needs_review","federal_declined","mi_needs_review"],"not_modeled":["every credit, nonrefundable and refundable (including the homestead property tax credit and the earned income credit) — over-tax","every Schedule 1 subtraction other than taxable Social Security and the retirement deductions below (e.g. U.S. obligation interest, 2026-2028 tips and overtime) — over-tax","special exemptions (deaf, blind, disabled, disabled veteran), the stillbirth exemption and a married non-joint filer's spouse exemption (MCL 206.30(2)(a), when the spouse has no gross income and is not another taxpayer's dependent) — over-tax","interest on Michigan obligations is added with the rest of taxExemptInterest — over-tax","use tax — under-tax when owed","city income tax — a separate return, not part of this answer","line 10 is federal AGI; the same return rounded otherwise can show a different AGI (not_modeled.cents_rounding), moving the tax by up to the year's rate times the difference plus $1","Michigan payments, refund and the filing requirement","retirement: with miRetirementFactsAffirmed only the Tier 2 and Tier 3 standard deductions and the 2023-2025 Form 4884 Section D phase-in are computed, for a key person born 1946 or later in 2020-2025; a January 1 birthday counts as 67 a year early only with its flag (otherwise an over-tax or a decline)"]}},"reconcile":{"jurisdiction":"ca","non_mutating":true,"review_states":["match","mismatch","unsupported","needs_review"],"diff_row":"{ line, engine (engine-computed value or 'DECLINED'), filed, delta, cls, note? }","diff_classes":["MATCH","ENGINE-DECLINED","DIFFERS","NO-FILED"],"note":"Independently computes from source docs and reconciles against a filed return; never fabricates a full return. diff[].cls DIFFERS never assigns blame — a human adjudicates; ENGINE-DECLINED lines are never cross-filled from the filed value."}},"out_of_scope":["full-return preparation or filing","credits beyond the documented Child Tax Credit / Credit for Other Dependents / ACTC slices and the §904(j) de-minimis foreign tax credit (see federal.modeled_surfaces) — full Form 1116 (interest-expense apportionment, the QDI/cap-gain adjustment worksheet itself, multi-category, AMT-FTC, carryover) remains out of scope","dependent identity/residency/support derivation beyond caller-affirmed CTC/ODC counts","itemized deductions beyond SALT, home mortgage interest, medical, charitable, gambling losses and investment interest (other casualty, theft, misc.)","broad payments/refund workflows","Schedule D RESIDUAL mechanics — the §1091 replacement-basis linkage (lotId/replacementForLotId, basis increase + holding-period tack on the replacement lot), non-W Form 8949 adjustment codes, a wash amount missing either of its two affirmations, special-rate (§1250/28%-collectible) wash lots, and noncovered/no-1099 boxes — are out of scope (decline, no tax-number leakage). MODELED (see federal.modeled_surfaces): the covered-clean A/D lot/aggregate path, the NARROW broker-reported code-W wash-sale add-back under its two affirmations (the wash_sale surface), pre-netted scalar ST/LT gains, capital-loss carryover I/O, the §1250-unrecaptured (25%) / 28%-collectibles special-rate portions, and an affirmed §1256-contract aggregate (2025 only, not alongside a special-rate gain; positive net, or C-slice-2b no-election loss with section1256LossCurrentlyDeductibleAffirmed; both require section1256AggregateIsFinalNoAdjustmentOrDeferralAffirmed, section1256TaxpayerIsNotOptionsOrCommoditiesDealerAffirmed, AND section1256NotLimitedPartnerDealerEquityOptionAffirmed; Form 6781 40/60)","business residual / pass-through / QBI outside bounded slices — a POSITIVE scheduleCIncome COMPUTES only as the caller-affirmed final net of one sole proprietor (and below-threshold Schedule C QBI only with scheduleCQbiEligible); Schedule C losses, depreciation/§179/bonus, multiple Schedule Cs, spouse allocation, SE health-insurance, home-office, farm/clergy/statutory, §1402 optional methods, above-threshold/SSTB/wage-limited QBI, supplied qbiDeduction decline, and partnership and S corporation K-1s are not accepted. RENTAL: a POSITIVE (or zero) scheduleEIncome COMPUTES only as a bounded simple passive rental with THREE affirmations — scheduleERentalIsPassiveFinalNet, scheduleERentalNotSection162Business, and scheduleERentalNoAmtDifferenceAffirmed (the Form 6251 line-2m AMT-parity attestation); a rental LOSS computes only inside the six-affirmation active-participation §469(i) envelope. Missing affirmations, MFS/SS/real-estate-professional loss cases, §162/QBI trade-business rental, and CA rental business adjustments decline. All declines are no-tax-number-leakage. BOUNDARY: the engine declines only on a SUPPLIED out-of-scope field — it cannot detect income a caller OMITS (a business/rental filer who sends only wages under-reports; that is a caller/extractor responsibility)","state coverage beyond the jurisdiction surfaces above","ambiguous or corrected source documents outside the documented envelope"],"decline_codes":{"federal":["year_not_modeled","special_rate_gain_unmodeled","capital_loss_carryover_amt_difference_unmodeled","estate_trust_amt_adjustment_unmodeled","k1_needs_review","dependent_filer_needs_review","out_of_scope_income","surtax_additional_medicare","itemized_deduction_needs_review","foreign_tax_credit_needs_review","capital_gain_lots_need_review","equity_comp_basis_adjustment_needs_review","section_1256_needs_review","digital_asset_needs_review","schedule_c_needs_review","schedule_c_loss_needs_review","schedule_c_se_needs_social_security_wages","schedule_e_needs_review","pension_needs_review","social_security_needs_review","child_tax_credit_needs_review","premium_tax_credit_needs_review","engine_declined"],"state_and_reconcile":"declines outside the modeled surface; reconcile uses review_states"},"preparer_routing":{"disclaimer":"NON-EXHAUSTIVE. For each federal decline code this lists, at minimum, the forms/schedules a human preparer must handle — never the complete set. The authority for any specific case is that response's own `reason` field (per-instance and richer than this static map); a preparer must independently confirm completeness. This map computes nothing and asserts no tax figure.","authoritative_source_note":"For a given decline, read the `reason` field on that 200 response — it names the case-specific forms and thresholds. This map is a coarse per-code index into that, not a substitute for it.","by_decline_code":{"year_not_modeled":{"at_minimum":["a preparer must prepare this return for a tax year the engine does not model."],"authoritative_source":"compute-response.reason","generic":true},"special_rate_gain_unmodeled":{"at_minimum":["a preparer must apply the §1250 unrecaptured-gain and §1202 exclusion special rates via the Schedule D tax worksheet for a year the engine does not model them, or complete Form 6251 Part III by hand when an AMT-side Schedule D difference (e.g. a Schedule K-1, Form 1041, box 12 code B-F) is present."],"authoritative_source":"compute-response.reason"},"capital_loss_carryover_amt_difference_unmodeled":{"at_minimum":["a preparer must complete Form 6251 Part III (and, if applicable, an AMT-side Schedule D Tax Worksheet) by hand when a prior-year capital-loss carryover's AMT-side amount differs from the regular-tax figure the engine was given."],"authoritative_source":"compute-response.reason"},"estate_trust_amt_adjustment_unmodeled":{"at_minimum":["a preparer must complete Form 6251 by hand, entering line 2j from Schedule K-1 (Form 1041) box 12 code A and any codes B through I where the instructions direct."],"authoritative_source":"compute-response.reason"},"k1_needs_review":{"at_minimum":["a preparer must enter the Schedule K-1 (Form 1041) items this engine does not compute (any box other than 1, 2a, 2b, 3 and 4a, or a K-1 with attached statements) on the return by hand."],"authoritative_source":"compute-response.reason"},"dependent_filer_needs_review":{"at_minimum":["a preparer must complete the return of a filer who can be claimed as a dependent: Form 8615 (kiddie tax) when unearned income exceeds the threshold, and any dependents or joint filing the engine does not model."],"authoritative_source":"compute-response.reason"},"out_of_scope_income":{"at_minimum":["a preparer must handle caller-asserted income or a §199A deduction the engine does not model, or income excluded on Form 2555, Form 4563 or under §933."],"authoritative_source":"compute-response.reason","generic":true},"surtax_additional_medicare":{"at_minimum":["a preparer must determine the Additional Medicare Tax when Medicare wages (box 5) are unavailable but the return shows other objective W-2 evidence (a positive box 1 wages, box 2 federal withholding, box 3 Social Security wages, or box 6 Medicare tax withheld)."],"authoritative_source":"compute-response.reason","generic":true},"itemized_deduction_needs_review":{"at_minimum":["a preparer must review the itemized deduction — the §63(c)(6)(A) married-filing-separately rule, the §163(h)(3) mortgage-interest limit, Form 4952 investment interest (including Form 8814 amounts), non-cash gifts (Form 8283), or Form 4684 disaster losses."],"authoritative_source":"compute-response.reason","generic":true},"foreign_tax_credit_needs_review":{"at_minimum":["a preparer must complete Form 1116 for the foreign tax credit — confirm the foreign tax withheld (1099-DIV box 7) is fully creditable (not treaty over-withheld, not blocked by the §901(k)/(l) holding-period rule) via foreignTaxIsFullyCreditableAffirmed, confirm the §904(j) de-minimis election (above that ceiling the engine always declines and the preparer completes Form 1116) — see compute-response.reason for which condition failed."],"authoritative_source":"compute-response.reason"},"capital_gain_lots_need_review":{"at_minimum":["a preparer must reconcile the Form 8949 lots against the 1099-B basis, including any §1250 unrecaptured gain, §1256 contracts, or §1091 wash-sale adjustments."],"authoritative_source":"compute-response.reason"},"equity_comp_basis_adjustment_needs_review":{"at_minimum":["a preparer must adjust the equity-comp cost basis on Form 8949 against the 1099-B (missing affirmation/comp/dates/source-ref), or — for a QUALIFYING ISO disposition specifically — review the Form 6251 AMT preference (an AMT-side basis this engine does not model)."],"authoritative_source":"compute-response.reason"},"section_1256_needs_review":{"at_minimum":["a preparer must complete Form 6781 for the §1256 contracts (reconciling the 1099-B box 11, or Schedule K-1 (Form 1065) box 11 code C for a partner's allocable share), or Form 4797 if the §475(f) mark-to-market election applies."],"authoritative_source":"compute-response.reason"},"digital_asset_needs_review":{"at_minimum":["a preparer must review the digital-asset dispositions on Form 8949 / Form 1099-DA, and any ordinary-income treatment on Schedule 1, Schedule C, or Form 4797."],"authoritative_source":"compute-response.reason"},"schedule_c_needs_review":{"at_minimum":["a preparer must review the Schedule C net and its Schedule SE self-employment tax, or complete Form 6251 by hand when the net contains an AMT preference (depletion, circulation costs, long-term contracts, mining exploration/development costs, research/experimental costs, or intangible drilling costs)."],"authoritative_source":"compute-response.reason"},"schedule_c_loss_needs_review":{"at_minimum":["a preparer must apply the §465 at-risk, §469 passive-loss, and §183 hobby-loss limits to the Schedule C loss."],"authoritative_source":"compute-response.reason"},"schedule_c_se_needs_social_security_wages":{"at_minimum":["a preparer must compute the Schedule C net's Schedule SE tax with the taxpayer's W-2 Social Security wages (the §164(f) base is capped across W-2 + SE)."],"authoritative_source":"compute-response.reason"},"schedule_e_needs_review":{"at_minimum":["a preparer must handle the Schedule E rental — the §469 passive-loss limit on Form 8582, the §465 at-risk limit on Form 6198, any §199A QBI on Form 8995, and (for a full-disposition passive-loss release) any interaction with Form 6251 AMT."],"authoritative_source":"compute-response.reason"},"pension_needs_review":{"at_minimum":["a preparer must determine the taxable pension amount from the 1099-R (and any Form 5329 early-distribution tax)."],"authoritative_source":"compute-response.reason"},"social_security_needs_review":{"at_minimum":["a preparer must size the taxable Social Security under §86 using the 1099-INT / RRB-1099 and Form 1040 line 2a inputs, Form 8815 or adoption-benefit exclusions (and Form 6251 where AMT interacts)."],"authoritative_source":"compute-response.reason"},"child_tax_credit_needs_review":{"at_minimum":["a preparer must confirm the qualifying-child / other-dependent eligibility for the Child Tax Credit.","from 2026, a No on Schedule 3-A (Form 1040) line 7 or 8 needs a preparer to complete Schedule 3-A."],"authoritative_source":"compute-response.reason","generic":true},"premium_tax_credit_needs_review":{"at_minimum":["a preparer must complete Form 8962, including any excess advance premium tax credit repayment."],"authoritative_source":"compute-response.reason"},"engine_declined":{"at_minimum":["a preparer must prepare this return; read the decline reason for the specific gap."],"authoritative_source":"compute-response.reason","generic":true}}},"review_states":["match","mismatch","unsupported","needs_review"],"response_uniform_fields":["billed","retry_safe","next_action","reason","provenance"],"billing_semantics":{"computed_200_billable":true,"deterministic_decline_200_billable":true,"validation_4xx_billable":false,"server_5xx_billable":false,"idempotency_key_bills_once":true,"monthly_limit_behavior":"hard_429_cap","overage":"none"},"docs":{"supported_envelope":"https://tax-mcp.com/docs/coverage","quickstart":"https://tax-mcp.com/docs/quickstart","openapi":"https://tax-mcp.com/api/openapi.json","roadmap":"https://tax-mcp.com/roadmap"},"affirmations":{"terms":"Caller/preparer attestation fields. Each is a §6694 affirmation the preparer supplies where required; it gates a specific bounded modeled path (see modeled_surfaces) and is not a general capability claim — absent it, that path returns a deterministic decline (noForeignOrTerritoryExclusionAffirmed declines when false; form8962Required:true declines unless Form 8962 computes; omitting it computes; federalPublicBenefitAffirmed declines only when false, and omitting it computes with a VERIFY flag).","required_fields":["section1256CleanBrokerReportedAffirmed","section1256LossCurrentlyDeductibleAffirmed","section1256AggregateIsFinalNoAdjustmentOrDeferralAffirmed","section1256TaxpayerIsNotOptionsOrCommoditiesDealerAffirmed","section1256NotLimitedPartnerDealerEquityOptionAffirmed","cleanCoveredNoAdjustmentsAffirmed","scheduleERentalIsPassiveFinalNet","scheduleERentalNotSection162Business","stateIncomeConformsToFederal","itemizedDeductionsAreFinalStateAmount","ilNoAdditionsOrRecaptureAffirmed","ilFilingStatusMatchesFederalAffirmed","ncNoAdditionsAffirmed","ncFilingStatusMatchesFederalAffirmed","ncStandardDeductionAllowedAffirmed","miNoAdditionsAffirmed","miFilingStatusMatchesAffirmed","nhInterestDividendsTaxNotOwedAffirmed","tnHallTaxNotOwedAffirmed","waCapitalGainsExciseNotOwedAffirmed"],"additional_fields":["scheduleERentalActiveParticipationAffirmed","scheduleERentalNoPriorSuspendedPALAffirmed","scheduleERentalAtRiskAffirmed","scheduleERentalNotRealEstateProfessionalAffirmed","scheduleERentalEntireInterestDisposedAffirmed","scheduleERentalFullyTaxableCashSaleAffirmed","scheduleERentalUnrelatedPartyAffirmed","scheduleERentalDispositionAtRiskAffirmed","scheduleERentalDispositionGainReflectedAffirmed","scheduleERentalNoAmtDifferenceAffirmed","scheduleCIsSingleSolePropFinalNetAffirmed","scheduleCNoAmtAdjustmentAffirmed","scheduleCPersonalServicesCapitalNotMaterialAffirmed","pensionDistributionFullyTaxableAffirmed","pensionDistributionNotSubjectToEarlyWithdrawalPenaltyAffirmed","pensionDistributionNonqualifiedAnnuityEarlyWithdrawalBasisIsValidUnder72qAffirmed","pensionDistributionEarlyWithdrawalBasisIsAvailableForThisPlanTypeAffirmed","pensionDistributionNoSeppModificationRecaptureAffirmed","pensionDistributionIsNonqualifiedAnnuityNii","mortgageInterestExcludesExcessRefinancingProceeds","socialSecurityStandardCaseAffirmed","childTaxCreditChildrenQualifyAffirmed","ctcActcFilerAndSpouseValidSsnAffirmed","federalPublicBenefitAffirmed","otherDependentsQualifyForOdcAffirmed","odcFilerAndSpouseValidTinAffirmed","caUsObligationInterestAffirmed","caScheduleCSelfEmployedForCaPurposesAffirmed","nyScheduleCNoStateBusinessAdjustmentsAffirmed","caScheduleCNoStateBusinessAdjustmentsAffirmed","caOutOfStateMuniInterestAffirmed","caUsObligationRicDividendAffirmed","caHsaAddbacksAffirmed","nyScheduleENoStateBusinessAdjustmentsAffirmed","caPensionIsUniformedServicesRetiredPayOrDodSbpAffirmed","caPensionNoEarlyDistributionAdditionalTaxAffirmed","caNoIraToHsaFundingDistributionAffirmed","equityCompBasisIsCompAdjustedAffirmed","washSaleDisallowedIsCompleteAffirmed","washSaleLotsNotSpecialRateAffirmed","washLotIsSingleAcquisitionBlockAffirmed","washLotIsCombinedMultiBlockAffirmed","equityCompIsoDisqualifyingDispositionAffirmed","foreignTaxNoCarryoverAffirmed","foreignSourceNoForm1116PartILines2Through5EntryAffirmed","foreignSourceNoForm1116Line16AdjustmentAffirmed","foreignTaxNoForm1116Line12ReductionAffirmed","foreignTaxIsFullyCreditableAffirmed","priorYearWasFull12MonthReturn","priorYearCitizenOrResidentAllYear","thisReturnWillBeFiledCovering12Months","sameSpouseAsThisReturn","foreignIncomeAllPassive1099","digitalAssetAllAcquiredByPurchase","digitalAssetNoneAreCollectible","digitalAssetIsCapitalNotOrdinary","taxExemptInterestNoPrivateActivityBonds","socialSecurityMfsLivedWithSpouse","spouseItemizesDeductions","canBeClaimedAsDependent","form8962Required","enteredPerForm8962InstructionsAffirmed","noForeignOrTerritoryExclusionAffirmed","seniorDeductionEligibilityAffirmed","scheduleCQbiEligible","medicalExpensesQualifyingUnreimbursedAffirmed","medicalExpensesNotCompensatedOtherwiseAffirmed","charitableCashToPublicCharitiesSubstantiatedAffirmed","charitableNoOtherContributionsOrCarryoverAffirmed","charitableNonCashNotAppreciatedAffirmed","charitableNonCashPublicSecuritiesAffirmed","charitableContributionsCompleteAffirmed","gamblingWinningsGrossAndLossesSubstantiatedAffirmed","investmentInterestQualifiesAffirmed","qualifiedDisasterCasualtyAffirmed","nyPrivatePensionQualifiesFor20kExclusion","nyPensionIsGovernmentPension","nyGovernmentPensionNotOrpOrEntirelySunyCunyNysedAttributableAffirmed","nyNqdcPensionWagesAmount","nyNqdcPensionQualifiesFor20kExclusionAffirmed","nyPrivatePensionIsEntirelyRecipientsOwnNotInheritedAffirmed","mortgageInterestSecuresAmtQualifiedDwelling","mortgageInterestSecuresSec121PrincipalResidence","collectibles28NoSec1202ExclusionPreferenceAffirmed","specialRateGainNoAmtScheduleDDifferenceAffirmed","capLossCarryoverNoAmtDifferenceAffirmed","estateTrustK1NoAmtAdjustmentAffirmed","k1AmountsNotReportedElsewhereAffirmed","otherBoxesBlankAffirmed","ilPensionIsQualifiedRetirementIncomeAffirmed","miCapitalGainsSameForMichiganAffirmed","miNoRetirementOrAgeDeductionsAffirmed","miRetirementFactsAffirmed"]},"not_modeled":{"draft_pdf":"The return_lines Form 1040 and schedules on IRS PDFs, a draft not for filing; return_lines' gaps apply. Not rendered: other forms, names and SSNs, dependents, the digital assets answer, signatures, bank details. REST only.","return_lines":"Form 1040 lines 1a-38 and Schedules 1-3, 8812 and D's totals of an original return, 2023-2025; the amounts are this compute, so every federal not_modeled entry applies. Lines with no engine input are assumed_zero; every total treats them as 0. Not covered: other schedules.","efile_readiness":"Form 8879 for an original Form 1040, 2023-2025; the amounts are this compute, so every federal not_modeled entry applies. Not covered: a Form 1040-X e-file, 2026, line 25c beyond Form 8959 (W-2G, K-1, 1042-S, 8805, 8288-A), EIC, AOTC, the 2025 refundable adoption credit, Schedule 3 payments other than line 10 and the PTC, and the line 38 penalty amount, which is the caller's.","amended_return":"Form 1040-X 2020-2025; column C is this compute, so every federal not_modeled entry applies; column A is the as-filed figures. Declines any change into or out of married filing jointly; requires an attestation that column C has no withholding, EIC or refundable credit beyond what this engine computes. Not judged: the refund time limit (§6511).","estimated_tax_next_year":"Uses 110% unless AGI is at least $1,000 below the threshold, and figures it on tax shown + $100, to cover how the filer rounds. Too low when the filed return has a tax Form 1040-ES counts that the engine does not compute (e.g. Schedule H). Not offered: the 90% prong, annualized income, farming/fishing.","additional_tax_in_a_year_with_no_distribution":"A CLASS of Form 5329 additional taxes that can be owed in a year with NO distribution and NO current-year account activity is not modeled, and this engine cannot DETECT any of them: §72(t)(4)/§72(q)(3) recapture on the MODIFICATION of a substantially-equal-periodic-payment series (§72(t)(4)(A)(ii) says only that a series is 'modified'; that CESSATION counts as a modification is IRS GUIDANCE - Rev. Rul. 2002-62 §2.03(a), carried into Notice 2022-6 - not statutory text, and it binds where the change occurs before the later of 5 years or age 59½. The year a series stops CAN have no distribution at all — an annual series skipped outright; a monthly or quarterly series stopped mid-year still has one); §4974 excess-accumulation tax on an RMD shortfall (a missed RMD is itself an ABSENT event, so requiring evidence of a distribution before evaluating it reverses the logic); and §4973 excess-contribution tax, which can recur annually on an unresolved prior-year excess with no new contribution and no distribution, and which also reaches non-retirement accounts including HSAs (§4973(g)), Coverdell ESAs (§4973(e)) and ABLE accounts (§4973(h)). A return that DOES carry pensionDistributionTaxable, even $0, must attest pensionDistributionNoSeppModificationRecaptureAffirmed or it declines; the undetected case is a return with NO pension field. WHY IT IS NOT DETECTED: nothing in this schema records that a series, an RMD obligation or an unresolved excess EXISTS. Two taxpayers — one who never had a SEPP series, one who stopped an undisclosed series this year — can send BYTE-IDENTICAL valid input, and a deterministic function cannot distinguish identical inputs. So no OPTIONAL caller-supplied flag closes it: a caller who would answer such a flag truthfully is a caller who can already force the decline (below), and one who omits it is unchanged. This is a DECLARED OPEN GAP, NOT an impossibility: it would close under an UNCONDITIONAL attestation demanded on every return whether or not any pension field is present, which was weighed and rejected as disproportionate to the risk, since every other gate on this endpoint is triggered by something the CALLER ACTUALLY SUPPLIED - an amount, an affirmation, or a schedule - rather than demanded unprompted of every return. That is a product tradeoff, and it can be revisited. HOW A CALLER FORCES A DECLINE TODAY, FOR THE §72(t)(4)/§72(q)(3) INSTANCE ONLY: supply pensionDistributionNoSeppModificationRecaptureAffirmed:false, which declines regardless of the distribution amount, including zero and absent. Do NOT use that field as a general lever for the other two: it means specifically that a SEPP series WAS modified, so a caller with a missed RMD or an unresolved excess and no SEPP series would be denying something they could truthfully affirm. THERE IS NO LEVER TODAY for §4974 or §4973 - these are ADDITIVE Form 5329 amounts, so a caller who knows either applies adds it outside this engine rather than taking the whole return elsewhere. Do NOT read the absence of a decline as a determination that no additional tax is owed — this engine computes the components it supports and makes no claim of complete return coverage. Treasury Regulation §1.6694-2(d)(3)(iii) (\"Requirements for advice\", inside paragraph (d)(3) \"Adequate disclosure\") requires a preparer's advice to be particular to the taxpayer and tailored to the taxpayer's facts and circumstances, and states that a general disclaimer will not satisfy that requirement; this entry is therefore a SCOPE STATEMENT about the engine, not preparer disclosure, and the preparer remains responsible for determining whether any of these applies.","cents_rounding":"Each federal amount is rounded once, at its form line, before compute, so cents give the same result as whole dollars, and where the federal return is computed one between 0 and 50 cents declines; state-only amounts keep their cents. priorYearAGI, estimatedTaxNextYear, gamblingLosses, capGainAggregates and premiumTaxCredit keep their cents for their own forms. A field that totals several form entries (Schedule B payers, Schedule D lines 1a-4, Form 1040 lines 4b and 5b) is rounded once, and K-1 interest and dividends once per K-1; either can differ by $1 per entry from the other way. On a whole-dollar return, the Qualified Dividends and Capital Gain Tax Worksheet, the Schedule D Tax Worksheet and Form 6251 with its exemption worksheet are rounded line by line, and keeping cents inside them instead can change total tax by up to $2 either way. The Social Security Benefits Worksheet is rounded only at line 18, so taxable benefits, and AGI with them, can be $1 below that worksheet rounded line by line.","excluded_foreign_and_territory_income":"Income excluded under §911 (Form 2555), §931 or §933 is not modeled (it has no input); noForeignOrTerritoryExclusionAffirmed is required on every federal and state request, and false declines the federal return and a CA, NY, IL, NC or MI return.","federal_itemized":"Full federal Schedule A itemized deductions (itemizedDeductions) are not modeled — SALT, home mortgage interest, medical, charitable, gambling losses and investment interest compute, and 2025-2026 qualified disaster losses (§63(b)(8)); other casualty and theft losses and misc itemized have no input (over-tax). Non-cash gifts outside the two attested categories have no input (over-tax). From 2026, cash above 30% of AGI is capped there unless an attestation lifts it (see charitableCashContributions): unreported gifts or carryovers may cut the new §170(b)(1)(G)(i) cash limit (over-tax). Investment interest, over-tax: no Form 4952 line 4g election; the AMT carryforward is taken as 0 (Form 6251 line 2c); NIIT line 9a is not reduced. Not modeled, all over-tax: charitable carryovers (in or out); the non-itemizer cash deductions (2020 $300, 2021 $300/$600, 2026 §170(p); the itemize-or-standard choice ignores them too) and the 2020-2021 100%-of-AGI cash election; 2020-2024 qualified disaster losses; two $500 floors for one storm over two declared areas (one casualty, one floor); NIIT: the disaster loss offsets net gain only; the 2026 0.5% charitable floor is rounded up and the 2026 percentage limits down (≤ $1 each); a slot session method (AM 2008-011) where supportable (gambling results are per wager).","child_tax_credit_federal_public_benefit":"2026 and later: Schedule 3-A (Form 1040) withholds the refunded ACTC from a filer answering No on its line 7 or 8 (proposed Treas. Reg. §1.24-3, REG-119882-25; may reach 2026). false declines. Omitted computes as if Yes, flagged VERIFY: for a filer who would answer No the refund is overstated (an under-tax), and Form 2210 figures that subtract the ACTC may be off by as much.","child_tax_credit":"2021: Schedule 8812 Part III (repaying excess advance child tax credit payments) has no input: a return that got more advance payments than its credit is under-taxed by up to the excess. 2020: the election to use 2019 earned income is not modeled (over-tax).","premium_tax_credit":"Form 8962 computes only for 2020 and 2022-2025 with premiumTaxCredit (modeled_surfaces); other form8962Required:true returns decline. When form8962Required is omitted, excess advance premium tax credit to repay (Schedule 2) is not added to total tax (an under-tax), and a net premium tax credit (Schedule 3) is not applied (the refund is understated or the amount owed overstated).","amt":"The prior-year minimum tax credit (Form 8801) is not applied and has no input (over-tax for a credit holder). Standalone Alternative Minimum Tax (AMT) is not a caller input. Form 6251 Part III carries qualified dividends and capital gain, including the modeled special-rate gain (any SUPPORTED_TAX_YEARS year with a derivable 24%-bracket ceiling); AMT preferences/adjustments beyond that (ISO bargain element, private-activity-bond interest, non-qualified-dwelling mortgage interest — Form 6251 Line 3 — depreciation preferences) are not modeled; a positive mortgageInterest REQUIRES mortgageInterestExcludesExcessRefinancingProceeds:true (attests no cash-out-refinance excess over the pre-refi balance is included; §163(h)(3)(B)(i) imposes the identical cap for REGULAR TAX, not just AMT) AND EITHER mortgageInterestSecuresAmtQualifiedDwelling:true (§56(e)(2) qualified dwelling) OR mortgageInterestSecuresSec121PrincipalResidence:true (§56(e)(1)(A) principal residence, no dwelling-type restriction — a genuine principal-residence houseboat qualifies here) — the two dwelling prongs are disjunctive; §56(e)(3) (pre-1982 indebtedness) is a third, unmodeled qualifying category (over-decline direction only). Absent required affirmations declines. Form 6251 line 2j (estate/trust Schedule K-1 (Form 1041) box 12 code A) is $0: a return with interest, dividends, positive tax-exempt interest, Schedule D or Schedule E input declines unless estateTrustK1NoAmtAdjustmentAffirmed:true; not detected: a K-1 with a code A or B-I amount but no income boxes, on a return with none of those. When AMT binds (amount > 0), amtDerivation is PRESENT, with the Form 6251 proof-of-work trace (AMTI, exemption, AMT base, tentative minimum tax, and the add-on amount) or, when that trace is declined (the special-rate case above, or a failed faithfulness check), no total or steps; ABSENT means AMT did not bind. totalTax is not simply incomeTax + amtDerivation.total — it also folds in any SE tax, NIIT, and Additional-Medicare tax.","unrecaptured_1250":"The engine does not DERIVE unrecaptured section 1250 gain from depreciation records. Only a caller-asserted portion of net LT gain (sec1250UnrecapturedGain; any SUPPORTED_TAX_YEARS year with a derivable 24%-bracket ceiling — currently all of 2020-2026) is taxed at its 25%-max layer; an omitted portion is taxed at 0/15/20 — a preparer must supply it.","collectibles_28_percent":"The engine does not identify collectibles from a 1099-B. Only a caller-asserted portion of net LT gain (collectibles28Gain; any SUPPORTED_TAX_YEARS year with a derivable 24%-bracket ceiling — currently all of 2020-2026) is taxed at the 28% layer; otherwise not modeled.","wash_sale":"Wash-sale (§1091) compute is NARROWLY modeled (C-slice-1): a covered A/D box/lot's broker-reported NON-NEGATIVE washSaleDisallowed amount (1099-B box 1g / Form 8949 col-g code-W) is ADDED BACK to the gain — ONLY with BOTH wash affirmations: washSaleDisallowedIsCompleteAffirmed (the amount is the ENTIRE §1091 disallowance incl. cross-account/cross-broker/IRA/spouse/controlled-corporation replacements per Rev. Rul. 2008-5, and the box is otherwise uniformly clean covered — an under-stated amount under-states the gain; that residual is the preparer's, a loud VERIFY flag fires) AND washSaleLotsNotSpecialRateAffirmed (no lot is §1250-unrecaptured or 28%-collectible property — a separate CHARACTER attestation, never folded into completeness). Encoding: transcribe the col-(g) W amount into washSaleDisallowed; adjustmentCode:'W' + adjustmentAmount still DECLINE (the signed multi-code channel stays closed). Still DECLINING: a wash amount with either affirmation missing; a wash box also carrying cleanCoveredNoAdjustmentsAffirmed (a contradiction — that affirmation attests NO wash exists); a wash amount on an equity-comp lot (stacked adjustment dimensions) or a digital-asset box (§1091 does not apply — contradictory evidence); wash coexisting with caller-asserted sec1250UnrecapturedGain/collectibles28Gain (no per-lot attribution — the engine cannot prove the wash lots are excluded); and the §1091 REPLACEMENT side (basis increase + holding-period tack — lotId/replacementForLotId still decline; the preparer owns the replacement-lot basis adjustment, and a same-year unadjusted replacement sale may OVER-state that lot's gain — over-tax-safe, flagged for reconciliation). The add-back is non-negative by type: it can only increase gain / reduce loss (no loss creation, by construction). ATOMICITY: when washSaleDisallowed exceeds this entry's own net (proceeds minus basis) — a shape only legitimate for a per-box aggregate combining a fully-washed loss lot with a separate gain lot — a granularity:\"lot\" entry additionally requires an EXPLICIT washLotIsSingleAcquisitionBlockAffirmed or washLotIsCombinedMultiBlockAffirmed (never inferred from granularity alone); an OMITTED granularity with that shape now DECLINES rather than defaulting to box-style compute — silence never computes an internally-impossible-looking disallowance.","noncovered_basis":"Noncovered lots (basis not reported to the IRS, covered=false, box B/E) are not computed — they decline. A broker Stock-Plan-Supplement adjusted basis is broker-attested, not IRS-reported, and is likewise not modeled.","digital_asset_broad":"Broad digital asset / crypto coverage is not modeled. Only a TY2026+ covered, IRS-reported-basis, purchase-acquired, non-collectible, capital (not ordinary) crypto disposition computes; every other crypto case (pre-2026, Form 1099-DA proceeds-only, noncovered, staking/mining/airdrop income, §408(m) collectible, dealer/ordinary) declines (digital_asset_needs_review).","equity_comp":"Equity compensation: a COVERED (A/D) RSU, NSO, ESPP, or ISO (disqualifying disposition only) LOT — granularity:\"lot\" is REQUIRED (a granularity:\"box\" aggregate, the default, ALWAYS declines: a box can aggregate many lots with different dates) — COMPUTES a comp-adjusted-basis gain when the preparer supplies equityCompOrdinaryIncome (the ordinary income taxed at vest/exercise/disposition — normally on the W-2 box 1 / 1099-NEC, but FREQUENTLY NOT for a QUALIFYING §423 ESPP disposition, where §423(c)'s lesser-of figure is often not employer-reported; confirm against Form 3922), affirms it (equityCompBasisIsCompAdjustedAffirmed), AND supplies acquiredDate + soldDate (exact ISO yyyy-mm-dd, soldDate strictly after acquiredDate, soldDate in the SAME calendar year as the return's tax year) + a sourceDocumentRef (lot provenance) + an ordinaryIncomeSourceRef (comp substantiation) — basis = reportedBasis + that amount (preparer-attested, not IRS-reported; a loud VERIFY flag fires), and the comp-adjusted basis must NOT create a loss. An ISO lot ALSO requires equityCompIsoDisqualifyingDispositionAffirmed:true AND acquiredDate/soldDate in the SAME calendar year (fail-closed — a same-affirmed lot with cross-year dates still declines, since only a same-year exercise-and-sale is PROVABLY disqualifying under §422(a)(1) regardless of grant date) — ESPP computes for EITHER a qualifying or disqualifying §423 disposition with NO exercise-year/sale-year same-year constraint (the soldDate-in-tax-year rule above still applies to every equity-comp lot including ESPP; only the ISO-specific acquiredDate/soldDate-same-year requirement is absent — the caller-attested equityCompOrdinaryIncome covers whichever qualifying/disqualifying figure applies; the engine does not derive the §423 'lesser-of' itself), and ESPP triggers no AMT preference either way. NOT modeled (still decline, equity_comp_basis_adjustment_needs_review): (1) a QUALIFYING ISO disposition (no ordinary income for regular tax, but the AMT-side basis can differ from the regular-tax basis — a Form 6251 §56(b)(3) exercise-year-preference adjustment the engine does not model); (2) a CROSS-YEAR ISO exercise/sale — the engine cannot determine from dates alone whether this is qualifying or disqualifying (grant date is unknown to it; \"cross-year\" is not itself a disqualifying signal, only the complement of the one window the engine can prove) — either classification declines: qualifying has no ordinary income but the unmodeled §56(b)(3) basis divergence; a DISQUALIFYING cross-year disposition DOES carry real §421(b) ordinary income, but requires tracking the exercise-year Form 6251 line-2k AMT preference and its disposition-year reversal, prior-year AMT facts this engine does not carry; ISO exercise-and-hold (no disposition — this lot shape has no path to express it, `proceeds` is required); and any lot missing the affirmation, equityCompOrdinaryIncome, dates, sourceDocumentRef, or ordinaryIncomeSourceRef, on the wrong granularity, on a noncovered box, or whose comp adjustment would create/increase a loss, declines. No caller-free derivation of the §422(c)(2) cap or §423 'lesser-of' figure, and no broad equity-comp completeness, filing, live, deploy, or real-data support is implied.","dependent_filer":"canBeClaimedAsDependent is required on every federal and state request (missing fails validation). true applies the limited federal standard deduction; CA, NY and IL decline it (dependent_filer_needs_review; on a joint return, true if either spouse can be claimed); NC and MI compute a single or MFS dependent filer who claims no dependents. The kiddie tax (§1(g), Form 8615) is not computed: the kiddie-tax decline fires only when that flag is true and the sum of every income line other than wages and Schedule C (losses as $0) and Schedule C net of half SE tax exceeds twice the floor. A child it applies to who is not a dependent (e.g. one whose investment income provides over half their support) computes at the child's own rates (an under-tax).","aged_blind_and_obbba_deductions":"The §63(f) 65+/blind add-on applies only when filerAge65OrOlder, filerBlind, spouseAge65OrOlder or spouseBlind is true; absent is read as false, and MFS spouse boxes are not applied. The 2025-2028 senior deduction is taken only with seniorDeductionEligibilityAffirmed, never on MFS and not for a dependent filer; the tips, overtime and car-loan deductions are not computed. 2025+ responses flag what is not taken. All over-tax.","qualifying_surviving_spouse":"There is no qualifying-surviving-spouse status. Sent as married_filing_jointly, a QSS return is under-taxed through the joint thresholds (the senior deduction's $150,000 phase-out start, the §86 base, Additional Medicare) and must not use the spouse fields.","mfs_spouse_itemizes":"Federal MFS returns must send spouseItemizesDeductions (yes zeroes the standard deduction, §63(c)(6)(A); unknown declines). CA and NY MFS returns do not ask and apply their standard deduction even when the other spouse itemizes: an under-tax.","ca_ny_federal_agi_rounding":"CA and NY start from federal AGI, which can differ from another rounding of the same return by the amounts cents_rounding names, and the difference can change the CA, NY or NYC result, including across a Tax Table band or an exemption-credit, Empire State Child Credit or recapture step. The return declines within $100 of the AGI limit of a claimed CA military-retirement exclusion, a NY tax computation worksheet boundary or $25,000,000 of NY AGI, where the tax can jump; a larger difference can still cross one undetected. The NY high-income itemized flag names its tier from that AGI.","pass_through_k1":"Pass-through income from partnership and S corporation K-1s is not modeled, nor any Schedule K-1 (Form 1041) box other than 1, 2a, 2b, 3 and 4a (k1s); those decline. Business/SSTB/wage-limited §199A QBI (Form 8995-A) is out of scope.","part_year_nonresident":"Part-year and nonresident state returns are not modeled — CA/NY are full-year-resident 2025 only, IL 2020-2026, NC 2020-2026, MI 2020-2026; a part-year or nonresident state return declines (nonresident_or_part_year)."},"commercial_and_retry_semantics":{"computed_200_billable":true,"deterministic_decline_200_billable":true,"validation_4xx_billable":false,"server_5xx_billable":false,"idempotency_key_bills_once":true,"retry_safe":"false for a deterministic decline (it is a successful, final answer — re-sending the same inputs re-declines); true only for a transient server failure (5xx / metering).","next_action":"one of fix_request_and_resubmit (4xx validation / 5xx compute_error), review_inputs (deterministic decline / needs_review), check_credentials (401 auth), upgrade_plan_or_wait_next_period (429 hard cap), retry_after_backoff (transient 5xx / rate limit / metering), retry_after_inflight_completes (idempotency in-progress), use_new_idempotency_key (idempotency-key reused with a changed body), or none (successful compute).","idempotency_terms":["Idempotency-Key","idempotency_key_reused","idempotency_key_in_progress"],"rate_limit":"Monthly quota is a hard_429_cap (no overage billing); a 429 rate limit / monthly limit response directs the caller to upgrade_plan_or_wait_next_period. A 429 is NOT billable.","per_scenario_workflows":"/what-if and /review-packet fan ONE request into up to 25 independent federal computes and bill PER SCENARIO — each computed-or-deterministic-decline slot is one billable unit (like a standalone federal compute); per-slot validation/compute errors and quota-cut slots are NOT billed. Idempotency-Key is MANDATORY on these two (absent → 400, unlike the single-compute endpoints where it is optional); the per-minute rate limit counts N (not 1). A same-body replay bills zero extra; a changed scenario-set under the same key → 409 idempotency_key_reused. These are federal-only and present-not-conclude: /what-if returns N INDEPENDENT results with NO comparison/ranking; /review-packet assembles N items with NO cross-scenario total/summary/aggregate."},"legal_notice":{"ref":"https://tax-mcp.com/terms#compute-notice","version":"v1","present_on":"every computed:true compute 200 and every reconcile/workflow 200 (any status: match/mismatch/unsupported/needs_review)","absent_from":"compute 200 declines (computed:false) and all non-200 responses","note":"/terms governs ALL responses including declines and errors; legal_notice is a per-success echo of /terms, and its absence never means the Terms do not apply."},"decline_binding":{"response_uniform_fields":["computed","code","reason","billed","retry_safe","next_action"],"no_tax_value_leak":true,"forbidden_decline_tax_fields":["taxableIncome","stateTaxableIncome","incomeTax","totalTax","owedOrRefund","lines","additionalTaxes"],"semantics":["deterministic decline","successful answer","not retry"]}}