Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_ac_btu_tonnage

Calculate required AC cooling BTU, condenser tonnage, airflow, and sensible load from square footage, ceiling height, climate zone, and occupants to size residential HVAC systems accurately.

Instructions

HVAC Air Conditioner BTU & Tonnage Calculator. Calculate residential cooling BTU requirements and AC condenser tonnage based on square footage, ceiling height, and climate zone. Discipline: CONSTRUCTION. Governing mathematical model / formula: Cooling Tons = Total Required BTU / 12,000 BTU/ton.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of condenser_tonnage (Recommended AC Tonnage), cooling_btu (Required Cooling Capacity), cfm_airflow (Required Airflow (CFM)), sensible_load (Volume Enclosure Multiplier) using square_footage (Conditioned Home Area in sq ft), ceiling_height (Average Ceiling Height in ft), climate_zone (Climate Zone (Zone 1 Hot to Zone 5 Cool)), occupants (Number of Regular Occupants). 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 'HVAC Air Conditioner BTU & Tonnage 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): "ac-btu-tonnage"

    • category (string): "construction"

    • name (string): "HVAC Air Conditioner BTU & Tonnage Calculator"

    • formula (string): Governing mathematical formula string

    • inputs (object): Echoed input parameter dictionary with applied defaults

    • metrics (object): Dictionary of computed outputs:

      • metrics.condenser_tonnage (Recommended AC Tonnage): Formatted display string (e.g. '3.5 Tons')

      • metrics.cooling_btu (Required Cooling Capacity): Formatted display string (e.g. '42,400 BTU/hr')

      • metrics.cfm_airflow (Required Airflow (CFM)): Formatted display string (e.g. '1,400 CFM (400 CFM/Ton)')

      • metrics.sensible_load (Volume Enclosure Multiplier): Formatted display string (e.g. '1.12× base load')

    • 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_ac_btu_tonnage"
  }
}

Input Schema

NameRequiredDescriptionDefault
occupantsNoNumber of Regular Occupants. Each occupant adds ~400 BTU sensible/latent heat. Default: 4. Min: 1. Max: 12.
climate_zoneNoClimate Zone (Zone 1 Hot to Zone 5 Cool). 1: Deep South/TX/FL, 3: Mid-Atlantic, 5: Northern US. Default: 3. Min: 1. Max: 5.
ceiling_heightNoAverage Ceiling Height (ft). Standard is 8 to 9 ft. Default: 9. Min: 8. Max: 16.
square_footageNoConditioned Home Area (sq ft). Finished heated/cooled square footage. Default: 2200. Min: 200. Max: 8000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools