Compute state tax
One endpoint computes California, New York, Illinois, North Carolina and Michigan, running the federal return underneath (the state starts from federal AGI), and answers $0 or declines for nine states without an income tax.
Which returns
- California Form 540, tax year 2025:
"state": "ca". - New York IT-201, tax year 2025, with New York City resident tax for a full-year NYC resident:
"state": "ny". - Illinois IL-1040, tax years 2020–2026:
"state": "il". - North Carolina D-400, tax years 2020–2026:
"state": "nc". - Michigan MI-1040, tax years 2020–2026:
"state": "mi". - Full-year residents only.
residencydefaults to"full_year_resident", so for anyone who was not a resident all year you must send it (for example"part_year_resident"or"nonresident"); the return then declines instead of being computed as a full-year resident's. canBeClaimedAsDependentandnoForeignOrTerritoryExclusionAffirmedare required. A filer someone else can claim as a dependent declines in CA, NY and IL (dependent_filer_needs_review), whose dependent-filer rules are not modeled. On a joint return, sendtrueif either spouse can be claimed. North Carolina and Michigan compute a single or married-filing-separately dependent filer who claims no dependents (North Carolina with its full standard deduction, Michigan with $1,500in place of exemptions); a no-income-tax state's $0 answer does not change.
California
Send the W-2 facts, including box 5 in medicareWages because the federal return is computed too, plus California withholding (W-2 box 17) in caWithholding:
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "ca",
"year": 2025,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 80000,
"medicareWages": 80000,
"caWithholding": 5000
}'{
"computed": true,
"state": "ca",
"year": 2025,
"filingStatus": "single",
"stateAGI": 80000,
"stateDeductions": 5706,
"stateTaxableIncome": 74294,
"incomeTaxBeforeCredits": 3349,
"exemptionCredits": 153,
"incomeTax": 3196,
"additionalTaxes": [],
"totalTax": 3196,
"lines": [
{ "lineId": "540:13", "label": "Federal AGI", "amount": 80000, "agiRole": "agi_base" },
{
"lineId": "540:17",
"label": "CA adjusted gross income",
"amount": 80000,
"agiRole": "agi_total"
},
{
"lineId": "540:18",
"label": "CA standard deduction",
"amount": 5706,
"agiRole": "below_agi",
"cite": "<primary-source cite — see full response>"
},
{
"lineId": "540:19",
"label": "CA taxable income",
"amount": 74294,
"agiRole": "below_agi"
},
{
"lineId": "540:31",
"label": "CA tax (2025 California Tax Table)",
"amount": 3349,
"agiRole": "below_agi",
"cite": "<primary-source cite — see full response>"
},
{
"lineId": "540:32",
"label": "CA exemption credits",
"amount": 153,
"agiRole": "below_agi",
"cite": "<primary-source cite — see full response>"
},
{
"lineId": "540:33",
"label": "CA tax after exemption credits",
"amount": 3196,
"agiRole": "below_agi"
},
{ "lineId": "540:64", "label": "Total CA tax", "amount": 3196, "agiRole": "below_agi" }
],
"flags": [
"CA-AGI-assumed-equal-to-federal-AGI (wages-only; no Schedule CA 540 adjustments). A filer with CA-specific adjustments (HSA add-back, US-Treasury/out-of-state-muni interest, SS exclusion) needs Schedule CA 540.",
"CA-AMT-not-computed (Schedule P, R&TC §17062). A full-year resident with no AMT preference items owes regular CA tax; a filer with preference items (ISO, accelerated depreciation, etc.) must complete Schedule P.",
"CA-exemption-credits-computed-with personal/blind/senior=1 ($153 each), dependents=0 ($475 each); blind/senior/dependents default to 0 when not supplied — supply them if applicable.",
"CA payments = withholding $5,000 + estimated $0 + extension $0 + prior-year-overpayment-applied $0 = $5,000. These coexist, but must NOT double-count — caEstimatedPayments must NOT also include the prior-year overpayment (that double-counts and over-states the refund)."
],
"totalPayments": 5000,
"balanceDue": 0,
"overpayment": 1804,
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "ca", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"state": "ca",
"year": 2025,
"filingStatus": "single",
"stateAGI": 80000,
"stateDeductions": 5706,
"stateTaxableIncome": 74294,
"incomeTaxBeforeCredits": 3349,
"exemptionCredits": 153,
"incomeTax": 3196,
"additionalTaxes": [],
"totalTax": 3196,
"lines": [
{ "lineId": "540:13", "label": "Federal AGI", "amount": 80000, "agiRole": "agi_base" },
{
"lineId": "540:17",
"label": "CA adjusted gross income",
"amount": 80000,
"agiRole": "agi_total"
},
{
"lineId": "540:18",
"label": "CA standard deduction",
"amount": 5706,
"agiRole": "below_agi",
"cite": {
"jurisdiction": "ca",
"cellKey": "std_deduction.2025.single",
"authority": "CA FTB 2025 Standard Deduction — R&TC §17073.5 (CPI-indexed)"
}
},
{
"lineId": "540:19",
"label": "CA taxable income",
"amount": 74294,
"agiRole": "below_agi"
},
{
"lineId": "540:31",
"label": "CA tax (2025 California Tax Table)",
"amount": 3349,
"agiRole": "below_agi",
"cite": {
"jurisdiction": "ca",
"cellKey": "brackets.2025.single",
"authority": "CA FTB 2025 Form 540 booklet 2025 California Tax Table (rate schedule at band midpoint; required when taxable income ≤ $100,000)"
}
},
{
"lineId": "540:32",
"label": "CA exemption credits",
"amount": 153,
"agiRole": "below_agi",
"cite": {
"jurisdiction": "ca",
"cellKey": "exemption_credit.2025.personal",
"authority": "CA FTB 2025 Form 540 lines 7–10 Exemption Credits — R&TC §17054 ($153 personal/blind/senior, $475 dependent)"
}
},
{
"lineId": "540:33",
"label": "CA tax after exemption credits",
"amount": 3196,
"agiRole": "below_agi"
},
{ "lineId": "540:64", "label": "Total CA tax", "amount": 3196, "agiRole": "below_agi" }
],
"flags": [
"CA-AGI-assumed-equal-to-federal-AGI (wages-only; no Schedule CA 540 adjustments). A filer with CA-specific adjustments (HSA add-back, US-Treasury/out-of-state-muni interest, SS exclusion) needs Schedule CA 540.",
"CA-AMT-not-computed (Schedule P, R&TC §17062). A full-year resident with no AMT preference items owes regular CA tax; a filer with preference items (ISO, accelerated depreciation, etc.) must complete Schedule P.",
"CA-exemption-credits-computed-with personal/blind/senior=1 ($153 each), dependents=0 ($475 each); blind/senior/dependents default to 0 when not supplied — supply them if applicable.",
"CA payments = withholding $5,000 + estimated $0 + extension $0 + prior-year-overpayment-applied $0 = $5,000. These coexist, but must NOT double-count — caEstimatedPayments must NOT also include the prior-year overpayment (that double-counts and over-states the refund)."
],
"totalPayments": 5000,
"balanceDue": 0,
"overpayment": 1804,
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "ca", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}California AGI is $80,000 and total CA tax is $3,196. State lines carry a cite to the FTB source of each constant. A return claiming the military-retirement exclusion declines with ca_military_retirement_agi_near_limit when federal AGI is within $100of the exclusion's AGI limit, where the return rounded another way can fall on the other side.
New York and New York City
New York needs nyWageAdditions, the New York additions to wages that the engine cannot infer from a W-2. Send 0 when there are none; leaving it out declines. Add nycResident: true for the NYC resident tax:
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "ny",
"year": 2025,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 80000,
"medicareWages": 80000,
"nyWageAdditions": 0,
"nycResident": true
}'{
"computed": true,
"state": "ny",
"year": 2025,
"filingStatus": "single",
"stateAGI": 80000,
"stateDeductions": 8000,
"stateTaxableIncome": 72000,
"stateTax": 3796,
"nycResidentTax": 2666,
"totalTax": 6462,
"lines": [
{
"lineId": "IT-201:19",
"label": "Federal AGI (NY rolling-conformity starting base)",
"amount": 80000,
"agiRole": "agi_base"
},
{
"lineId": "IT-201:33",
"label": "NY adjusted gross income (federal AGI + NY wage add-backs − NY subtractions)",
"amount": 80000,
"agiRole": "agi_total"
},
{
"lineId": "IT-201:34",
"label": "NY standard deduction",
"amount": 8000,
"agiRole": "below_agi",
"cite": "<primary-source cite — see full response>"
},
{
"lineId": "IT-201:36",
"label": "NY dependent exemptions (0 × $1,000)",
"amount": 0,
"agiRole": "below_agi"
},
{
"lineId": "IT-201:38",
"label": "NY taxable income",
"amount": 72000,
"agiRole": "below_agi"
},
{
"lineId": "IT-201:39",
"label": "NY State tax (rate schedule)",
"amount": 3796,
"agiRole": "below_agi",
"cite": "<primary-source cite — see full response>"
},
{
"lineId": "IT-201:47a",
"label": "NYC resident tax (rate schedule)",
"amount": 2666,
"agiRole": "below_agi",
"cite": "<primary-source cite — see full response>"
},
{
"lineId": "IT-201:46+58",
"label": "Total NY + NYC tax",
"amount": 6462,
"agiRole": "below_agi"
}
],
"flags": [
"NY-AGI assumes the supplied nyWageAdditions=$0 captures ALL NY wage add-backs (414(h) + IRC-125, W-2 box 14). A NY public-sector employee must include box-14 amounts here.",
"NY conformity assumed equal to federal AGI for income (wages-only; no NY subtractions modeled — pension/IRA exclusion, US-Treasury interest, 529, etc. require detail not present and would need their own decline-gate).",
"NY-AMT / NYC-UBT and other special regimes not computed (out of scope for this resident return)."
],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "ny", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"state": "ny",
"year": 2025,
"filingStatus": "single",
"stateAGI": 80000,
"stateDeductions": 8000,
"stateTaxableIncome": 72000,
"stateTax": 3796,
"nycResidentTax": 2666,
"totalTax": 6462,
"lines": [
{
"lineId": "IT-201:19",
"label": "Federal AGI (NY rolling-conformity starting base)",
"amount": 80000,
"agiRole": "agi_base"
},
{
"lineId": "IT-201:33",
"label": "NY adjusted gross income (federal AGI + NY wage add-backs − NY subtractions)",
"amount": 80000,
"agiRole": "agi_total"
},
{
"lineId": "IT-201:34",
"label": "NY standard deduction",
"amount": 8000,
"agiRole": "below_agi",
"cite": {
"jurisdiction": "ny",
"cellKey": "std_deduction.2025.single",
"authority": "NY DTF 2025 IT-201-I standard deduction (non-dependent filer) — Tax Law §614"
}
},
{
"lineId": "IT-201:36",
"label": "NY dependent exemptions (0 × $1,000)",
"amount": 0,
"agiRole": "below_agi"
},
{
"lineId": "IT-201:38",
"label": "NY taxable income",
"amount": 72000,
"agiRole": "below_agi"
},
{
"lineId": "IT-201:39",
"label": "NY State tax (rate schedule)",
"amount": 3796,
"agiRole": "below_agi",
"cite": {
"jurisdiction": "ny",
"cellKey": "brackets.2025.single",
"authority": "NY DTF 2025 IT-201-I New York State tax rate schedule — Tax Law §601"
}
},
{
"lineId": "IT-201:47a",
"label": "NYC resident tax (rate schedule)",
"amount": 2666,
"agiRole": "below_agi",
"cite": {
"jurisdiction": "nyc",
"cellKey": "brackets.2025.single",
"authority": "NY DTF 2025 IT-201-I New York City resident tax rate schedule — NYC Admin. Code §11-1701"
}
},
{
"lineId": "IT-201:46+58",
"label": "Total NY + NYC tax",
"amount": 6462,
"agiRole": "below_agi"
}
],
"flags": [
"NY-AGI assumes the supplied nyWageAdditions=$0 captures ALL NY wage add-backs (414(h) + IRC-125, W-2 box 14). A NY public-sector employee must include box-14 amounts here.",
"NY conformity assumed equal to federal AGI for income (wages-only; no NY subtractions modeled — pension/IRA exclusion, US-Treasury interest, 529, etc. require detail not present and would need their own decline-gate).",
"NY-AMT / NYC-UBT and other special regimes not computed (out of scope for this resident return)."
],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "ny", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}Total tax, including the New York City resident tax, is $6,462. Above $107,650 of New York AGI, a return declines with ny_recapture_worksheet_boundary when taxable income is within $100 of a tax computation worksheet boundary, or New York AGI is within $100 of $25,000,000, because the tax jumps there.
Interest, dividends, and gains
Send interest and dividends exactly as for the federal return underneath (for example, taxableInterest is Form 1040 line 2b, as figured on Schedule B line 4; see interest & dividends). Non-wage income is taxed at ordinary rates. California and New York tax it only when you also send stateIncomeConformsToFederal: true, an affirmation that the state amounts equal the federal ones; Illinois, North Carolina and Michigan reject that field and tax it through federal AGI. The state referencelists every state field, including itemized deductions, pension and Social Security handling, and California's subtractions.
States with no income tax
For a full-year resident of Alaska, Florida, Nevada, South Dakota, Texas, Wyoming, Tennessee, New Hampshire or Washington, tax years 2020-2026, the answer is $0 state income tax, or a decline. Three of these states taxed part of an individual's income in some of those years, so every return in those years needs an attestation that it is not owed (false or missing declines with state_income_tax_may_apply):
- New Hampshire 2020-2024, Interest & Dividends tax:
nhInterestDividendsTaxNotOwedAffirmed. - Tennessee 2020, Hall income tax:
tnHallTaxNotOwedAffirmed. - Washington 2022-2026, capital gains excise:
waCapitalGainsExciseNotOwedAffirmed.
The response lists in notEvaluatedwhat it does not cover (business and payroll taxes such as New Hampshire's Business Profits Tax or Washington's B&O tax, and other states' returns), and filingRequirementEvaluated: false: a state return can be required even when no tax is owed.
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "tx",
"year": 2025,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 80000,
"medicareWages": 80000
}'{
"computed": true,
"state": "tx",
"year": 2025,
"filingStatus": "single",
"incomeTax": 0,
"additionalTaxes": [],
"totalTax": 0,
"filingRequirementEvaluated": false,
"attestationsRelied": [],
"notEvaluated": [
"TX franchise tax",
"state business and payroll taxes",
"the state filing requirement",
"other states' nonresident or part-year returns"
],
"lines": [],
"flags": ["no-state-individual-income-tax-TX-2025"],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "tx", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"state": "tx",
"year": 2025,
"filingStatus": "single",
"incomeTax": 0,
"additionalTaxes": [],
"totalTax": 0,
"filingRequirementEvaluated": false,
"attestationsRelied": [],
"notEvaluated": [
"TX franchise tax",
"state business and payroll taxes",
"the state filing requirement",
"other states' nonresident or part-year returns"
],
"lines": [],
"flags": ["no-state-individual-income-tax-TX-2025"],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "tx", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}Illinois
Full-year Illinois residents, tax years 2020–2026: federal AGI plus federally tax-exempt interest and dividends (taxExemptInterest, required, 0 if none), less taxable Social Security and, with ilPensionIsQualifiedRetirementIncomeAffirmed, the pension; less the exemption allowance (none above $250,000 of federal AGI, $500,000 joint); taxed at 4.95%. Every return needs ilNoAdditionsOrRecaptureAffirmed and ilFilingStatusMatchesFederalAffirmed; without them it declines with il_needs_review. So does a return whose federal AGI is within $100 of the exemption cliff, where the return rounded another way can fall on the other side. Credits and other subtractions are left out (over-tax), and household employment tax, use tax and surcharges (lines 20-22) are not added (under-tax when owed); all are listed in notEvaluated.
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "il",
"year": 2025,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 60000,
"medicareWages": 60000,
"taxExemptInterest": 0,
"ilNoAdditionsOrRecaptureAffirmed": true,
"ilFilingStatusMatchesFederalAffirmed": true
}'{
"computed": true,
"state": "il",
"year": 2025,
"filingStatus": "single",
"federalAGI": 60000,
"baseIncome": 60000,
"exemption": 2850,
"netIncome": 57150,
"incomeTax": 2829,
"additionalTaxes": [],
"totalTax": 2829,
"notEvaluated": [
"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"
],
"attestationsRelied": [
"ilNoAdditionsOrRecaptureAffirmed",
"ilFilingStatusMatchesFederalAffirmed"
],
"lines": [
{ "lineId": "IL-1040:1", "label": "Federal adjusted gross income", "amount": 60000 },
{
"lineId": "IL-1040:2",
"label": "Federally tax-exempt interest and dividend income",
"amount": 0
},
{
"lineId": "IL-1040:5",
"label": "Social Security and qualified retirement income subtraction",
"amount": 0
},
{ "lineId": "IL-1040:9", "label": "Illinois base income", "amount": 60000 },
{ "lineId": "IL-1040:10", "label": "Exemption allowance", "amount": 2850 },
{ "lineId": "IL-1040:11", "label": "Net income", "amount": 57150 },
{ "lineId": "IL-1040:12", "label": "Income tax (4.95%)", "amount": 2829 }
],
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "il", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"state": "il",
"year": 2025,
"filingStatus": "single",
"federalAGI": 60000,
"baseIncome": 60000,
"exemption": 2850,
"netIncome": 57150,
"incomeTax": 2829,
"additionalTaxes": [],
"totalTax": 2829,
"notEvaluated": [
"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"
],
"attestationsRelied": [
"ilNoAdditionsOrRecaptureAffirmed",
"ilFilingStatusMatchesFederalAffirmed"
],
"lines": [
{ "lineId": "IL-1040:1", "label": "Federal adjusted gross income", "amount": 60000 },
{
"lineId": "IL-1040:2",
"label": "Federally tax-exempt interest and dividend income",
"amount": 0
},
{
"lineId": "IL-1040:5",
"label": "Social Security and qualified retirement income subtraction",
"amount": 0
},
{ "lineId": "IL-1040:9", "label": "Illinois base income", "amount": 60000 },
{ "lineId": "IL-1040:10", "label": "Exemption allowance", "amount": 2850 },
{ "lineId": "IL-1040:11", "label": "Net income", "amount": 57150 },
{ "lineId": "IL-1040:12", "label": "Income tax (4.95%)", "amount": 2829 }
],
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "il", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}North Carolina
Full-year North Carolina residents, tax years 2020–2026: federal AGI plus all of taxExemptInterest(required, 0 if none; interest on North Carolina's own obligations is added too, an over-tax), less taxable Social Security, the child deduction for ncChildrenAllowedFederalCtc children and the standard deduction ($12,750 single from 2022), taxed at the year's rate (4.25% for 2025, 3.99% for 2026). Every return needs ncNoAdditionsAffirmed, ncFilingStatusMatchesFederalAffirmed and ncStandardDeductionAllowedAffirmed; without them it declines with nc_needs_review. So does a return with children whose federal AGI is within $100 of a child-deduction band edge, and a dependent filer reporting children declines with dependent_filer_needs_review. Itemizing, other Schedule S deductions and credits are left out (over-tax), and consumer use tax is not added (under-tax when owed); all are listed in notEvaluated.
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "nc",
"year": 2025,
"filingStatus": "married_filing_jointly",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 70000,
"medicareWages": 70000,
"taxExemptInterest": 0,
"ncChildrenAllowedFederalCtc": 2,
"ncNoAdditionsAffirmed": true,
"ncFilingStatusMatchesFederalAffirmed": true,
"ncStandardDeductionAllowedAffirmed": true
}'{
"computed": true,
"state": "nc",
"year": 2025,
"filingStatus": "married_filing_jointly",
"federalAGI": 70000,
"taxableIncome": 40500,
"incomeTax": 1721,
"additionalTaxes": [],
"totalTax": 1721,
"notEvaluated": [
"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"
],
"attestationsRelied": [
"ncNoAdditionsAffirmed",
"ncFilingStatusMatchesFederalAffirmed",
"ncStandardDeductionAllowedAffirmed"
],
"lines": [
{ "lineId": "D-400:6", "label": "Federal adjusted gross income", "amount": 70000 },
{
"lineId": "D-400:7",
"label": "Additions (interest on other states' obligations)",
"amount": 0
},
{ "lineId": "D-400:8", "label": "Line 6 plus line 7", "amount": 70000 },
{ "lineId": "D-400:9", "label": "Deductions (taxable Social Security)", "amount": 0 },
{ "lineId": "D-400:10b", "label": "Child deduction", "amount": 4000 },
{ "lineId": "D-400:11", "label": "North Carolina standard deduction", "amount": 25500 },
{ "lineId": "D-400:12a", "label": "Total of lines 9, 10b and 11", "amount": 29500 },
{ "lineId": "D-400:14", "label": "North Carolina taxable income", "amount": 40500 },
{ "lineId": "D-400:15", "label": "North Carolina income tax (4.25%)", "amount": 1721 }
],
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "nc", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"state": "nc",
"year": 2025,
"filingStatus": "married_filing_jointly",
"federalAGI": 70000,
"taxableIncome": 40500,
"incomeTax": 1721,
"additionalTaxes": [],
"totalTax": 1721,
"notEvaluated": [
"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"
],
"attestationsRelied": [
"ncNoAdditionsAffirmed",
"ncFilingStatusMatchesFederalAffirmed",
"ncStandardDeductionAllowedAffirmed"
],
"lines": [
{ "lineId": "D-400:6", "label": "Federal adjusted gross income", "amount": 70000 },
{
"lineId": "D-400:7",
"label": "Additions (interest on other states' obligations)",
"amount": 0
},
{ "lineId": "D-400:8", "label": "Line 6 plus line 7", "amount": 70000 },
{ "lineId": "D-400:9", "label": "Deductions (taxable Social Security)", "amount": 0 },
{ "lineId": "D-400:10b", "label": "Child deduction", "amount": 4000 },
{ "lineId": "D-400:11", "label": "North Carolina standard deduction", "amount": 25500 },
{ "lineId": "D-400:12a", "label": "Total of lines 9, 10b and 11", "amount": 29500 },
{ "lineId": "D-400:14", "label": "North Carolina taxable income", "amount": 40500 },
{ "lineId": "D-400:15", "label": "North Carolina income tax (4.25%)", "amount": 1721 }
],
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "nc", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}Michigan
Full-year Michigan residents, tax years 2020–2026: federal AGI plus all of taxExemptInterest(required, 0 if none; interest on Michigan's own obligations is added too, an over-tax), less taxable Social Security and the exemption allowance ($5,800 each for 2025, for you, your spouse on a joint return and miDependentsClaimed), taxed at 4.25% (4.05% for 2023). A federal head-of-household return files as single. Every return needs miNoAdditionsAffirmed, miFilingStatusMatchesAffirmed and either miNoRetirementOrAgeDeductionsAffirmed or miRetirementFactsAffirmed, plus miCapitalGainsSameForMichiganAffirmed whenever a capital gain or loss input is sent; without them it declines with mi_needs_review. With miRetirementFactsAffirmed and the birth years (miFilerBirthYear, and miSpouseBirthYear on a joint return), the Tier 2 or Tier 3 Michigan standard deduction or the 2023-2025 Form 4884 Section D phase-in (miQualifyingRetirementBenefits) is subtracted for a key person born 1946 or later, 2020-2025. Any other retirement or age-based deduction is not modeled. Other subtractions and credits are left out (over-tax), use tax is not added (under-tax when owed), and city income tax is a separate return; all are listed in notEvaluated.
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "mi",
"year": 2025,
"filingStatus": "married_filing_jointly",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 90000,
"medicareWages": 90000,
"taxExemptInterest": 0,
"miDependentsClaimed": 2,
"miNoAdditionsAffirmed": true,
"miFilingStatusMatchesAffirmed": true,
"miNoRetirementOrAgeDeductionsAffirmed": true
}'{
"computed": true,
"state": "mi",
"year": 2025,
"filingStatus": "married_filing_jointly",
"federalAGI": 90000,
"taxableIncome": 66800,
"incomeTax": 2839,
"additionalTaxes": [],
"totalTax": 2839,
"notEvaluated": [
"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)"
],
"attestationsRelied": [
"miNoAdditionsAffirmed",
"miFilingStatusMatchesAffirmed",
"miNoRetirementOrAgeDeductionsAffirmed"
],
"lines": [
{ "lineId": "MI-1040:10", "label": "Federal adjusted gross income", "amount": 90000 },
{
"lineId": "MI-1040:11",
"label": "Additions (interest on other states' obligations)",
"amount": 0
},
{ "lineId": "MI-1040:12", "label": "Line 10 plus line 11", "amount": 90000 },
{ "lineId": "MI-SCH1:14", "label": "Schedule 1: taxable Social Security", "amount": 0 },
{ "lineId": "MI-1040:13", "label": "Subtractions from Schedule 1", "amount": 0 },
{ "lineId": "MI-1040:14", "label": "Income subject to tax", "amount": 90000 },
{ "lineId": "MI-1040:15", "label": "Exemption allowance", "amount": 23200 },
{ "lineId": "MI-1040:16", "label": "Taxable income", "amount": 66800 },
{ "lineId": "MI-1040:17", "label": "Tax (4.25%)", "amount": 2839 }
],
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "mi", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
}
}Full response, including line derivations
{
"computed": true,
"state": "mi",
"year": 2025,
"filingStatus": "married_filing_jointly",
"federalAGI": 90000,
"taxableIncome": 66800,
"incomeTax": 2839,
"additionalTaxes": [],
"totalTax": 2839,
"notEvaluated": [
"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)"
],
"attestationsRelied": [
"miNoAdditionsAffirmed",
"miFilingStatusMatchesAffirmed",
"miNoRetirementOrAgeDeductionsAffirmed"
],
"lines": [
{ "lineId": "MI-1040:10", "label": "Federal adjusted gross income", "amount": 90000 },
{
"lineId": "MI-1040:11",
"label": "Additions (interest on other states' obligations)",
"amount": 0
},
{ "lineId": "MI-1040:12", "label": "Line 10 plus line 11", "amount": 90000 },
{ "lineId": "MI-SCH1:14", "label": "Schedule 1: taxable Social Security", "amount": 0 },
{ "lineId": "MI-1040:13", "label": "Subtractions from Schedule 1", "amount": 0 },
{ "lineId": "MI-1040:14", "label": "Income subject to tax", "amount": 90000 },
{ "lineId": "MI-1040:15", "label": "Exemption allowance", "amount": 23200 },
{ "lineId": "MI-1040:16", "label": "Taxable income", "amount": 66800 },
{ "lineId": "MI-1040:17", "label": "Tax (4.25%)", "amount": 2839 }
],
"flags": [],
"billed": true,
"retry_safe": true,
"next_action": "none",
"provenance": { "engine": "deterministic", "jurisdiction": "mi", "tax_year": 2025 },
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "Computation support only. Not tax, legal, accounting, or financial advice. Customer is responsible for review, filing positions, and use only within the documented supported envelope."
}
}Other states
curl https://tax-mcp.com/api/mcp/tax-compute/state \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"state": "pa",
"year": 2025,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 80000,
"medicareWages": 80000
}'{
"error": "unsupported or missing state",
"supportedStates": [
"ca",
"ny",
"ak",
"fl",
"nv",
"sd",
"tx",
"wy",
"tn",
"nh",
"wa",
"il",
"nc",
"mi"
],
"billed": false,
"retry_safe": false,
"next_action": "fix_request_and_resubmit",
"reason": "unsupported_state"
}When the federal return declines
If the federal return underneath cannot be computed, the state response is a decline with code federal_declined, and its reason carries the federal explanation. Fix the federal facts first.
See also: /tax-compute/state.
Roadmap status for this page
Generated from the roadmap (updated 2026-10-30). Shipped & certified means live and independently checked against primary tax sources; certifying means live, with those checks still in progress. 2 related items are planned and not available yet; see the roadmap.
| Capability | Status |
|---|---|
| CA 540 2025 — full compute (rate schedule, BHST, exemption phase-out)Computes 2025 CA Form 540: rate schedule, BHST, and exemption phase-out. Has known gaps.Known gap: Railroad retirees can pay CA/NY tax on Tier-2 income those states exempt (over-tax, disclosed) | ✅ shipped & certified |
| NY + NYC 2025 — selected pathsComputes NY and NYC 2025 tax on selected paths: wages plus clean conforming non-wage income. Has known gaps.Known gap: Railroad retirees can pay CA/NY tax on Tier-2 income those states exempt (over-tax, disclosed)Known gap: A NY resident who paid Canadian provincial tax is over-taxed today, with no credit path | ✅ shipped & certified |
| States with no income tax: AK, FL, NV, SD, TX, WY, TN, NH, WA ($0 or decline)Answers $0 state income tax, or declines, for a year-round resident of a state with no income tax. Has known gaps.Known gap: Business and payroll taxes and the state filing requirement are not evaluated | ✅ shipped & certified |
| Illinois IL-1040, full-year residents, 2020-2026Computes Illinois income tax for a full-year resident, tax years 2020-2026. Has known gaps.Known gap: Credits and other subtractions aren't modeled (over-tax)Known gap: A married non-joint filer's spouse exemptions aren't taken (over-tax)Known gap: Household employment tax, use tax and surcharges aren't evaluatedKnown gap: Part-year, nonresident and dependent filers decline | ✅ shipped & certified |
| North Carolina D-400, full-year residents, 2020-2026Computes North Carolina income tax for a full-year resident, tax years 2020-2026. Has known gaps.Known gap: Itemizing, other deductions and credits aren't modeled (over-tax)Known gap: Consumer use tax isn't evaluatedKnown gap: Part-year and nonresident filers decline | ✅ shipped & certified |
| Michigan MI-1040, full-year residents, 2020-2026Computes Michigan income tax for a full-year resident, tax years 2020-2026. Has known gaps.Known gap: Retirement deductions beyond the age-67 standard deduction and the 2023-2025 phase-in declineKnown gap: Other subtractions and credits aren't modeled (over-tax)Known gap: A married non-joint filer's spouse exemption isn't taken (over-tax)Known gap: Use tax isn't evaluated; city income tax is a separate return | ✅ shipped & certified |
| Michigan retirement: Tier 2/3 standard deduction and the 2023-2025 phase-inTakes Michigan's age-67 standard deduction or the 2023-2025 retirement phase-in for a retiree born 1946 or later. Has known gaps.Known gap: Born before 1946 (Form 4884 Section A), survivor elections, military and railroad retirement declineKnown gap: 2026 declines until Michigan publishes its formsKnown gap: A January 1 birthday needs its flag, or the deduction can be missed (over-tax) | ✅ shipped & certified |