# Use Home Battery Planner with AI assistants (MCP)

> Connect Claude Desktop, Cursor, or any MCP client to query your Home Battery Planner report by ID. Streamable HTTP endpoint and example prompts.

- Web page: https://homebattery.ie/mcp

---

Home Battery Planner exposes an MCP server so you can ask Claude, Cursor, or any MCP-capable assistant questions about your report directly in chat — no copy-pasting numbers needed.

Step 1 — Copy your Report ID

After uploading your CSV, open the **⋮ menu** in the top-right of your report and click **Copy Report ID**. Keep it handy — you'll paste it into your AI chat in a moment.

The ID is a random string like `b357514b-e59a-4fc8-825c-994dabf4d9ce`. It doesn't contain any personal information.

Step 2 — Connect your AI assistant

Claude Desktop

Open `~/Library/Application Support/Claude/claude_desktop_config.json` (create it if it doesn't exist) and add:

{
  "mcpServers": {
    "homebattery": {
      "command": "npx",
      "args": \[
        "-y",
        "mcp-remote",
        "https://mcp.homebattery.ie/mcp"
      \]
    }
  }
}

Restart Claude Desktop. You'll see **homebattery** appear in the tools list.

Cursor

Go to **Cursor → Settings → MCP** and add a new server:

-   Name: `homebattery`
-   URL: `https://mcp.homebattery.ie/mcp`

Other MCP clients

Any client that supports Streamable HTTP transport can connect using:

`https://mcp.homebattery.ie/mcp`

Step 3 — Start asking questions

Paste your Report ID and ask anything. Some examples:

-   My Report ID is <your-id>. What battery would you recommend for my usage?
-   I'm planning to buy an EV (15,000 km/year, 7.4 kW charger, night charging). How does that change my battery recommendation?
-   What percentage of my electricity could I self-consume with the recommended solar and battery setup?
-   If I add a heat pump replacing gas (12,000 kWh/year heating, COP 3.5), what size battery do I need?
-   Which tariff is cheapest if I charge my EV with 40 kWh between 02:00 and 06:00?

What the assistant can do

get\_report

Fetches your full consumption summary, solar simulation, and battery recommendation.

adjust\_report

Re-runs the analysis with an EV, heat pump, WFH days, or night-rate shifting applied.

get\_battery\_recommendation

Returns just the battery sizing if that's all you need.

list\_tariffs

Lists the Irish electricity tariffs available for cost comparison.

ev\_charge\_cost

Prices an EV home-charging session against a tariff, split across day/night/peak rates. No report needed.

Direct API access

Prefer to integrate without MCP? The EV charging cost calculator is also a plain REST endpoint. It's stateless — no report or upload needed — and prices a single charging session against one tariff, split across day/night/peak rates.

curl -X POST https://homebattery.ie/api/ev/charge-cost \\
  -H "Content-Type: application/json" \\
  -d '{"tariffId":"<id>","startHM":"02:00","endHM":"06:00","kwh":40}'

Get valid `tariffId` values from `GET https://homebattery.ie/api/tariffs`. Times are 24-hour `HH:MM`; overnight sessions that cross midnight are handled automatically.

Privacy

The MCP server acts as a thin bridge between your AI assistant and the Home Battery Planner API. Your MPRN is never passed through it — only the consumption summary and battery sizing data are returned.

Report IDs are long random strings. Anyone with your ID can read your report, so treat it like a link — don't share it publicly if you'd rather keep your usage data private.
