# BillTruth

> Real annual cost for every Texas electricity plan, from each retailer's Electricity Facts Label.

- name: io.github.apollowinner/billtruth
- version: 1.0.0
- connection class: unknown (unknown)
- trust: 47/100 flags: no-repository, unreachable
- quality: 79/100 (good)
- owner: not claimed
- descriptor: https://api.protogrid.dev/v1/servers/io.github.apollowinner%2Fbilltruth
- tools: https://api.protogrid.dev/v1/servers/io.github.apollowinner%2Fbilltruth/tools

**Not classified yet.** The remote endpoints have not been probed successfully, or the listing has nothing to connect to.

## Connection (mcpServers)

```json
{
  "mcpServers": {
    "billtruth": {
      "type": "http",
      "url": "https://billtruth.co/api/v1/mcp"
    }
  }
}
```


## Trust

- hygiene: 80
- liveness: 0
- freshness: 85
- provenance: 45
- drivers: +website -unreachable(4 failures) ~updated-56d-ago -no-repository
- Derived from observable signals (official registry feed and our own credential-free probes); no code audit performed.

## Quality 79/100 (good)

### protocol: 75 (weight 25)

- warn `protocol.modern`: newest supported version is 2025-03-26; 2026-07-28 not supported, older versions are deprecated until 2027-07-28
- n/a `protocol.stateless`: only applies to 2026-07-28 servers
- pass `protocol.transport`: streamable HTTP
- n/a `protocol.list_ttl`: only applies to 2026-07-28 servers

### authorization: n/a (weight 15)

- n/a `auth.prm`, `auth.as_metadata`, `auth.cimd`: no remote uses OAuth
- n/a `auth.secret_in_url`: no templated URL

### tool hygiene: 71 (weight 30)

- pass `tools.descriptions`: every tool has a description
- pass `tools.description_length`: descriptions are concise
- pass `tools.schemas`: every tool has an object input schema
- fail `tools.annotations`: no tool declares readOnlyHint or destructiveHint, so clients cannot tell safe calls from risky ones
- fail `tools.directory_hints`: no tool declares all four of readOnlyHint, destructiveHint, idempotentHint and openWorldHint; missing: compare_this_house (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); check_territory (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); compare_plans (readOnlyHint, destructiveHint, idempotentHint, openWorldHint); …
- pass `tools.token_cost`: about 520 tokens to load every tool
- pass `tools.api_dump`: tools are not a one-to-one API dump

### stability: 100 (weight 15)

- pass `stability.changes`: no tool changes in 30 days
- pass `stability.rug_pull`: no tool changed its meaning under the same name

### dependencies: n/a (weight 15)

- n/a `deps.known_vulns`, `deps.mcp_sdk_version`, `deps.resolvable`: no npm or PyPI package

- tools: 4, about 520 tokens to load them all
- tool set hash: c74d21d39cb00ef78bcf338236c09145
- badge: [![protogrid quality](https://protogrid.dev/badge/io.github.apollowinner/billtruth.svg)](https://protogrid.dev/servers/io.github.apollowinner/billtruth)
- Checks run on what our credential-free, read-only probes observe; tools are never called and no code audit is performed.

### Tool changes

_No tool definition changes recorded._

## Remotes

- https://billtruth.co/api/v1/mcp (streamable-http, auth none, reachable false, uptime30d 0.9433962)

## Packages

_none_

## Tools (4)

- `check_territory`: Whether a zip is in the deregulated Texas market, and which TDU serves it.
- `compare_plans`: Rank certified Texas electricity plans for a zip by real twelve-month cost at a monthly kWh average. Returns verified_as_of with every number.
- `compare_this_house`: Rank certified Texas electricity plans for a street address using a twelve-month usage profile for that meter. Prefer this over compare_plans when the user has an address. The profile is an estimate for the premise, not Smart Meter Texas interval reads. If the meter is found but has no usage history, ranks against a modeled Texas seasonal estimate at 1,000 kWh/month and says so. Never store or repeat the street. Returns verified_as_of with every number.
- `explain_plan`: The receipt for one plan at a zip and usage: monthly line items, credits earned or missed, gotchas. Identify the plan by id, slug, or name.