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.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Haven Energy

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/havenenergy
Every site

One 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/mcp
Set it up in your client

Both 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.

Read 3
  • getPricingProgramsReturns every active battery incentive/pricing program Haven currently prices against.

    Arguments

    None.

    Returns HavenPricingProgramsResult

    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 HavenPricingProgramsResult { programs: HavenPricingProgram[] }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/havenenergy/getPricingPrograms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/getPropertyDetails

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    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/listPricingPrograms

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.havenenergy.listPricingPrograms({
      address: "1600 Amphitheatre Parkway, Mountain View, CA 94043"
    });

Use it from code