Haven Energy MCP server for AI agents
Let Claude, ChatGPT or your own agent read Haven Energy: 3 typed functions through one MCP server. No Haven Energy API key needed.
- Site
- havenenergy.com
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Haven Energy alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/havenenergyOne MCP server for Haven Energy and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
getPricingProgramsReturns every active battery incentive/pricing program Haven currently prices against.Arguments
None.
Returns
HavenPricingProgramsResultinterface HavenPricingTier { batteryModel: string; // e.g. "TESLA_POWERWALL_3" quantity: number; baseMonthlyPayment: number; basePrepaidPayment: number; installationCost: number; billSavings: string; // e.g. "$300-$600" } interface HavenPricingProgram { id: string; label: string; // e.g. "PG&E Permanent Battery Storage Rebate" offerType: string; pricingType: string; states: string[]; utilities: string[]; dwellingsAllowed: string[]; requiresIncomeOrMedical: boolean; requiresHomeOwnership: boolean; tiers: HavenPricingTier[]; } interface HavenPricingProgramsResult { programs: HavenPricingProgram[] }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/havenenergy/getPricingProgramsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.havenenergy.getPricingPrograms();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.havenenergy.getPricingPrograms())curl -X POST https://api.bowmark.ai/v1/sites/havenenergy/getPricingPrograms \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.havenenergy.getPricingPrograms();getPropertyDetailsGiven a US home address, returns the property attributes Haven's own /quote flow computes before pricing a battery: home-size band, county…Arguments
Name Type Required addressstringYes Returns
HavenPropertyDetails// Haven Energy's OWN shapes, not a capability contract. interface HavenPropertyDetails { homeSize: string | null; // e.g. "SIZE_1500_2499" livingSquareFeet: number | null; latitude: number | null; longitude: number | null; county: string | null; highFireThreatZone: string | null; isInEnergyCommunity: boolean | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/havenenergy/getPropertyDetailsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.havenenergy.getPropertyDetails("1600 Amphitheatre Parkway, Mountain View, CA 94043");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.havenenergy.getPropertyDetails("1600 Amphitheatre Parkway, Mountain View, CA 94043"))curl -X POST https://api.bowmark.ai/v1/sites/havenenergy/getPropertyDetails \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"address":"1600 Amphitheatre Parkway, Mountain View, CA 94043"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.havenenergy.getPropertyDetails("1600 Amphitheatre Parkway, Mountain View, CA 94043");listPricingProgramsGiven { address }, returns the property attributes plus ONLY the programs that address's state qualifies for.Arguments
Name Type Required addressstringYes Returns
HavenListPricingProgramsResult// Haven Energy's OWN shapes, not a capability contract. interface HavenPropertyDetails { homeSize: string | null; // e.g. "SIZE_1500_2499" livingSquareFeet: number | null; latitude: number | null; longitude: number | null; county: string | null; highFireThreatZone: string | null; isInEnergyCommunity: boolean | null; } interface HavenPricingTier { batteryModel: string; // e.g. "TESLA_POWERWALL_3" quantity: number; baseMonthlyPayment: number; basePrepaidPayment: number; installationCost: number; billSavings: string; // e.g. "$300-$600" } interface HavenPricingProgram { id: string; label: string; // e.g. "PG&E Permanent Battery Storage Rebate" offerType: string; pricingType: string; states: string[]; utilities: string[]; dwellingsAllowed: string[]; requiresIncomeOrMedical: boolean; requiresHomeOwnership: boolean; tiers: HavenPricingTier[]; } interface HavenListPricingProgramsResult { property: HavenPropertyDetails; state: string | null; // read off the caller's own address, e.g. "CA" programs: HavenPricingProgram[]; // filtered to what `state` qualifies for }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/havenenergy/listPricingProgramsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.havenenergy.listPricingPrograms({ address: "1600 Amphitheatre Parkway, Mountain View, CA 94043" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.havenenergy.listPricingPrograms({ "address": "1600 Amphitheatre Parkway, Mountain View, CA 94043" }))curl -X POST https://api.bowmark.ai/v1/sites/havenenergy/listPricingPrograms \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"arg0":{"address":"1600 Amphitheatre Parkway, Mountain View, CA 94043"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.havenenergy.listPricingPrograms({ address: "1600 Amphitheatre Parkway, Mountain View, CA 94043" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/havenenergy/<function> - OpenAPI
/v1/sites/havenenergy/openapi.json