Skip to main content
Glama
omnioperand-mcp

omnioperand-mcp

omni_battery_cycle_life_dod

Calculate expected cycle life, calendar lifespan, lifetime kWh throughput, and levelized storage cost for LiFePO4 or NMC batteries using capacity, depth of discharge, and pack cost.

Instructions

Battery Cycle Life vs Depth of Discharge (DoD) Degradation Calculator. Calculate total lifetime kilowatt-hour throughput and calendar battery lifespan for Lithium Iron Phosphate (LiFePO4) and NMC lithium-ion chemistries. Discipline: ENERGY. Governing mathematical model / formula: Lifetime Throughput = Pack Capacity (kWh) × Cycle Life × Depth of Discharge.

USAGE GUIDELINES:

  • WHEN TO USE: Invoke for deterministic calculation of expected_cycle_life (Expected Full Cycles to 80% SOH), calendar_life_years (Estimated Usable Lifespan), levelized_storage_cost (Levelized Cost of Storage (LCOS)), lifetime_kwh_throughput (Total Cumulative Energy Delivered) using pack_capacity_kwh (Nominal Battery Pack Size (kWh) in kWh), daily_dod_pct (Operating Depth of Discharge (DoD %) in %), battery_chemistry (Battery Chemistry (1 = LFP / LiFePO4, 2 = NMC Lithium)), pack_cost_usd (Total Battery System Purchase Price ($)). 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 'Battery Cycle Life vs Depth of Discharge (DoD) Degradation 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): "battery-cycle-life-dod"

    • category (string): "energy"

    • name (string): "Battery Cycle Life vs Depth of Discharge (DoD) Degradation Calculator"

    • formula (string): Governing mathematical formula string

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

    • metrics (object): Dictionary of computed outputs:

      • metrics.expected_cycle_life (Expected Full Cycles to 80% SOH): Formatted display string (e.g. '5,000 Cycles')

      • metrics.calendar_life_years (Estimated Usable Lifespan): Formatted display string (e.g. '13.7 Years (1 cycle/day)')

      • metrics.levelized_storage_cost (Levelized Cost of Storage (LCOS)): Formatted display string (e.g. '$0.15 / kWh throughput')

      • metrics.lifetime_kwh_throughput (Total Cumulative Energy Delivered): Formatted display string (e.g. '56,000 kWh')

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

Input Schema

NameRequiredDescriptionDefault
daily_dod_pctNoOperating Depth of Discharge (DoD %) (%). Average percentage of battery capacity discharged daily. Default: 80. Min: 20. Max: 100.
pack_cost_usdNoTotal Battery System Purchase Price ($). Initial capital investment in battery. Default: 8500. Min: 500. Max: 80000.
battery_chemistryNoBattery Chemistry (1 = LFP / LiFePO4, 2 = NMC Lithium). LFP: 4000-6000 cycles, NMC: 1500-2500 cycles. Default: 1. Min: 1. Max: 2.
pack_capacity_kwhNoNominal Battery Pack Size (kWh) (kWh). Nameplate battery energy storage. Default: 14. Min: 1. Max: 150.

Schema Changelog

Changes observed during successful MCP inspections.

  1. Addedv0.1.2

TDQS

Score is being calculated.

Deploy Server

Other Tools