MCP

EnergyBot MCP Server

Connect EnergyBot to Claude, ChatGPT, Codex, Cursor or any MCP-compatible agent. Your agent can search residential electricity plans by ZIP code, narrow them by supplier, plan or contract length, compare costs at the user's real usage, and hand back an enrollment link.

https://mcp.energybot.com/mcp

Transport Streamable HTTPAuth NoneCost Freellms.txt energybot.com/llms.txt

Connect your agent

Claude and Claude Desktop

Open Customize → Connectors, click + Add, then Add custom connector.
Name it EnergyBot and paste the URL above.
Under Authentication, choose No sign in, then click Add.
In a chat, click +, open Connectors and turn on EnergyBot.

On Team and Enterprise plans, an Owner adds it first in Organization settings → Connectors. Members then connect it from Customize → Connectors.

Claude Code

Run this in your terminal.

claude mcp add --transport http energybot https://mcp.energybot.com/mcp

ChatGPT

Open Plugins, select +, then Add custom MCP server.
Name it EnergyBot, add a short description and paste the URL above under Connection.
No authentication is needed. Review the risk warning and select I understand and want to continue.
Select Create as a plugin, then install it.
In a new chat, type @ and select EnergyBot.

Codex

Run this in your terminal.

codex mcp add energybot --url https://mcp.energybot.com/mcp

Or add this to ~/.codex/config.toml.

[mcp_servers.energybot]
url = "https://mcp.energybot.com/mcp"

Cursor

Add this to ~/.cursor/mcp.json, or add it from the Customize page.

{
  "mcpServers": {
    "energybot": { "url": "https://mcp.energybot.com/mcp" }
  }
}

Other MCP clients

Follow your client's MCP setup steps and use the URL above. No authentication is needed. Clients that only support stdio can bridge with mcp-remote:

npx -y mcp-remote https://mcp.energybot.com/mcp

Try asking

"Find the cheapest 12-month electricity plan in Dallas 75201."
"I use about 1,400 kWh a month in 76107. What would I pay on the top three plans?"
"Show me Gexa Energy's plans in Houston 77002."
"What would Energy Texas Come & Take It 12 cost me at 2,000 kWh a month in 75201?"
"Which plans in Houston are 100% renewable, and what's the early termination fee on each?"

Tool

search_residential_electricity_plans

Read. No writes and no sensitive writes. Returns plans and never enrolls anyone.

Returns residential plans available at a US ZIP code, ranked by EnergyBot's all-in rate: the annualized cost per kWh after fees, bill credits and usage rules.

zipCodeRequired

5-digit US ZIP code.

monthlyUsageKwhOptional

Average monthly usage in kWh. Defaults to 1,000.

termOptional

Contract length in months, such as 12, 24 or 36.

supplierNameOptional

Supplier name, exact match. Example: Gexa Energy.

planTitleOptional

Plan name, exact match. Example: Come & Take It 12.

Each plan includes the supplier name and logo, plan name, contract term, EnergyBot supplier rating, all-in rate in dollars per kWh, estimated monthly bill, renewable percentage, early termination fee, supplier registration ID where available, the plan's regulatory documents (in Texas: Electricity Facts Label, Terms of Service and Your Rights as a Customer) and an enrollment link.

Results come back three ways: structuredContent holds every plan plus totalCount, the text content summarizes the top five plans for clients that read text only, and ChatGPT and Claude show interactive plan cards.

Coverage

States. Texas, Pennsylvania, Ohio, Illinois and New Jersey.
Residential electricity only. Business plans and natural gas aren't covered.
No plans. A 5-digit ZIP code outside these states, or a search where no plan matches your filters, returns zero plans and no error: Found 0 plans for zip code 02108 (1000 kWh/month).

Errors

Invalid input returns isError: true and a message that names the field.

ZIP code not 5 digits. zipCode must be 5 digits.
Usage or term below 1. monthlyUsageKwh is less than 1 (must be greater than or equal to 1). The same message applies to term.
Wrong type or missing ZIP code. A JSON schema validation error, such as /zipCode: integer found, string expected. Send zipCode as a string and monthlyUsageKwh and term as whole numbers.

How enrollment works

Users enroll themselves. Each plan has an enrollment link to energybot.com. The user opens it and finishes signup there. Enrollment is limited to adults 18 and older.
Use the link exactly as returned. It carries the plan and ZIP code, so the user lands on the plan they picked.
Ranking. Plans are ranked by all-in rate. Suppliers don't pay for placement.

Good to know

Pass real usage. Rankings change with usage, so a plan that wins at 1,000 kWh may lose at 2,000.
Narrow big searches. Dallas 75201 returns 140 plans. Pass term or supplierName to keep responses small.
Rate limits. Requests are limited per IP address. If you get HTTP 429, wait 60 seconds and try again.
Selling to your own customers? PowerHQ, our partner platform, handles providers, enrollments and payouts for brokers and businesses that drive their own traffic. Contact PowerHQ.

Rates and plan terms change often. Check the Electricity Facts Label before enrolling.