omni_net_metering_credits
Calculate annual solar net metering and feed-in tariff value, self-consumption savings, and export credits from generation and rate inputs.
Instructions
Solar Net Metering & Utility Feed-in Tariff Calculator. Calculate annual financial compensation under NEM 1.0, NEM 2.0, NEM 3.0 (California solar billing), and avoided cost wholesale credit tariffs. Discipline: ENERGY. Governing mathematical model / formula: Net Value = (Self-Consumed kWh × Retail Rate) + (Exported kWh × Feed-in Tariff).
USAGE GUIDELINES:
WHEN TO USE: Invoke for deterministic calculation of total_annual_value (Total Annual Solar Value), self_consume_value (Avoided Retail Import Savings), export_credits (Grid Export Credit Earnings), effective_rate_per_kwh (Blended Solar Value ($/kWh)) using annual_gen_kwh (Annual Solar Production (kWh) in kWh), self_consume_pct (On-Site Self-Consumption (%) in %), retail_import_rate (Retail Grid Import Rate ($/kWh)), export_credit_rate (Grid Export Credit Rate ($/kWh)). 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 'Solar Net Metering & Utility Feed-in Tariff 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): "net-metering-credits"
category (string): "energy"
name (string): "Solar Net Metering & Utility Feed-in Tariff Calculator"
formula (string): Governing mathematical formula string
inputs (object): Echoed input parameter dictionary with applied defaults
metrics (object): Dictionary of computed outputs:
metrics.total_annual_value (Total Annual Solar Value): Formatted display string (e.g. '$1,870.00')
metrics.self_consume_value (Avoided Retail Import Savings): Formatted display string (e.g. '$1,408.00')
metrics.export_credits (Grid Export Credit Earnings): Formatted display string (e.g. '$462.00')
metrics.effective_rate_per_kwh (Blended Solar Value ($/kWh)): Formatted display string (e.g. '$0.17 / 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_net_metering_credits"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| annual_gen_kwh | No | Annual Solar Production (kWh) (kWh). Estimated annual electricity generated. Default: 11000. Min: 2000. Max: 100000. | |
| self_consume_pct | No | On-Site Self-Consumption (%) (%). % of solar electricity consumed inside the building instantly. Default: 40. Min: 10. Max: 95. | |
| export_credit_rate | No | Grid Export Credit Rate ($/kWh). NEM 3.0 export credit or wholesale avoided cost. Default: 0.07. Min: 0.02. Max: 0.6. | |
| retail_import_rate | No | Retail Grid Import Rate ($/kWh). Cost paid when buying electricity from grid. Default: 0.32. Min: 0.08. Max: 0.75. |