omni_rent_roll_analysis
Calculate commercial rent roll metrics including effective gross income, economic occupancy, revenue leakage, and monthly EGI from gross potential rent, vacancy, concessions, and ancillary income.
Instructions
Commercial Rent Roll & Economic Vacancy Calculator. Analyze commercial rent rolls, Gross Potential Rent (GPR), physical vacancy, economic concessions, and Effective Gross Income (EGI). Discipline: FINANCE. Governing mathematical model / formula: Effective Gross Income (EGI) = Gross Potential Rent - Physical Vacancy - Concessions + Ancillary Income.
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of effective_gross_income_egi (Effective Gross Income (EGI)), economic_occupancy_pct (Economic Occupancy Rate), total_revenue_loss (Total Revenue Leakage (Vacancy + Concessions)), monthly_egi (Average Monthly Operating Collections) using gross_potential_rent_gpr (Gross Potential Rent (100% Occupied)), physical_vacancy_pct (Physical Vacancy Rate (%) in %), tenant_concessions_discounts (Annual Concessions & Free Rent), ancillary_income_annual (Ancillary Other Income (Parking, Laundry, Storage)). 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 'Commercial Rent Roll & Economic Vacancy 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): "rent-roll-analysis"
category (string): "finance"
name (string): "Commercial Rent Roll & Economic Vacancy Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.effective_gross_income_egi (Effective Gross Income (EGI)): Formatted display string (e.g. '$347,100.00 / yr')
metrics.economic_occupancy_pct (Economic Occupancy Rate): Formatted display string (e.g. '91.42%')
metrics.total_revenue_loss (Total Revenue Leakage (Vacancy + Concessions)): Formatted display string (e.g. '$30,900.00 / yr')
metrics.monthly_egi (Average Monthly Operating Collections): Formatted display string (e.g. '$28,925.00 / mo')
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_rent_roll_analysis"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| physical_vacancy_pct | No | Physical Vacancy Rate (%) (%). Percentage of units physically unleased. Default: 6.5. Min: 0. Max: 50. | |
| ancillary_income_annual | No | Ancillary Other Income (Parking, Laundry, Storage). Pet fees, RUBS utility reimbursement, storage. Default: 18000. Min: 0. Max: 5000000. | |
| gross_potential_rent_gpr | No | Gross Potential Rent (100% Occupied). Market rent if 100% of units occupied at market rates. Default: 360000. Min: 10000. Max: 50000000. | |
| tenant_concessions_discounts | No | Annual Concessions & Free Rent. Move-in discounts, rent abatements, bad debt. Default: 7500. Min: 0. Max: 1000000. |