Utilities
Decode home and commercial electric/gas/water bills: classify tariff riders and charges (CSR/CFL/MHC/HFA-style codes, TOU on/off-peak, demand, capacity tag, decoupling), convert kWh↔Btu↔therms↔Ccf↔m³↔ton-hours with EIA factors, expose hidden fixed fees, and project annual cost with load-factor and peak-shaving savings.
Call this tool from your code in three languages.
curl -X POST 'http://127.0.0.1:3003/en/api/tools/csr-cfl-cfl-mhc-hfa-btu-ton-hours-utility-bill-line-item-validator-and-rgp-peak-explainer' \
-H 'Content-Type: application/json' \
-d '{"billLines":"Customer Charge; 14.75; 1; $/mo\nOff-Peak Energy Charge; 79.17; 2100; kWh @ 0.0377\nOn-Peak Energy Charge; 245.10; 1140; kWh @ 0.215\nDemand Charge; 285.20; 12.4; kW @ 23.00\nTransmission Service Rider; 25.92; 3240; kWh\nRenewable Portfolio Standard (RPS); 8.10; 3240; kWh\nDecoupling Rider; 4.60; 1; $/mo\nGrid Access Charge; 2.50; 1; $/mo\nMunicipal Franchise Fee; 20.15; 1; 6.5% of base\nState Sales Tax; 11.83; 1; 1.9%","serviceType":"electric","billingDays":30,"usageKwh":3240,"demandKw":12.4,"onPeakKwh":1140,"offPeakKwh":2100,"gasUsageCcf":0,"waterUsageCcf":0,"taxRatePct":0}'Send a POST request with your inputs as JSON. File parameters require a separate upload first.
POST http://127.0.0.1:3003/en/api/tools/csr-cfl-cfl-mhc-hfa-btu-ton-hours-utility-bill-line-item-validator-and-rgp-peak-explainer| Name | Type | Required | Description |
|---|---|---|---|
| billLines | textarea | Yes | — |
| serviceType | select | No | — |
| billingDays | number | No | — |
| usageKwh | number | No | — |
| demandKw | number | No | — |
| onPeakKwh | number | No | — |
| offPeakKwh | number | No | — |
| gasUsageCcf | number | No | — |
| waterUsageCcf | number | No | — |
| taxRatePct | number | No | — |
HTML result
{
"result": "<div>Processed HTML content</div>",
"error": "Error message (optional)",
"message": "Notification message (optional)",
"metadata": {
"key": "value"
}
}Add this tool to your Model Context Protocol server so AI agents can list and call it.
Add this block to your MCP client configuration:
{
"mcpServers": {
"elysiatools-csr-cfl-cfl-mhc-hfa-btu-ton-hours-utility-bill-line-item-validator-and-rgp-peak-explainer": {
"name": "csr-cfl-cfl-mhc-hfa-btu-ton-hours-utility-bill-line-item-validator-and-rgp-peak-explainer",
"description": "Decode home and commercial electric/gas/water bills: classify tariff riders and charges (CSR/CFL/MHC/HFA-style codes, TOU on/off-peak, demand, capacity tag, decoupling), convert kWh↔Btu↔therms↔Ccf↔m³↔ton-hours with EIA factors, expose hidden fixed fees, and project annual cost with load-factor and peak-shaving savings.",
"baseUrl": "http://127.0.0.1:3003/mcp/sse?toolId=csr-cfl-cfl-mhc-hfa-btu-ton-hours-utility-bill-line-item-validator-and-rgp-peak-explainer",
"command": "",
"args": [],
"env": {},
"isActive": true,
"type": "sse"
}
}
}After connecting to the SSE endpoint, list the exposed tools:
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/list"
}Invoke the tool by its id, passing arguments built from its parameters:
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "csr-cfl-cfl-mhc-hfa-btu-ton-hours-utility-bill-line-item-validator-and-rgp-peak-explainer",
"arguments": {
"billLines": "Customer Charge; 14.75; 1; $/mo\nOff-Peak Energy Charge; 79.17; 2100; kWh @ 0.0377\nOn-Peak Energy Charge; 245.10; 1140; kWh @ 0.215\nDemand Charge; 285.20; 12.4; kW @ 23.00\nTransmission Service Rider; 25.92; 3240; kWh\nRenewable Portfolio Standard (RPS); 8.10; 3240; kWh\nDecoupling Rider; 4.60; 1; $/mo\nGrid Access Charge; 2.50; 1; $/mo\nMunicipal Franchise Fee; 20.15; 1; 6.5% of base\nState Sales Tax; 11.83; 1; 1.9%",
"serviceType": "electric",
"billingDays": 30,
"usageKwh": 3240,
"demandKw": 12.4,
"onPeakKwh": 1140,
"offPeakKwh": 2100,
"gasUsageCcf": 0,
"waterUsageCcf": 0,
"taxRatePct": 0
}
}
}Questions or issues? Contact [email protected]