Alpha Ess Solar Energy System Server MCP Server

A Model Context Protocol (MCP) server that provides access to Alpha ESS solar inverter and battery system data through the official Alpha ESS Open API.

Local serverstdio

What is the Alpha Ess Solar Energy System Server MCP Server?

Alpha Ess Solar Energy System Server source profile. From the maintainer documentation: “A Model Context Protocol (MCP) server that provides access to Alpha ESS solar inverter and battery system data through the official Alpha ESS Open API.”

Local setup

The project provides a local client configuration using uv. Follow the repository’s build and installation steps before copying it, and replace example paths with the paths on your own computer.

Configuration values

The example declares ALPHA_ESS_APP_ID, ALPHA_ESS_APP_SECRET. Secret-looking values have been replaced with placeholders. Required and optional labels are shown only when the documentation states them.

Source

Project documentation · Repository · Discovery listing. This profile records the public documentation checked on 2026-10-08.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
authenticate_alphaess	) - Validate API credentials
get_ess_list	) - List all registered Alpha ESS systems
get_alpha_ess_data	) - Get comprehensive energy statistics for all systems
get_last_power_data	serial?) - Get real-time power data snapshot
get_one_day_power_data	query_date, serial?) - Get detailed power data for a specific date
get_one_date_energy_data	query_date, serial?) - Get energy summary for a specific date
get_charge_config	serial?) - Get current battery charging configuration
get_discharge_config	serial?) - Get current battery discharge configuration
set_battery_charge	enabled, dp1_start, dp1_end, dp2_start, dp2_end, charge_cutoff_soc, serial?) - Configure battery charging schedule
set_battery_discharge	enabled, dp1_start, dp1_end, dp2_start, dp2_end, discharge_cutoff_soc, serial?) - Configure battery discharge schedule

How to install the Alpha Ess Solar Energy System Server MCP Server

{
  "mcpServers": {
    "alpha-ess": {
      "command": "uv",
      "args": [
        "run",
        "python",
        "/path/to/alpha-ess-mcp-server/main.py"
      ],
      "env": {
        "ALPHA_ESS_APP_ID": "your_app_id_here",
        "ALPHA_ESS_APP_SECRET": "YOUR_ALPHA_ESS_APP_SECRET"
      }
    }
  }
}

From the project documentation. Replace placeholders and example paths before connecting.

Configuration

Variable	Description	Required
ALPHA_ESS_APP_ID	Declared in the maintainer’s client configuration.	Check documentation
ALPHA_ESS_APP_SECRET	Declared in the maintainer’s client configuration.	Check documentation