Skip to content
BillTruth

We may earn a commission when you sign up through our links — it never changes your price. Rankings are set by math, not by who pays us.

For developers and partners

Connect an assistant

A remote MCP server over the same public JSON the widget uses. No key. An assistant that can call it can answer a zip-and-usage question with the numbers we would show a person, and a date on them.

The URL

https://billtruth.co/api/v1/mcp

JSON-RPC 2.0 over HTTP. CORS is open. There is no OAuth step and no signup. If a commercial arrangement is ever needed, that is a conversation, not a flow built into this page.

Tools

compare_plans(zip, monthly_kwh) returns the ranking at that usage. Pass detail: "full" to attach the receipt to each plan. explain_plan(plan_id_or_name, zip, monthly_kwh) returns the receipt: line items, credits earned or missed by month, and the gotchas. check_territory(zip) says whether the zip is deregulated and which TDU serves it. Every response includes verified_as_of and a canonical page URL. Enrollment, when present, is a single /api/go link.

Claude

In Claude, open Settings, then Connectors, and add a custom connector. Paste the URL above. Claude Desktop can also list it under mcpServers in the config file as a URL-type server pointing at the same address. Once connected, a prompt like “what does a year of electricity cost at 78701 and 1,000 kWh” should call compare_plans.

ChatGPT

In ChatGPT, enable developer mode or connectors (the label moves), add an MCP server, and paste the same URL. If the product asks for OAuth, it is asking for something this server does not have — there is nothing to put in those fields.

What you would want from it

The three tools are the ones this site already answers. If you connect an assistant and find a question it cannot ask, or a response that should carry something it does not, write to hello@billtruth.co.