# Lunar Energy

**Canonical:** https://apis.io/providers/lunar-energy/  
**Website:** https://www.lunarenergy.com  
**APIs profiled:** 14

Lunar Energy is a Mountain View, California-based residential clean-energy company founded in August 2020 by former Tesla Energy executive Kunal Girotra. The company designs and manufactures the Lunar System — a modular home battery (15–30 kWh, 9.6 kW continuous / 15 kW peak), Lunar Inverter, Lunar Maximizers (module-level power optimizers), Lunar Bridge meter socket adapter, and Eaton AbleEdge smart-breaker integration — controlled by the Lunar App with Lunar AI optimization. Its Gridshare platform is a grid-edge DERMS (Distributed Energy Resource Management System) and virtual power plant engine that manages 130,000+ residential distributed energy resources representing 1.2 GWh of connected storage across multiple manufacturers and third-party operators. Gridshare powers utility demand response and VPP programs through flex groups, flex dispatches, prognoses, dynamic and periodical tariffs, and per-device remote operation-mode control. Lunar Energy is backed by SunPower and Sunrun partnerships; SoftBank Energy is a major investor. The Gridshare Partner API and Customer API are gated behind business onboarding — credentials are issued by Lunar Energy after contacting developers@gridshare.com.

## Kin Score — 54.1 / 100 (developing)

Scored 2026-08-20 under rubric 0.12.0. Trend: flat (+0.0 from 54.1).

| Facet | Score |
|---|---|
| Discoverability | 64.8 |
| Contract Quality | 57.7 |
| Governance | 45.5 |
| Contract Governance | 45.5 |
| Operational Transparency | 34.2 |
| Developer Ergonomics | 44.0 |
| Commercial Clarity | 47.4 |
| Access Clarity | 47.4 |

Regulatory layer — **Energy & Utilities**: 52.7 (matched via tags).

## Agent readiness — 29.1 (agent-aware)

| Dimension | Value |
|---|---|
| Spec Presence | yes |
| Agentic Access | derived |
| Reversibility Documented | no |
| MCP Server | no |
| Auth Clarity | yes |
| Idempotency | no |
| Error Semantics | no |
| OpenAPI Examples | no |
| Rate Limit Signal | documented |
| Event Surface Described | no |
| Agent Skills | no |
| Well Known Catalog | no |
| Consent Identity | no |
| Agent Card | no |
| Dry Run Mode | no |

## Access

Self-serve signup — onboarding: self-serve, pricing: unknown, trial: no (confidence: high).

## APIs (14)

- **Gridshare Remote MCP Server** — Gridshare publishes a remote Model Context Protocol (MCP) server that exposes the Customer API as MCP tools for AI agents. Authenticated with the same Cognito-issued bearer toke...
- **Lunar Energy Devices API** — List, get, and partially update customer devices
- **Lunar Energy Diff Requests API** — Request and commit differential adjustments to a prognosis
- **Lunar Energy Dynamic Tariffs API** — Manage dynamic time-series tariffs with 7-day pagination
- **Lunar Energy Flex Dispatches API** — Opt participants out of an active flex dispatch
- **Lunar Energy Flex Events API** — Schedule and update flex events for a flex group
- **Lunar Energy Flex Groups API** — Define and manage groups of DERs participating in flex programs
- **Lunar Energy Operation Mode API** — Read or change the Gridshare operation mode of a device
- **Lunar Energy Periodical Tariffs API** — Manage periodical (recurring) tariffs
- **Lunar Energy Plans API** — Read or set overlay plans for short-term device dispatch
- **Lunar Energy Prognoses API** — Forecasted aggregate power profiles for flex groups
- **Lunar Energy Sites API** — List sites and read site topology
- **Lunar Energy Telemetry API** — Time-bucketed per-sensor telemetry readings
- **Lunar Energy Visits API** — Record on-site visits for installation or service

## Agentic access (1)

- **Lunar Energy Agentic Access** — 54 operations · 23 acting · 1 human-in-the-loop

## Security (3)

- **Lunar Energy Authentication** — http/oauth2 · 2 schemes
- **Lunar Energy Domain Security** — TLSv1.3 · HSTS · DNSSEC · DMARC
- **Lunar Energy Trust Center** — SOC 2, ISO 27001

## Plans (1)

- **Lunar Energy Plans Pricing**

## Tags

Energy, Home Battery, Solar, Virtual Power Plant, DERMS, Distributed Energy Resources, Grid Services, Demand Response, Storage, Inverter, Smart Home, Energy Management, Tariffs, Telemetry, VPP, Flex Events

---

Profiled by [API Evangelist](https://apievangelist.com) and published on [APIs.io](https://apis.io/providers/lunar-energy/). Scores are computed from the provider's own public artifacts under a published rubric.