Guides by outcome

Add interest and dividend income

Add 1099-INT and 1099-DIV income to a federal return. Qualified dividends are taxed at the preferential rates, and investment income is checked for the 3.8% Net Investment Income Tax.

Facts to collect

FromFieldNotes
Schedule B line 4taxableInterestForm 1040 line 2b, as figured on Schedule B line 4. Tax-exempt interest is a separate field, taxExemptInterest.
Schedule B line 6ordinaryDividendsForm 1040 line 3b, as figured on Schedule B line 6.
Form 1040 line 3aqualifiedDividendsForm 1040 line 3a, so never more than ordinaryDividends.
The preparerestateTrustK1NoAmtAdjustmentAffirmedRequired with any of the above. See below.

The affirmation it needs

Investment income can come with an estate or trust Schedule K-1 (Form 1041) that carries an alternative minimum tax adjustment (Form 6251 line 2j). The engine computes only K-1 boxes 1, 2a, 2b, 3 and 4a (sent in k1s), never box 12, so it asks the preparer to attest that none applies. Without that attestation, the return declines:

Request
curl https://tax-mcp.com/api/mcp/tax-compute/federal \
  -H "Authorization: Bearer $TAX_MCP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "year": 2025,
    "filingStatus": "single",
    "canBeClaimedAsDependent": false,
    "noForeignOrTerritoryExclusionAffirmed": true,
    "wages": 90000,
    "medicareWages": 90000,
    "taxableInterest": 1200
  }'
Response 200 · DECLINED · estate_trust_amt_adjustment_unmodeled
{
  "computed": false,
  "code": "estate_trust_amt_adjustment_unmodeled",
  "reason": "this return carries investment income (taxableInterest), which requires estateTrustK1NoAmtAdjustmentAffirmed:true. It attests that no Schedule K-1 (Form 1041) received for this tax year, from any estate or trust, shows a positive amount in box 12 code A (adjustment for minimum tax purposes, Form 6251 line 2j) or any amount, positive or negative, in box 12 codes B through I. Attest true if no such K-1 was received, or if every code A amount is zero or negative and codes B through I are blank on all of them (a negative code A left out over-states the tax). This engine sets Form 6251 line 2j to $0; if a K-1 does carry such an amount, a preparer must complete Form 6251.",
  "billed": true,
  "retry_safe": false,
  "next_action": "review_inputs"
}
Full response, including line derivations
{
  "computed": false,
  "code": "estate_trust_amt_adjustment_unmodeled",
  "reason": "this return carries investment income (taxableInterest), which requires estateTrustK1NoAmtAdjustmentAffirmed:true. It attests that no Schedule K-1 (Form 1041) received for this tax year, from any estate or trust, shows a positive amount in box 12 code A (adjustment for minimum tax purposes, Form 6251 line 2j) or any amount, positive or negative, in box 12 codes B through I. Attest true if no such K-1 was received, or if every code A amount is zero or negative and codes B through I are blank on all of them (a negative code A left out over-states the tax). This engine sets Form 6251 line 2j to $0; if a K-1 does carry such an amount, a preparer must complete Form 6251.",
  "billed": true,
  "retry_safe": false,
  "next_action": "review_inputs"
}

Compute with the affirmation

Set estateTrustK1NoAmtAdjustmentAffirmed: trueonly after someone has confirmed that no estate or trust K-1 for the year shows an AMT adjustment (the field's description in the federal reference states exactly what it attests):

Request
curl https://tax-mcp.com/api/mcp/tax-compute/federal \
  -H "Authorization: Bearer $TAX_MCP_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Idempotency-Key: $(uuidgen)" \
  -d '{
    "year": 2025,
    "filingStatus": "single",
    "canBeClaimedAsDependent": false,
    "noForeignOrTerritoryExclusionAffirmed": true,
    "wages": 90000,
    "medicareWages": 90000,
    "taxableInterest": 1200,
    "ordinaryDividends": 4000,
    "qualifiedDividends": 4000,
    "estateTrustK1NoAmtAdjustmentAffirmed": true
  }'
