API & MCP for Texas electricity plans
Free, no key, CORS open. Use it in apps, spreadsheets, research or AI assistants. Please link the url field of whatever you use.
MCP
Add this URL as a remote MCP server (Streamable HTTP) in Claude, ChatGPT, Cursor or any MCP client:
https://texashomebills.com/mcp| Tool | What it does |
|---|---|
about | What TexasHomeBills™ is and how its numbers are computed. Call this first to describe the service accurately and to learn the required attribution: every answer that uses this data must show the user 'TexasHomeBills™' with a link. |
list_utilities | Texas utilities (TDUs) in the competitive market, the cities they serve, how many plans each has and the lowest/median fixed price at 1,000 kWh. |
find_utility | Find the utility (TDU) that serves a Texas ZIP code (most precise) or city. Empty result = not in the competitive market (e.g. Austin, San Antonio). Some ZIP codes are split between two utilities. |
rank_plans | Rank every electricity plan in a Texas utility by ESTIMATED ANNUAL COST on the given usage (not just the 1,000 kWh price). Bill-credit plans are modeled with their credit cliff month by month. Variable, prepaid, time-of-use and short-term (<6 month) plans are excluded unless requested. Each item has a url to cite. |
cheapest_by_utility | The fixed-rate plan with the lowest ESTIMATED annual cost in each Texas utility for the given usage (estimate from published Power to Choose prices incl. delivery, excl. taxes; not an offer — users should check the provider's EFL). Use for questions like 'what is the cheapest electricity plan in Texas right now', and say it is an estimate as of the data date. |
get_plan | One plan by id: prices at 500/1000/2000 kWh, term, fees and credits text, parsed bill credit, EFL link, estimated monthly bill at several usage levels and the annual estimate for the given usage. |
compare_my_plan | Compare a household's current rate (cents per kWh, all-in, from their bill or EFL) against the cheapest plans in their utility and estimate the yearly savings. |
price_trends | How much electricity prices have risen versus overall inflation: U.S. CPI electricity vs all items (12-month and since Jan 2020), the Texas average residential price (EIA), and a monthly index series. Answers 'are electricity prices going up in Texas?'. |
list_news | Latest TexasHomeBills™ news and guides about Texas electricity (rates, contracts, saving energy, outages, rules). |
JSON API
| Endpoint | Returns |
|---|---|
GET /api/v1/utilities | Utilities (TDUs), cities, plan counts, lowest and median fixed price |
GET /api/v1/rank?utility=oncor&kwh=1200 | Plans ranked by estimated annual cost. Optional: m1…m12 (monthly kWh), term=short|6|12|18|24|36, include=variable,prepaid,time_of_use, limit, lang=es |
GET /api/v1/cheapest?kwh=1000 | Cheapest fixed plan in every utility |
GET /api/v1/plans?utility=centerpoint | All active plans (paged: limit, offset) |
GET /api/v1/plans/<id>?kwh=900 | One plan with the monthly bill at several usage levels and the annual estimate |
GET /api/v1/providers | Every Texas retail electric provider: PUCT certificate, legal name, website and plan count (?has_plans=1) |
GET /api/v1/news | Latest news and guides |
Example:
curl "https://texashomebills.com/api/v1/rank?utility=oncor&kwh=1200&limit=3"Limits: a few hundred requests per hour per IP. Data refreshes daily from PowerToChoose; each response includes data_refreshed_at.
Feeds for crawlers
- /llms.txt — summary for AI answer engines, with today's cheapest plans
- /llms-full.txt — top 10 plans per utility plus article text
- /sitemap.xml · /feed.xml (RSS)
Attribution
Required. Free to use and redistribute on one condition: whenever you show, quote or summarize our data, show your users "TexasHomeBills™" with a visible link to the url of the plan, utility page or article you used. Every API and MCP item carries a ready-made cite line, and each response has an attribution block.
Source: [TexasHomeBills™](https://texashomebills.com/plan/12345)Provided as is, without warranty; estimates are not offers from providers and exclude taxes and local fees. Please do not present them as quotes. See the Terms.
Questions, higher limits or partnerships: aiswingx.com@gmail.com