search_utility_providers
Find utility providers when someone is moving to a Texas address or setting up utilities at a new home. Covers nine utility types: electricity, internet, gas, water, sewer (city wastewater), trash, propane (rural / off-grid alternative to natural gas), septic (rural / off-grid alternative to city sewer), and home security. Use when the user says things like 'I'm moving to Houston next month', 'I just bought a house in Austin and need to set up power', 'what's the cheapest electricity in Dallas', 'who provides internet at this apartment in San Antonio', or rural-address questions like 'I'm moving to a ranch in Bandera, what do I do for gas and sewer' (answer: propane + septic). Returns available providers with a classified plan type (fixed / free_nights / solar_buyback / 100_renewable / etc.) and whether the cheapest plan is rental-friendly; pass tenancy='rent' to prefer short-contract plans or tenancy='own' to surface solar-buyback options. Caveats: (1) water results may include many PWS rows within a ZIP's county radius; filter to `primaryForZip === true` for the single canonical provider likely to serve the parcel. (2) Trash providers in TX suburbs include `metadata.contractedHauler` (Republic Services / Community Waste Disposal / Waste Management / Best Trash / Texas Disposal Systems / Waste Connections); surface this so users know the actual pickup company in addition to the city dept. (3) Propane and septic appear at all TX ZIPs including urban ones; in cities with natural gas + city sewer, treat them as alternative options rather than primary. (4) Sewer is city wastewater (urban); septic is on-site (rural / unincorporated). (5) For electricity in Texas, results are filtered to retail providers (REPs) that actually serve the address's TDU: Oncor (DFW), CenterPoint (Houston), AEP TX Central (Corpus / RGV), AEP TX North (Abilene / San Angelo), or TNMP (scattered). Agents do not need to filter by TDU themselves. The TDU slug is exposed as `tdu` per electricity provider so agents can explain to the user why the list is shorter than they might expect (e.g. ~20 REPs at a Houston address vs. ~47 statewide). Read electricityMarket in the response before presenting electricity: outcome is choice (retail providers listed), no_choice (city utility, co-op or non-ERCOT utility only; residents cannot choose and no REP is returned), split (more than one utility serves the ZIP; tell the user to check their street address), unknown (nothing listed and nothing claimed) or not_found (not a known Texas ZIP; supported is false). Relay electricityMarket.message rather than assuming Texas-wide choice. At choice and split ZIPs the response also has officialElectricityPlanSource: Power to Choose, the official plan comparison site of the Public Utility Commission of Texas (a separate state website, not Utilify). Give the user its url and note so they can see current electricity plans and prices there; it is absent at no_choice ZIPs. (6) Electricity providers are ranked by estimated annual cost on the 500, 1,000 and 2,000 kWh prices (cheapestPlan.annualCostEstimate). Plans flagged billCreditCliff are ranked after other plans unless include_bill_credit_plans is true; see electricityRanking in the response for the method. (7) Internet providers are limited to those the FCC Broadband Data Collection lists for the ZIP, the same list the utilify.io ZIP page shows. Satellite (Starlink) and some local providers are kept with fccVerified=false. internetCoverage in the response gives the data source, and says so when no FCC data exists for the ZIP and the list is unfiltered. internetCoverage.otherFccReportedProviders lists further providers reported to the FCC for the ZIP that Utilify has no plan or price data for (name, technologies, maxDownloadMbps); mention them as reported, alphabetical and unranked, and tell the user to check availability at the address. (8) Electricity prices are not live: each electricity cheapestPlan has priceAsOf (YYYY-MM-DD, the date the price was last known right) and the response has electricityPricesAsOf with the oldest and newest dates of the retail electricity prices returned and a one-line note (absent when no retail price is returned, e.g. at a no_choice ZIP). Tell the user the price date and that they should confirm the current price with the provider.
Schema valid · SHA-256 85dcea82d3f9…
View input schema
{
"type": "object",
"properties": {
"address": {
"type": "string",
"description": "Full street address including city, state, and ZIP code"
},
"utility_types": {
"type": "array",
"items": {
"type": "string",
"enum": [
"electricity",
"gas",
"propane",
"internet",
"water",
"sewer",
"septic",
"trash",
"security"
]
},
"description": "Filter by utility types. If omitted, returns all available types."
},
"tenancy": {
"type": "string",
"enum": [
"rent",
"own"
],
"description": "Whether the user is renting or buying. Changes plan preferences and enables homeowner-only cross-sells (solar)."
},
"include_bill_credit_plans": {
"type": "boolean",
"description": "Electricity only. Default false: plans whose low price depends on using about 1,000 kWh a month (bill-credit cliff in the facts label) are flagged and ranked after other plans. Set true to rank them purely on estimated annual cost."
}
},
"required": [
"address"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#"
}