Alpha Ess Solar Energy System Server

Name: Alpha Ess Solar Energy System Server
Author: michaelkrasa

@michaelkrasa

About Alpha Ess Solar Energy System Server

Provide seamless access to Alpha ESS solar inverter and battery system data for AI assistants. Monitor real-time and historical energy statistics, configure battery charge and discharge schedules, and analyze energy trends with structured, enhanced data responses. Enable intellig

#alphaess #solar #inverter #battery #battery-storage

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "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_app_secret_here"
      }
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is Alpha Ess Solar Energy System Server?

An MCP server that provides access to Alpha ESS solar inverter and battery system data through the official Alpha ESS Open API. It is designed for developers and system administrators who want to monitor and control their Alpha ESS energy storage systems programmatically.

How to use Alpha Ess Solar Energy System Server?

Install with uv sync, create a .env file containing your Alpha ESS API credentials (AppID and AppSecret), then add the server to your MCP client configuration (e.g., Claude Desktop) using uv run python /path/to/main.py. Once configured, you can call the provided tools to retrieve live and historical energy data, list systems, and modify battery charge/discharge settings.

Key features of Alpha Ess Solar Energy System Server

Authenticate with Alpha ESS Open API credentials
List all registered Alpha ESS systems
Retrieve comprehensive energy statistics for all systems
Get real-time and historical power data snapshots
Configure battery charging and discharge schedules

Use cases of Alpha Ess Solar Energy System Server

Monitor real-time solar production and battery status via an AI assistant
Automate battery charging/discharge schedules based on time-of-use tariffs
Retrieve daily or date-specific energy summaries for reporting
Validate API credentials and check system connectivity without a web interface

FAQ from Alpha Ess Solar Energy System Server

How do I obtain Alpha ESS API credentials?

Visit https://open.alphaess.com/, create a developer account, add your inverter system using the Serial Number and CheckCode, then obtain your AppID and AppSecret.

What if I have multiple Alpha ESS systems?

The serial parameter is optional on most tools. If omitted and only one system is registered, the server automatically uses it. For multiple systems, you must provide the serial number.

What time formats are required for battery scheduling?

Period start/end times (e.g., dp1_start, dp1_end) must be in HH:MM format where minutes are restricted to :00, :15, :30, or :45. The charge/discharge cutoff state of charge is an integer percentage from 0 to 100.

What runtime dependencies does this server require?

The server runs on Python with the uv package manager. It uses the Alpha ESS Open API, which requires a valid AppID and AppSecret. No additional hardware or local data storage is needed.

How does authentication work?

The server authenticates via the Alpha ESS Open API using the provided AppID and AppSecret stored in a .env file. Credentials are validated by calling the authenticate_alphaess() tool.