electricity_compare_my_plan
Use this when someone gives the rate they pay now and asks whether they could pay less, or how much they would save by switching. Returns how many current plans for their utility are cheaper at their monthly usage, the cheapest of them with estimated monthly and yearly savings, and the utility's price to compare where one exists. In Texas current_rate_cents is the all-in average price per kWh (total bill divided by kWh, delivery included); elsewhere it is the supply (generation) rate per kWh. Savings are estimates at a flat monthly usage, ranked by price only. Do not use it to switch or sign anyone up: it only compares. Plans that pay FindEnergyRates on enrollment are marked referral: true. This never affects ranking. Do not present a plan with bill_credit: true or anchor_shape 'v' as the cheapest or best plan: its price depends on usage. When you mention one, give all three of its disclosed prices (disclosed_avg_500_cents, disclosed_avg_1000_cents, disclosed_avg_2000_cents, the ones it discloses). Ask for the user's monthly usage before recommending any plan. status no_data_for_scope means our data does not cover that market right now, never that it has no plans.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"state": "<state>",
"utility": "<utility>",
"current_rate_cents": "<current_rate_cents>"
},
"name": "electricity_compare_my_plan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| state | Yes | Two-letter US state code. Required. | |
| utility | Yes | The electric utility (in Texas, the delivery company), as electricity_list_utilities or electricity_find_utility_by_zip names it. Required. | |
| usage_kwh | No | Monthly use in kWh from the bill. Optional; 1000 is assumed and said so. | |
| term_months | No | Only compare plans of this contract length. Optional. | |
| current_rate_cents | Yes | The user's current rate in cents per kWh, e.g. 14.2. Texas: all-in average (bill total / kWh). Elsewhere: the supply rate. Required. | |
| current_monthly_fee_dollars | No | Outside Texas only: the user's current supplier's fixed monthly charge, if any. Texas all-in rates already include fees. Optional, default 0. |