compare_sites
Compare and rank 2-25 candidate US sites (ZIP codes) for a facility, data center or EV/flexible load on grid carbon and electricity cost in one call. Per site: eGRID CO2e kg/kWh (location-based), Green-e residual mix (market-based), carbon-free %, $/kWh for the sector (the state's latest full-year average, EIA-861 annual; the ZIP's own 2023 utility average is shown as a reference), and the cleanest daily window from the 7-day hourly profile of its balancing authority, in the ZIP's local time. lowest_cost and best_combined are null unless every site has a rate. With annual_kwh, also annual tCO2e and cost. Returns competition ranks by carbon, cost and combined, gap percentages, and best_* = null with *_tied lists when sites tie.
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": {
"zips": "<zips>"
},
"name": "compare_sites"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| zips | Yes | Candidate US ZIP codes (5 digits or ZIP+4) | |
| sector | No | Retail rate sector. Default COM (commercial); use IND for industrial/data-center loads. | |
| duration | No | Length of the cleanest daily window in hours (default 4) | |
| annual_kwh | No | Optional annual consumption in kWh (e.g. 87,600,000 for a 10 MW constant load) to get annual tCO2e and cost per site |