Use with AI assistants

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.