omni_exchange_1031
Calculates deferred federal capital gains and depreciation recapture taxes, net boot, and minimum replacement property purchase for IRS Section 1031 like-kind exchanges.
Instructions
Section 1031 Like-Kind Exchange & Tax Deferral Calculator. Calculate deferred federal capital gains tax, net boot, depreciation recapture tax, and replacement property equity requirements under IRS Section 1031. Discipline: FINANCE. Governing mathematical model / formula: Realized Gain = Net Sales Price - Adjusted Basis | Tax Deferred = (Cap Gain × Rate) + (Recapture × 25%).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_tax_deferred (Total Estimated Tax Deferred), net_capital_gain (Total Realized Taxable Gain), replacement_min_purchase (Min Replacement Purchase to Avoid Boot), net_exchange_equity (Cash Equity Transferred to QI Escrow) using relinquished_sales_price (Relinquished Property Sale Price), original_purchase_basis (Original Purchase Basis (Cost + Improvements)), accumulated_depreciation (Total Accumulated Depreciation Deducted), relinquished_loan_payoff (Mortgage Debt Paid Off at Closing). Guarantees exact machine floating-point precision, eliminating LLM arithmetic mistakes and formula hallucinations.
WHEN NOT TO USE: Do not use for qualitative evaluations or unquantified reasoning. All input parameters must be valid numerical values.
DISAMBIGUATION & BOUNDARIES:
Use this dedicated specialist tool for 'Section 1031 Like-Kind Exchange & Tax Deferral Calculator' rather than generic dispatchers like omni_universal_query.
For multi-calculation chained jobs, use 'omni_batch_calculate'.
To inspect schema fields, see 'omni_describe_solver'.
BEHAVIOR & SAFETY:
Pure deterministic computation with machine floating-point precision.
Read-only, idempotent, and stateless. Zero side effects or persistent state mutations.
Input validation: All arguments are validated against physical and domain bounds. Out-of-bounds inputs return a safe diagnostic error status without throwing runtime exceptions.
RETURNS:
Structured JSON object containing:
status (string): "success" on valid execution or "error" if validation fails
calculator (string): "exchange-1031"
category (string): "finance"
name (string): "Section 1031 Like-Kind Exchange & Tax Deferral Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_tax_deferred (Total Estimated Tax Deferred): Formatted display string (e.g. '$191,000.00')
metrics.net_capital_gain (Total Realized Taxable Gain): Formatted display string (e.g. '$730,000.00')
metrics.replacement_min_purchase (Min Replacement Purchase to Avoid Boot): Formatted display string (e.g. '$1,200,000.00')
metrics.net_exchange_equity (Cash Equity Transferred to QI Escrow): Formatted display string (e.g. '$750,000.00')
execution_time_ms (number): Latency in milliseconds.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "omni_exchange_1031"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| original_purchase_basis | No | Original Purchase Basis (Cost + Improvements). Original cost basis plus capitalized capital improvements. Default: 650000. Min: 25000. Max: 100000000. | |
| accumulated_depreciation | No | Total Accumulated Depreciation Deducted. Depreciation taken over ownership. Default: 180000. Min: 0. Max: 20000000. | |
| relinquished_loan_payoff | No | Mortgage Debt Paid Off at Closing. Lender payoff balance. Default: 450000. Min: 0. Max: 50000000. | |
| relinquished_sales_price | No | Relinquished Property Sale Price. Gross sales price of sold property. Default: 1200000. Min: 50000. Max: 100000000. |