Guides by outcome
Build a review packet for a preparer
Recompute a set of federal profiles under the current engine and hand a preparer a packet of independent items to review, each with its own result, provenance, and legal notice.
When to use it
Use a review packet when a person is about to review several returns or variants together, for example a household's alternatives or a batch of clients, and you want every figure recomputed fresh rather than taken from storage.
- Up to 25 profiles per request, in the federal request shape.
- No packet-level total, summary, count, or status. The packet is a non-exhaustive assembly of what you sent, not a completed or filed return.
- Billed per item that computes or declines. An Idempotency-Key is required.
Assemble a packet
Request
curl https://tax-mcp.com/api/mcp/tax-compute/review-packet \
-H "Authorization: Bearer $TAX_MCP_API_KEY" \
-H "Content-Type: application/json" \
-H "Idempotency-Key: $(uuidgen)" \
-d '{
"scenarios": [
{
"label": "client-a-single",
"profile": {
"year": 2025,
"filingStatus": "single",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 90000,
"medicareWages": 90000
}
},
{
"label": "client-b-joint",
"profile": {
"year": 2025,
"filingStatus": "married_filing_jointly",
"canBeClaimedAsDependent": false,
"noForeignOrTerritoryExclusionAffirmed": true,
"wages": 180000,
"medicareWages": 180000
}
}
]
}'Response 200 · 2 of 2 computed
{
"workflow": "review-packet",
"disclaimer": "<workflow disclaimer: hypothetical / not advice / not a filing / not ranked — elided>",
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
},
"items": [
{
"index": 0,
"label": "client-a-single",
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
},
"computed": true,
"year": 2025,
"filingStatus": "single",
"taxableIncome": 74250,
"incomeTax": 11255,
"totalTax": 11255,
"lines": [
{ "lineId": "1040:15", "label": "Taxable income", "amount": 74250 },
{
"lineId": "1040:16",
"label": "Income tax",
"amount": 11255,
"derivation": "<5 derivation steps — see full response>"
},
{ "lineId": "1040:24", "label": "Total tax", "amount": 11255 }
],
"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": "review-packet",
"tax_year": 2025
}
},
{
"index": 1,
"label": "client-b-joint",
"legal_notice": {
"ref": "https://tax-mcp.com/terms#compute-notice",
"version": "v1",
"text": "<computation-support notice — see full response>"
},
"computed": true,
"year": 2025,
"filingStatus": "married_filing_jointly",
"taxableIncome": 148500,
"incomeTax": 22498,
"totalTax": 22498,
"lines": [
{ "lineId": "1040:15", "label": "Taxable income", "amount": 148500 },
{
"lineId": "1040:16",
"label": "Income tax",
"amount": 22498,
"derivation": "<3 derivation steps — see full response>"
},
{ "lineId": "1040:24", "label": "Total tax", "amount": 22498 }
],
"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": "review-packet",
"tax_year": 2025
}
}
]
}Full response, including line derivations
{
"workflow": "review-packet",
"disclaimer": "<workflow disclaimer: hypothetical / not advice / not a filing / not ranked — elided>",
"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."
},
"items": [
{
"index": 0,
"label": "client-a-single",
"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."
},
"computed": true,
"year": 2025,
"filingStatus": "single",
"taxableIncome": 74250,
"incomeTax": 11255,
"totalTax": 11255,
"lines": [
{
"lineId": "1040:15",
"label": "Taxable income",
"amount": 74250,
"derivation": []
},
{
"lineId": "1040:16",
"label": "Income tax",
"amount": 11255,
"derivation": [
{
"lineId": "1040:16",
"label": "Tax Table method (IRS-mandated below $100,000 taxable income)",
"inputs": [
{ "name": "taxableIncome", "value": 74250 }
],
"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 $74,250 → Tax Table band midpoint $74,275",
"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": 25800 }
],
"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 × $25,800 = $5,676",
"result": 5676
},
{
"lineId": "1040:16",
"label": "Whole-dollar rounding — ordinary income tax",
"inputs": [
{ "name": "unroundedOrdinaryTax", "value": 11255 }
],
"rule": {
"description": "round the ordinary income tax to whole dollars",
"authority": "Form 1040 instructions — whole-dollar rounding"
},
"computation": "$11,255 − $11,254.5 = $0.5",
"result": 0.5
}
]
},
{
"lineId": "1040:24",
"label": "Total tax",
"amount": 11255,
"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": "review-packet",
"tax_year": 2025
}
},
{
"index": 1,
"label": "client-b-joint",
"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."
},
"computed": true,
"year": 2025,
"filingStatus": "married_filing_jointly",
"taxableIncome": 148500,
"incomeTax": 22498,
"totalTax": 22498,
"lines": [
{
"lineId": "1040:15",
"label": "Taxable income",
"amount": 148500,
"derivation": []
},
{
"lineId": "1040:16",
"label": "Income tax",
"amount": 22498,
"derivation": [
{
"lineId": "1040:16",
"label": "Ordinary income tax — 10% bracket",
"inputs": [
{ "name": "taxableIncomeInBracket", "value": 23850 }
],
"rule": {
"description": "marginal rate × taxable income falling within this bracket",
"authority": "IRC §1(j)",
"constantRef": {
"table": "BRACKETS_BY_YEAR",
"key": "2025/married_filing_jointly",
"value": "10% (up to $23,850)",
"revProc": "Rev. Proc. 2024-40"
}
},
"computation": "0.1 × $23,850 = $2,385",
"result": 2385
},
{
"lineId": "1040:16",
"label": "Ordinary income tax — 12% bracket",
"inputs": [
{ "name": "taxableIncomeInBracket", "value": 73100 }
],
"rule": {
"description": "marginal rate × taxable income falling within this bracket",
"authority": "IRC §1(j)",
"constantRef": {
"table": "BRACKETS_BY_YEAR",
"key": "2025/married_filing_jointly",
"value": "12% (up to $96,950)",
"revProc": "Rev. Proc. 2024-40"
}
},
"computation": "0.12 × $73,100 = $8,772",
"result": 8772
},
{
"lineId": "1040:16",
"label": "Ordinary income tax — 22% bracket",
"inputs": [
{ "name": "taxableIncomeInBracket", "value": 51550 }
],
"rule": {
"description": "marginal rate × taxable income falling within this bracket",
"authority": "IRC §1(j)",
"constantRef": {
"table": "BRACKETS_BY_YEAR",
"key": "2025/married_filing_jointly",
"value": "22% (up to $206,700)",
"revProc": "Rev. Proc. 2024-40"
}
},
"computation": "0.22 × $51,550 = $11,341",
"result": 11341
}
]
},
{
"lineId": "1040:24",
"label": "Total tax",
"amount": 22498,
"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": "review-packet",
"tax_year": 2025
}
}
]
}Review packet or what-if?
They take the same input. Use what-if for hypothetical projections and a review packet for real profiles a preparer is going to sign off on; the response wording and disclaimer differ accordingly.
See also: /tax-compute/review-packet.