Cleantech Content solar, battery and energy tools

Use this when a user asks what a UK domestic electricity or gas tariff costs, wants to compare suppliers, or needs unit rates (p/kWh), standing charges (p/day), off-peak windows, exit fees or export (SEG) rates. Covers standard variable, fixed, time-of-use, Economy 7, tracker, Agile, heat pump and export tariffs from Octopus Energy and other GB suppliers. Filter by region (GSP letter), tariff type, supplier slug or fuel. Every row carries source_url and verified_at; quote them. Not for public EV charging prices (use get_ev_charging_prices) or the Ofgem cap (use get_ofgem_price_cap).

{
  "type": "object",
  "properties": {
    "region": {
      "description": "GB electricity region: GSP group letter A to P (no I or O), or GB for the national average. Omit to get every region.",
      "type": "string",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "E",
        "F",
        "G",
        "H",
        "J",
        "K",
        "L",
        "M",
        "N",
        "P",
        "GB"
      ]
    },
    "type": {
      "description": "Tariff type. ev_tou = cheap overnight EV tariffs; smart_tou = other time-of-use; export = SEG export tariffs.",
      "type": "string",
      "enum": [
        "standard_variable",
        "fixed",
        "ev_tou",
        "smart_tou",
        "economy_7",
        "tracker",
        "agile",
        "heat_pump",
        "export",
        "ev_addon",
        "prepayment"
      ]
    },
    "supplier": {
      "description": "Supplier slug, e.g. octopus-energy, edf, eon-next, british-gas, ovo-energy, scottishpower.",
      "type": "string"
    },
    "fuel": {
      "type": "string",
      "enum": [
        "electricity",
        "gas",
        "dual"
      ]
    },
    "payment_method": {
      "type": "string",
      "enum": [
        "direct_debit",
        "standard_credit",
        "prepayment"
      ]
    },
    "include_unverified": {
      "description": "Also return rows we have not verified against a primary source. Default false.",
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when a user with an electric vehicle asks which home electricity tariff is cheapest for charging, what the overnight rate and window are, or whether a tariff needs a smart meter, a compatible charger or a specific car. Returns EV time-of-use tariffs (cheap whole-home overnight window) and EV add-ons (credits for smart-scheduled charging on a standard tariff). Filter by region. Every row carries source_url and verified_at. For public rapid charger prices use get_ev_charging_prices instead.

{
  "type": "object",
  "properties": {
    "region": {
      "description": "GB electricity region: GSP group letter A to P (no I or O), or GB for the national average. Omit to get every region.",
      "type": "string",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "E",
        "F",
        "G",
        "H",
        "J",
        "K",
        "L",
        "M",
        "N",
        "P",
        "GB"
      ]
    },
    "supplier": {
      "type": "string"
    },
    "include_unverified": {
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when a user asks what the current UK energy price cap is, the default tariff unit rate or standing charge in their region, or how the cap compares between direct debit, standard credit and prepayment. Returns Ofgem's default tariff cap per region, fuel and payment method for the period in force today, or for a given date via period (the next quarter is usually on file as soon as Ofgem announces it; the response note lists every period held). Values are pence per kWh and pence per day including VAT, with the Ofgem source_url and verified_at. Not for individual supplier tariffs (use get_uk_energy_tariffs).

{
  "type": "object",
  "properties": {
    "region": {
      "description": "GB electricity region: GSP group letter A to P (no I or O), or GB for the national average. Omit to get every region.",
      "type": "string",
      "enum": [
        "A",
        "B",
        "C",
        "D",
        "E",
        "F",
        "G",
        "H",
        "J",
        "K",
        "L",
        "M",
        "N",
        "P",
        "GB"
      ]
    },
    "payment_method": {
      "type": "string",
      "enum": [
        "direct_debit",
        "standard_credit",
        "prepayment"
      ]
    },
    "fuel": {
      "type": "string",
      "enum": [
        "electricity",
        "gas"
      ]
    },
    "period": {
      "description": "A date inside the cap period you want, YYYY-MM-DD. Default today.",
      "type": "string",
      "pattern": "^\\d{4}-\\d{2}-\\d{2}$"
    },
    "include_history": {
      "description": "Return all stored cap periods, not just the one in force.",
      "type": "boolean"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when a user asks how much it costs to charge an electric car at a public charger in the UK, what a named network (InstaVolt, Gridserve, BP Pulse, Tesla, Ionity, Osprey, Shell Recharge, Pod Point and others) charges per kWh, or what subscription, connection and idle fees apply. Filter by network slug, power band (ac_slow_7kw, ac_fast_22kw, dc_rapid_50kw, dc_ultra_150kw_plus) and pricing basis (contactless_payg, app_payg, member, subscription). Prices are pence per kWh including VAT with source_url and verified_at. For a cost comparison of one charging session use compare_ev_charging_cost.

{
  "type": "object",
  "properties": {
    "network": {
      "description": "Network slug, e.g. instavolt, gridserve, bp-pulse, tesla-supercharger, ionity, osprey, shell-recharge, pod-point.",
      "type": "string"
    },
    "power_band": {
      "type": "string",
      "enum": [
        "ac_slow_7kw",
        "ac_fast_22kw",
        "dc_rapid_50kw",
        "dc_ultra_150kw_plus"
      ]
    },
    "basis": {
      "type": "string",
      "enum": [
        "contactless_payg",
        "app_payg",
        "member",
        "subscription"
      ]
    },
    "include_unverified": {
      "type": "boolean"
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 500
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when a user wants to know what a specific public charge would cost, e.g. "adding 40 kWh at a rapid charger", or which network is cheapest for a given session. Give the energy in kWh and the charger power band; optionally restrict to a pricing basis. Returns a cost table sorted cheapest first, with pence per kWh, connection fee, subscription fee, idle fee, and the session cost in GBP for each network and plan, each with source_url and verified_at.

{
  "type": "object",
  "properties": {
    "kwh": {
      "type": "number",
      "exclusiveMinimum": 0,
      "maximum": 500,
      "description": "Energy to add in kWh, e.g. 40."
    },
    "power_band": {
      "type": "string",
      "enum": [
        "ac_slow_7kw",
        "ac_fast_22kw",
        "dc_rapid_50kw",
        "dc_ultra_150kw_plus"
      ],
      "description": "Charger power band."
    },
    "basis": {
      "description": "Restrict to one pricing basis; omit to compare all.",
      "type": "string",
      "enum": [
        "contactless_payg",
        "app_payg",
        "member",
        "subscription"
      ]
    },
    "include_unverified": {
      "type": "boolean"
    }
  },
  "required": [
    "kwh",
    "power_band"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this before quoting figures when the user cares how current the data is, or when another tool returns an as_of date that looks old. Returns, per dataset (tariffs, tariff rates, price cap, charging networks, charging prices), the number of verified rows and the newest and oldest verified_at dates, the price cap period currently in force, and recent sync runs. Free to call and not counted against the free tier.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}