Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_seismic_base_shear_asce7

Calculates ASCE 7/IBC seismic base shear and response coefficient from building weight, spectral acceleration, R, and importance factor for code-compliant design checks.

Instructions

Seismic Equivalent Lateral Force Base Shear Calculator (ASCE 7 / IBC). Calculate total seismic design base shear (V = Cs · W) and seismic response coefficient (Cs) compliant with ASCE 7-16 and International Building Code. Discipline: ENGINEERING. Governing mathematical model / formula: Base Shear V = Cs · W | Seismic Coefficient Cs = S_DS / (R / I_e).

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of total_seismic_base_shear_kips (Total Seismic Design Base Shear (V)), seismic_response_coeff_cs (Seismic Coefficient (Cs)), base_shear_weight_pct (Lateral Force as % of Building Weight), seismic_design_category (Seismic Design Category (SDC)) using effective_seismic_weight_kips (Total Effective Building Weight (W in Kips) in kips), spectral_acceleration_sds (Design Spectral Acceleration (S_DS) in g (gravity)), response_modification_r (Response Modification Factor (R)), importance_factor_ie (Seismic Importance Factor (I_e)). 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 'Seismic Equivalent Lateral Force Base Shear Calculator (ASCE 7 / IBC)' 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): "seismic-base-shear-asce7"

    • category (string): "engineering"

    • name (string): "Seismic Equivalent Lateral Force Base Shear Calculator (ASCE 7 / IBC)"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.total_seismic_base_shear_kips (Total Seismic Design Base Shear (V)): Formatted display string (e.g. '735.6 Kips')

      • metrics.seismic_response_coeff_cs (Seismic Coefficient (Cs)): Formatted display string (e.g. '0.1635 g')

      • metrics.base_shear_weight_pct (Lateral Force as % of Building Weight): Formatted display string (e.g. '16.4% of Total Weight')

      • metrics.seismic_design_category (Seismic Design Category (SDC)): Formatted display string (e.g. 'Category D (High Seismic Risk)')

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

Input Schema

NameRequiredDescriptionDefault
importance_factor_ieNoSeismic Importance Factor (I_e). Standard = 1.0; Schools/Assembly = 1.25; Hospitals/Emergency = 1.5. Default: 1.25. Min: 1. Max: 1.5.
response_modification_rNoResponse Modification Factor (R). Ductile moment frame = 8.0; Braced frame = 6.0; Concrete shear wall = 5.0. Default: 6.5. Min: 1.5. Max: 8.
spectral_acceleration_sdsNoDesign Spectral Acceleration (S_DS) (g (gravity)). Short-period design acceleration from USGS seismic maps. Default: 0.85. Min: 0.1. Max: 2.5.
effective_seismic_weight_kipsNoTotal Effective Building Weight (W in Kips) (kips). Total building dead load plus permanent partitions and 25% snow. Default: 4500. Min: 100. Max: 100000.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools