Check a business electricity bill
scan_billUse this when a small business wants its electricity bill checked, a cheaper rate plan, the cost of a coming rate change, or its peak kW explained. A partial call is fine: always call scan_bill first with whatever numbers or place the user gave (e.g. bill: { total: 640 }, address: 'Phoenix, AZ' without kWh, or only kWh without an address, or a short Green Button CSV snippet, or a Texas retail bill), and the tool returns need_input with missing (plus peaks when interval rows are sent) or no_rates for Texas retail. Pass bill (kwh, kw, total, rate, utility, dates, charges; omit what is not stated, never guess) or bill_text, plus address (city, street, or ZIP), optional usage_csv and current_rate. Free; nothing stored.
Example tool call
This call uses example arguments supplied in the tool’s input schema.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"bill": {
"kw": 9,
"kwh": 2150,
"rate": "GS-17",
"total": 471.7,
"utility": "Georgia Power"
},
"address": "1 Sample Way, Atlanta, GA 30303"
},
"name": "scan_bill"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bill | No | Bill numbers already read or typed (even partial, such as only total or only kwh) | |
| address | No | Service address, city (such as 'Phoenix, AZ'), or ZIP code; pass whatever location the user named, even just a city | |
| bill_text | No | The text of the bill, pasted or from the PDF text layer | |
| usage_csv | No | A Green Button or utility interval usage CSV (15-minute, 30-minute or hourly) | |
| current_rate | No | The rate plan the business is on, when the bill does not name it |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bill | Yes | The bill numbers the scan used | |
| as_of | Yes | ISO 8601 time the data was published by its source or fetched from it. A cached answer keeps the time of its fetch. | |
| offer | Yes | ||
| peaks | Yes | ||
| plans | Yes | Other plans this business can use, cheapest first | |
| notice | Yes | ||
| source | Yes | Who the data comes from, to cite and to check it against. | |
| status | Yes | ||
| message | Yes | What the scan found, or what it needs, in plain words | |
| missing | Yes | Inputs that would make the answer exact | |
| sources | Yes | ||
| utility | Yes | ||
| findings | Yes | Plain sentences, largest money first | |
| upcoming | Yes | ||
| current_rate | Yes | ||
| recalculation | Yes |