omni_qbi_deduction
Calculates the 20% Section 199A QBI deduction for pass-through entities and checks SSTB phase-out thresholds, returning precise deduction and tax-savings amounts.
Instructions
Section 199A Qualified Business Income (QBI) Calculator. Calculate the 20% Section 199A QBI deduction for pass-through entities (LLCs, S-Corps, partnerships), testing Specified Service Trade or Business (SSTB) thresholds. Discipline: FINANCE. Governing mathematical model / formula: QBI Deduction = Qualified Business Income × 20% (Subject to Wage / Property Caps).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of qbi_deduction_amount (Section 199A QBI Tax Deduction), effective_tax_savings_qbi (Estimated Federal Tax Saved (24% Bracket)), phaseout_limitation_status (Threshold & Phase-Out Status), effective_taxable_qbi (Taxable Profit After 20% Deduction) using qualified_business_income (Qualified Business Income (QBI)), taxable_income_total (Total Taxable Income on Form 1040), sstb_business_flag (Specified Service Business (Law, Health, Consulting, Finance)), filing_status_qbi (Filing Status (1 = Single, 2 = Married Filing Jointly)). 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 199A Qualified Business Income (QBI) 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): "qbi-deduction"
category (string): "finance"
name (string): "Section 199A Qualified Business Income (QBI) Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.qbi_deduction_amount (Section 199A QBI Tax Deduction): Formatted display string (e.g. '$28,000.00')
metrics.effective_tax_savings_qbi (Estimated Federal Tax Saved (24% Bracket)): Formatted display string (e.g. '$6,720.00 Cash Saved')
metrics.phaseout_limitation_status (Threshold & Phase-Out Status): Formatted display string (e.g. 'Below Threshold (100% Full Deduction)')
metrics.effective_taxable_qbi (Taxable Profit After 20% Deduction): Formatted display string (e.g. '$112,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_qbi_deduction"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| filing_status_qbi | No | Filing Status (1 = Single, 2 = Married Filing Jointly). Determines phase-out threshold. Default: 1. Min: 1. Max: 2. | |
| sstb_business_flag | No | Specified Service Business (Law, Health, Consulting, Finance). 0 = Non-SSTB (Real estate, tech, retail); 1 = SSTB (Doctors, lawyers, consultants). Default: 0. Min: 0. Max: 1. | |
| taxable_income_total | No | Total Taxable Income on Form 1040. Total taxable income before QBI deduction. Default: 165000. Min: 20000. Max: 5000000. | |
| qualified_business_income | No | Qualified Business Income (QBI). Net domestic profit from eligible pass-through trade/business. Default: 140000. Min: 10000. Max: 5000000. |