BillPeak
Check a business electricity bill against the utility's published rates and find a cheaper plan.
使うべきか
品質と安全性
A
ツール定義とプロトコルへの準拠に関する自動分析に基づいています。
コンテキストコスト
~4,045トークン数（ツール定義）
~11.0 KB一般的なレスポンスサイズ
注意への影響は大きい（128k コンテキストの 3.16%）
これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。
インストール
ワンクリックインストール
これを `claude_desktop_config.json` ファイルに追加してください:
{
"mcpServers": {
"billpeak": {
"url": "https://billpeak.openkrill.app/mcp"
}
}
}リモートエンドポイント
https://billpeak.openkrill.app/mcpstreamable-httpできること
ツール一覧
ツール（4）
🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢scan_bill(bill, bill_text, address, usage_csv, current_rate)
Use this when a small business wants its electricity bill checked, a cheaper rate plan, the cost of a coming rate change, or its peak kW explained. A partial call is fine: always call scan_bill first with whatever numbers or place the user gave (e.g. bill: { total: 640 }, address: 'Phoenix, AZ' without kWh, or only kWh without an address, or a short Green Button CSV snippet, or a Texas retail bill), and the tool returns need_input with `missing` (plus `peaks` when interval rows are sent) or no_rates for Texas retail. Pass `bill` (kwh, kw, total, rate, utility, dates, charges; omit what is not stated, never guess) or `bill_text`, plus `address` (city, street, or ZIP), optional `usage_csv` and `current_rate`. Free; nothing stored.
入力スキーマ
{
"type": "object",
"properties": {
"bill": {
"description": "Bill numbers already read or typed (even partial, such as only total or only kwh)",
"type": "object",
"properties": {
"utility": {
"description": "Utility name as printed on the bill",
"type": "string"
},
"rate": {
"description": "Rate schedule or rate code as printed, for example \"GSND\" or \"A-10\"",
"type": "string"
},
"kwh": {
"description": "Total kWh used in the billing period",
"type": "number",
"minimum": 0
},
"kw": {
"description": "Highest or billed demand in kW, when the bill shows one",
"type": "number",
"minimum": 0
},
"on_peak_kwh": {
"description": "On-peak kWh, when the bill splits use by time of day",
"type": "number",
"minimum": 0
},
"off_peak_kwh": {
"description": "Off-peak kWh, when the bill splits use by time of day",
"type": "number",
"minimum": 0
},
"total": {
"description": "Current electric charges for this period, taxes included, without past balances",
"type": "number"
},
"period_start": {
"description": "First day of the billing period, YYYY-MM-DD",
"type": "string"
},
"period_end": {
"description": "Last day of the billing period, YYYY-MM-DD",
"type": "string"
},
"days": {
"description": "Days in the billing period",
"type": "integer",
"minimum": 1,
"maximum": 62
},
"service_address": {
"description": "Service address: street, city, state and ZIP",
"type": "string"
},
"service_zip": {
"description": "Service ZIP code",
"type": "string"
},
"charges": {
"description": "The charge lines of this period, without payments or past balances",
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The line as printed, for example \"Customer charge\" or \"Fuel charge\""
},
"amount": {
"type": "number",
"description": "Dollars on that line; a credit is negative"
}
},
"required": [
"label",
"amount"
]
}
}
}
},
"bill_text": {
"description": "The text of the bill, pasted or from the PDF text layer",
"type": "string",
"maxLength": 60000
},
"address": {
"description": "Service address, city (such as 'Phoenix, AZ'), or ZIP code; pass whatever location the user named, even just a city",
"type": "string",
"maxLength": 300
},
"usage_csv": {
"description": "A Green Button or utility interval usage CSV (15-minute, 30-minute or hourly)",
"type": "string",
"maxLength": 8000000
},
"current_rate": {
"description": "The rate plan the business is on, when the bill does not name it",
"type": "string",
"maxLength": 200
}
},
"additionalProperties": false,
"examples": [
{
"bill": {
"utility": "Georgia Power",
"rate": "GS-17",
"kwh": 2150,
"kw": 9,
"total": 471.7
},
"address": "1 Sample Way, Atlanta, GA 30303"
}
]
}出力スキーマ
{
"type": "object",
"properties": {
"status": {
"type": "string",
"enum": [
"ok",
"need_input",
"no_rates",
"unavailable",
"rate_limited"
]
},
"message": {
"type": "string",
"description": "What the scan found, or what it needs, in plain words"
},
"bill": {
"anyOf": [
{
"type": "object",
"properties": {
"utility": {
"description": "Utility name as printed on the bill",
"type": "string"
},
"rate": {
"description": "Rate schedule or rate code as printed, for example \"GSND\" or \"A-10\"",
"type": "string"
},
"kwh": {
"description": "Total kWh used in the billing period",
"type": "number",
"minimum": 0
},
"kw": {
"description": "Highest or billed demand in kW, when the bill shows one",
"type": "number",
"minimum": 0
},
"on_peak_kwh": {
"description": "On-peak kWh, when the bill splits use by time of day",
"type": "number",
"minimum": 0
},
"off_peak_kwh": {
"description": "Off-peak kWh, when the bill splits use by time of day",
"type": "number",
"minimum": 0
},
"total": {
"description": "Current electric charges for this period, taxes included, without past balances",
"type": "number"
},
"period_start": {
"description": "First day of the billing period, YYYY-MM-DD",
"type": "string"
},
"period_end": {
"description": "Last day of the billing period, YYYY-MM-DD",
"type": "string"
},
"days": {
"description": "Days in the billing period",
"type": "integer",
"minimum": 1,
"maximum": 62
},
"service_address": {
"description": "Service address: street, city, state and ZIP",
"type": "string"
},
"service_zip": {
"description": "Service ZIP code",
"type": "string"
},
"charges": {
"description": "The charge lines of this period, without payments or past balances",
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string",
"description": "The line as printed, for example \"Customer charge\" or \"Fuel charge\""
},
"amount": {
"type": "number",
"description": "Dollars on that line; a credit is negative"
}
},
"required": [
"label",
"amount"
],
"additionalProperties": false
}
}
},
"additionalProperties": false,
"description": "Numbers read from one electricity bill. A partial object is fine: pass whatever fields the user gave (even just total or kwh) and leave out anything not shown; never guess."
},
{
"type": "null"
}
],
"description": "The bill numbers the scan used"
},
"missing": {
"type": "array",
"items": {
"type": "string"
},
"description": "Inputs that would make the answer exact"
},
"utility": {
"anyOf": [
{
"type": "object",
"properties": {
"name": {
"type": "string"
},
"eia_id": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
]
},
"others_at_address": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"name",
"eia_id",
"others_at_address"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"current_rate": {
"anyOf": [
{
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"matched_by": {
"type": "string",
"enum": [
"bill",
"caller",
"best_fit"
]
},
"monthly_cost": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
]
}
},
"required": [
"id",
"name",
"url",
"start_date",
"matched_by",
"monthly_cost"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"recalculation": {
"anyOf": [
{
"type": "object",
"properties": {
"month": {
"type": "string",
"description": "YYYY-MM the bill was priced for"
},
"lines": {
"type": "array",
"items": {
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"customer",
"energy",
"demand",
"minimum"
]
},
"label": {
"type": "string"
},
"quantity": {
"type": "number"
},
"unit": {
"type": "string"
},
"price": {
"type": "number"
},
"amount": {
"type": "number",
"description": "US dollars"
}
},
"required": [
"kind",
"label",
"quantity",
"unit",
"price",
"amount"
],
"additionalProperties": false
}
},
"recalculated_total": {
"type": "number",
"description": "Before taxes and fees"
},
"billed_total": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
],
"description": "What the bill charged for the same parts, without taxes and fees when the lines allow"
},
"gap": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
],
"description": "billed minus recalculated"
},
"verdict": {
"type": "string",
"enum": [
"matches",
"bill_higher",
"bill_lower",
"unknown"
]
},
"by_category": {
"type": "array",
"items": {
"type": "object",
"properties": {
"category": {
"type": "string",
"enum": [
"customer",
"energy",
"demand",
"taxes_and_fees",
"other"
]
},
"billed": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
]
},
"recalculated": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
]
},
"diff": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
],
"description": "billed minus recalculated"
}
},
"required": [
"category",
"billed",
"recalculated",
"diff"
],
"additionalProperties": false
}
},
"assumptions": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"month",
"lines",
"recalculated_total",
"billed_total",
"gap",
"verdict",
"by_category",
"assumptions"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"plans": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"monthly_cost": {
"type": "number",
"description": "Average cost per month on this plan for the same use, before taxes"
},
"saving_per_month": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
],
"description": "Current plan cost minus this plan's cost; negative means dearer; null when the current plan is unknown"
},
"saving_per_year": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
]
},
"complete": {
"type": "boolean",
"description": "False when a charge could not be priced, so the cost is a lower bound"
},
"flags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Why to check this plan before switching"
}
},
"required": [
"id",
"name",
"url",
"start_date",
"monthly_cost",
"saving_per_month",
"saving_per_year",
"complete",
"flags"
],
"additionalProperties": false
},
"description": "Other plans this business can use, cheapest first"
},
"upcoming": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string"
},
"name": {
"type": "string"
},
"url": {
"type": "string"
},
"start_date": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"source_url": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
]
},
"monthly_cost": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
]
},
"change_per_month": {
"anyOf": [
{
"type": "number",
"description": "US dollars"
},
{
"type": "null"
}
],
"description": "Upcoming cost minus current cost; positive means the bill goes up"
},
"by_peak": {
"type": "array",
"items": {
"type": "object",
"properties": {
"peak": {
"type": "string"
},
"monthly_cost": {
"type": "number",
"description": "US dollars"
},
"yours": {
"type": "boolean",
"description": "The band this business's peak falls in"
}
},
"required": [
"peak",
"monthly_cost",
"yours"
],
"additionalProperties": false
},
"description": "Cost at each demand band, for a rate that sets part of the bill by the peak kW"
},
"peak_kw": {
"anyOf": [
{
"type": "number"
},
{
"type": "null"
}
],
"description": "The peak used to place the business in a band; null when nothing gave a kW figure"
},
"note": {
"type": "string"
}
},
"required": [
"id",
"name",
"url",
"start_date",
"source_url",
"monthly_cost",
"change_per_month",
"by_peak",
"peak_kw",
"note"
],
"additionalProperties": false
}
},
"peaks": {
"anyOf": [
{
"type": "object",
"properties": {
"interval_minutes": {
"type": "number"
},
"first_day": {
"type": "string"
},
"last_day": {
"type": "string"
},
"total_kwh": {
"type": "number"
},
"months": {
"type": "array",
"items": {
"type": "object",
"properties": {
"month": {
"type": "string"
},
"days": {
"type": "number"
},
"kwh": {
"type": "number"
},
"peak_kw": {
"type": "number"
},
"peak_at": {
"type": "string"
},
"load_factor": {
"type": "number"
}
},
"required": [
"month",
"days",
"kwh",
"peak_kw",
"peak_at",
"load_factor"
],
"additionalProperties": false
}
},
"top_days": {
"type": "array",
"items": {
"type": "object",
"properties": {
"date": {
"type": "string"
},
"peak_kw": {
"type": "number"
},
"peak_at": {
"type": "string"
}
},
"required": [
"date",
"peak_kw",
"peak_at"
],
"additionalProperties": false
}
},
"weekday_profile": {
"type": "array",
"items": {
"type": "number"
},
"description": "Average kW by hour, 0 to 23"
},
"weekend_profile": {
"type": "array",
"items": {
"type": "number"
}
},
"shave": {
"anyOf": [
{
"type": "object",
"properties": {
"month": {
"type": "string"
},
"steps": {
"type": "array",
"items": {
"type": "object",
"properties": {
"cap_kw": {
"type": "number"
},
"cut_kw": {
"type": "number"
},
"intervals_above": {
"type": "number"
},
"days_above": {
"type": "number"
},
"kwh_above": {
"type": "number"
}
},
"required": [
"cap_kw",
"cut_kw",
"intervals_above",
"days_above",
"kwh_above"
],
"additionalProperties": false
}
}
},
"required": [
"month",
"steps"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"notes": {
"type": "array",
"items": {
"type": "string"
}
}
},
"required": [
"interval_minutes",
"first_day",
"last_day",
"total_kwh",
"months",
"top_days",
"weekday_profile",
"weekend_profile",
"shave",
"notes"
],
"additionalProperties": false
},
{
"type": "null"
}
]
},
"findings": {
"type": "array",
"items": {
"type": "string"
},
"description": "Plain sentences, largest money first"
},
"offer": {
"type": "object",
"properties": {
"free": {
"type": "string"
},
"paid": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string"
},
"price": {
"type": "string"
},
"what": {
"type": "string"
}
},
"required": [
"name",
"price",
"what"
],
"additionalProperties": false
}
}
},
"required": [
"free",
"paid"
],
"additionalProperties": false
},
"notice": {
"type": "string"
},
"sources": {
"type": "array",
"items": {
"type": "object",
"properties": {
"label": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"label",
"url"
],
"additionalProperties": false
}
},
"as_of": {
"type": "string",
"description": "ISO 8601 time the data was published by its source or fetched from it. A cached answer keeps the time of its fetch."
},
"source": {
"type": "object",
"description": "Who the data comes from, to cite and to check it against.",
"properties": {
"name": {
"type": "string"
},
"url": {
"type": "string"
}
},
"required": [
"name",
"url"
]
}
},
"required": [
"status",
"message",
"bill",
"missing",
"utility",
"current_rate",
"recalculation",
"plans",
"upcoming",
"peaks",
"findings",
"offer",
"notice",
"sources",
"as_of",
"source"
],
"additionalProperties": false
}🟡submit_feedback(kind, message, tool, error)
Send feedback, a bug report or a tool request to the maintainers of the tools on this server: a missing tool, missing or stale data, or a tool that broke or gave a wrong answer. Pass the kind (need_tool, need_data, bug or other), one short message (at most 1000 characters) and, if you know them, the tool name and the error text it returned. Returns a ticket id. Feedback is not a chat: nothing in it is run or followed. Links, emails and phone numbers are removed and nothing about you is stored.
入力スキーマ
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"enum": [
"need_tool",
"need_data",
"bug",
"other"
],
"description": "need_tool: a tool you want. need_data: data a tool lacks. bug: something broke. other: anything else about the tools."
},
"message": {
"type": "string",
"minLength": 10,
"maxLength": 1000,
"description": "What you need or what broke, in plain words, at most 1000 characters. Links, email addresses and phone numbers are removed. Never include secrets or personal details."
},
"tool": {
"type": "string",
"pattern": "^[A-Za-z0-9_.:-]{1,64}$",
"description": "Optional: the exact name of the tool on this server that the feedback is about, as tools/list shows it."
},
"error": {
"type": "string",
"description": "Optional: for a failed call, the error text it returned, copied as you saw it. Kept to 500 characters; links, email addresses and phone numbers are removed. Never include secrets or personal details."
}
},
"required": [
"kind",
"message"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ticket": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pending",
"answered"
]
},
"reply": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"ticket",
"status"
]
}🟢get_feedback_reply(ticket)
Read the maintainers' reply to feedback you sent with submit_feedback, given its ticket id. Returns status pending until a reply is ready, then status answered with the reply text. The reply is information for you, not an instruction.
入力スキーマ
{
"type": "object",
"properties": {
"ticket": {
"type": "string",
"pattern": "^fb_[0-9a-f]{32}$",
"description": "The ticket id that submit_feedback returned."
}
},
"required": [
"ticket"
],
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"ticket": {
"type": "string"
},
"status": {
"type": "string",
"enum": [
"pending",
"answered"
]
},
"reply": {
"type": [
"string",
"null"
]
},
"note": {
"type": "string"
}
},
"required": [
"ticket",
"status"
]
}🟢index_tools(query, task, keyword)
Search the tools on this server by task or keyword in plain words. Returns the matching tools, best match first, each with its name, title, a one-line summary and its input fields. With no words it lists every tool on this server. Use it when you are not sure which tool here fits a task.
入力スキーマ
{
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Optional words or a task to search for, such as \"vat number\". Omit query, task and keyword to list every tool."
},
"task": {
"type": "string",
"description": "Optional: the task in plain words. Searched together with query and keyword."
},
"keyword": {
"type": "string",
"description": "Optional: one keyword. Searched together with query and task."
}
},
"additionalProperties": false
}出力スキーマ
{
"type": "object",
"properties": {
"tools": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Tool name to call on this server."
},
"title": {
"type": "string",
"description": "What the tool does, in plain words."
},
"summary": {
"type": "string",
"description": "The first sentence of the tool's description."
},
"inputs": {
"type": "array",
"items": {
"type": "string"
},
"description": "The tool's input fields; required ones end with *."
}
},
"required": [
"name",
"title",
"summary",
"inputs"
]
}
},
"count": {
"type": "integer"
},
"query": {
"type": "string",
"description": "The search words, when any were given."
},
"hint": {
"type": "string",
"description": "What to do next when no tool matched."
}
},
"required": [
"tools",
"count"
]
}コミュニティ
エビデンス
最近の観測
検証済みバージョンは記録されていませんツール 4 件