Response 200 · COMPUTED
{
  "computed": true,
  "year": 2025,
  "filingStatus": "single",
  "taxableIncome": 79450,
  "incomeTax": 12119,
  "totalTax": 12119,
  "lines": [
    { "lineId": "1040:15", "label": "Taxable income", "amount": 79450 },
    {
      "lineId": "1040:16",
      "label": "Income tax",
      "amount": 12119,
      "derivation": "<7 derivation steps — see full response>"
    },
    { "lineId": "1040:24", "label": "Total tax", "amount": 12119 }
  ],
  "flags": [
    "OBBBA-2025-new-deductions-senior-bonus/tips/overtime/car-loan-NOT-evaluated-engine-cannot-verify-eligibility-from-W2/1099-preparer-must-confirm"
  ],
  "billed": true,
  "retry_safe": true,
  "next_action": "none",
  "provenance": { "engine": "deterministic", "jurisdiction": "federal", "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,
  "year": 2025,
  "filingStatus": "single",
  "taxableIncome": 79450,
  "incomeTax": 12119,
  "totalTax": 12119,
  "lines": [
    {
      "lineId": "1040:15",
      "label": "Taxable income",
      "amount": 79450,
      "derivation": []
    },
    {
      "lineId": "1040:16",
      "label": "Income tax",
      "amount": 12119,
      "derivation": [
        {
          "lineId": "1040:16",
          "label": "Tax Table method (IRS-mandated below $100,000 taxable income)",
          "inputs": [
            { "name": "taxableIncome", "value": 75450 }
          ],
          "rule": {
            "description": "Form 1040 instructions require the published Tax Table — a lookup on the midpoint of a narrow taxable-income band — for taxable income under $100,000; the exact bracket formula (Tax Computation Worksheet) applies only at $100,000 or more.",
            "authority": "Form 1040 instructions — Tax Table"
          },
          "computation": "taxable income $75,450 → Tax Table band midpoint $75,475",
          "result": 0
        },
        {
          "lineId": "1040:16",
          "label": "Ordinary income tax — 10% bracket",
          "inputs": [
            { "name": "taxableIncomeInBracket", "value": 11925 }
          ],
          "rule": {
            "description": "marginal rate × taxable income falling within this bracket",
            "authority": "IRC §1(j)",
            "constantRef": {
              "table": "BRACKETS_BY_YEAR",
              "key": "2025/single",
              "value": "10% (up to $11,925)",
              "revProc": "Rev. Proc. 2024-40"
            }
          },
          "computation": "0.1 × $11,925 = $1,192.5",
          "result": 1192.5
        },
        {
          "lineId": "1040:16",
          "label": "Ordinary income tax — 12% bracket",
          "inputs": [
            { "name": "taxableIncomeInBracket", "value": 36550 }
          ],
          "rule": {
            "description": "marginal rate × taxable income falling within this bracket",
            "authority": "IRC §1(j)",
            "constantRef": {
              "table": "BRACKETS_BY_YEAR",
              "key": "2025/single",
              "value": "12% (up to $48,475)",
              "revProc": "Rev. Proc. 2024-40"
            }
          },
          "computation": "0.12 × $36,550 = $4,386",
          "result": 4386
        },
        {
          "lineId": "1040:16",
          "label": "Ordinary income tax — 22% bracket",
          "inputs": [
            { "name": "taxableIncomeInBracket", "value": 27000 }
          ],
          "rule": {
            "description": "marginal rate × taxable income falling within this bracket",
            "authority": "IRC §1(j)",
            "constantRef": {
              "table": "BRACKETS_BY_YEAR",
              "key": "2025/single",
              "value": "22% (up to $103,350)",
              "revProc": "Rev. Proc. 2024-40"
            }
          },
          "computation": "0.22 × $27,000 = $5,940",
          "result": 5940
        },
        {
          "lineId": "1040:16",
          "label": "Whole-dollar rounding — ordinary income tax",
          "inputs": [
            { "name": "unroundedOrdinaryTax", "value": 11519 }
          ],
          "rule": {
            "description": "round the ordinary income tax to whole dollars",
            "authority": "Form 1040 instructions — whole-dollar rounding"
          },
          "computation": "$11,519 − $11,518.5 = $0.5",
          "result": 0.5
        },
        {
          "lineId": "1040:16",
          "label": "Long-term gain / qualified dividends — 15% rate layer",
          "inputs": [
            { "name": "preferentialIncomeAt15", "value": 4000 }
          ],
          "rule": {
            "description": "15% preferential rate within the 15% band",
            "authority": "IRC §1(h)",
            "constantRef": {
              "table": "LTCG_BY_YEAR",
              "key": "2025/single",
              "value": "15% from $48,350 to $533,400 taxable income",
              "revProc": "Rev. Proc. 2024-40"
            }
          },
          "computation": "0.15 × $4,000 = $600, rounded to $600 (QDCGT line 18)",
          "result": 600
        },
        {
          "lineId": "1040:16",
          "label": "QDCGT Worksheet line 25 — smaller of line 23 or line 24",
          "inputs": [
            { "name": "line23StackedTax", "value": 12119 },
            { "name": "line24AllOrdinaryTax", "value": 12399 }
          ],
          "rule": {
            "description": "the taxpayer can never owe more than if none of the income received preferential treatment — line 25 is the smaller of the stacked (0/15/20-layered) computation and the all-ordinary computation on the full amount",
            "authority": "Form 1040 instructions — Qualified Dividends and Capital Gain Tax Worksheet, line 25"
          },
          "computation": "min($12,119, $12,399) = $12,119 (selected line23)",
          "result": 0
        }
      ]
    },
    {
      "lineId": "1040:24",
      "label": "Total tax",
      "amount": 12119,
      "derivation": []
    }
  ],
  "flags": [
    "OBBBA-2025-new-deductions-senior-bonus/tips/overtime/car-loan-NOT-evaluated-engine-cannot-verify-eligibility-from-W2/1099-preparer-must-confirm"
  ],
  "billed": true,
  "retry_safe": true,
  "next_action": "none",
  "provenance": { "engine": "deterministic", "jurisdiction": "federal", "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 is $12,119. The $4,000 of qualified dividends are taxed in the preferential bands; open the full response to see the line-by-line derivation.

Capital gains, tax-exempt interest, and foreign tax

Capital gains (Schedule D and Form 8949 facts), tax-exempt interest, and the foreign tax credit have their own fields and affirmations. They are listed in the federal reference, and their boundaries are on What it covers.

See also: Federal tax for a W-2 employee, Declines & affirmations, and /tax-compute/federal.

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.

Income modules — business, rental, passthrough
CapabilityStatus
W-2 wages + 1099 interest / dividendsComputes federal tax on W-2 wages plus 1099 interest and dividends (Form 1040, Schedule B).✅ shipped & certified