# Aivy Energy

> Aivy Energy is an open-source MCP server for energy and smart home. Ask an AI assistant about your home solar battery and let it set the energy mode. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** macOS, Linux, CLI, API
- **Website:** https://bridge.ivyenergy.com.au/developers
- **Repository:** https://github.com/ivyenergy/aivy-mcp
- **MCP Registry name:** io.github.IVYEnergy/aivy-mcp
- **Categories:** energy and smart home
- **Listing updated:** 2026-11-14

## About

Built for home solar and battery systems in Australia, this server reaches Sungrow, Sigenergy, FoxESS, AlphaESS and SolaX hardware through the Aivy Developer API by Ivy Energy, with the same tools whatever the inverter. It also plans around Amber Electric prices, so you can ask when to sell tonight while keeping 20% in reserve, or why the battery charged at 3 am.

Control is deliberately limited. A forced mode set through the API is time-boxed and hands back to the previous mode when it ends, the state-of-charge floor and export limits cannot be overridden by any call, and read-only keys cannot change anything. Every call is logged against the key that made it. Keys can be restricted to chosen sites and revoked.

You can start without hardware: every key lists demo sites with replayed real data, and changes on them never reach a device. The server runs locally through `uvx aivy-mcp@latest`, and can create an account from the chat, storing the key in a file only you can read. The developer site lists Apache 2.0.

## Features

- **Battery status:** Shows what the battery is doing right now.
- **Amber price planning:** Reads upcoming prices and plans the best time to discharge.
- **Time-boxed control:** Forced modes expire and return the site to its earlier mode.
- **Alerts:** Creates alerts such as battery level dropping below a threshold.
- **Demo sites:** Try every tool on replayed data before owning hardware.
- **Scoped API keys:** Keys can be read-only, site-limited and revocable.

## Good for

- Check what a home battery is doing
- Plan when to sell stored energy at peak prices
- Charge the battery to a set level within a time window
- Find out why the battery charged overnight
- Get alerted when charge drops below 20%

## Install

### Claude Code (Terminal)

```sh
claude mcp add aivy-mcp --env AIVY_API_KEY='<AIVY_API_KEY>' -- uvx aivy-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "aivy-mcp": {
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ],
      "env": {
        "AIVY_API_KEY": "<AIVY_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "aivy-mcp": {
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ],
      "env": {
        "AIVY_API_KEY": "<AIVY_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "aivy-mcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ],
      "env": {
        "AIVY_API_KEY": "<AIVY_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "aivy-mcp": {
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ],
      "env": {
        "AIVY_API_KEY": "<AIVY_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "aivy-mcp": {
      "command": "uvx",
      "args": [
        "aivy-mcp"
      ],
      "env": {
        "AIVY_API_KEY": "<AIVY_API_KEY>"
      }
    }
  }
}
```

## Tools

- `get_status`: Shows what the battery is doing right now.
- `get_prices`: Returns upcoming Amber prices.
- `plan_best_price_discharge`: Plans when to sell while keeping a reserve.
- `set_energy_mode`: Sets a forced, time-boxed energy mode.
- `get_operations`: Explains past battery operations.
- `create_alert`: Creates an alert such as a low battery level.
- `list_vendors`: Lists supported inverter brands.
- `connect_site`: Connects a solar system.
- `get_agent_guide`: Returns the agent playbook.

## FAQ

### Which inverter brands work?

Sungrow, Sigenergy, FoxESS, AlphaESS and SolaX.

### Do I need an API key to start?

No. Without one, the assistant can register an account or sign in from the chat and store the key locally.

### Can the assistant damage my battery settings?

The site says forced modes are time-boxed and the state-of-charge floor and export limits cannot be overridden.

### Can I try it without a battery?

Yes. Every key also sees demo sites with replayed real data.

### Is Aivy Energy free?

Yes. Aivy Energy is open source, so you can use and self-host it for free.

### How do I add Aivy Energy to Claude Code?

Run this command in your terminal: claude mcp add aivy-mcp --env AIVY_API_KEY='<AIVY_API_KEY>' -- uvx aivy-mcp

### What are the best alternatives to Aivy Energy?

The closest alternatives to Aivy Energy are myIO, THRIVE Fleet Intelligence, Spark Pack, ElectricityFinder and (iS)NEPI - National Energy Performance Index.

## Alternatives

- [myIO](https://ai-powered.com/mcp/myio): myIO is an open-source MCP server for smart home.
- [THRIVE Fleet Intelligence](https://ai-powered.com/mcp/thrive-fleet-intelligence): THRIVE Fleet Intelligence is a free MCP server for energy and smart home.
- [Spark Pack](https://ai-powered.com/mcp/spark-pack): Spark Pack is a free MCP server for home services.
- [ElectricityFinder](https://ai-powered.com/mcp/electricityfinder): ElectricityFinder is a freemium MCP server for energy and smart home.
- [(iS)NEPI - National Energy Performance Index](https://ai-powered.com/mcp/is-nepi-national-energy-performance-index): (iS)NEPI - National Energy Performance Index is a paid MCP server for energy and smart home.
- [Barrio Grid](https://ai-powered.com/mcp/barrio-grid): Barrio Grid is a freemium MCP server for energy and smart home.
- [AgentDataAPI](https://ai-powered.com/mcp/agentdataapi): AgentDataAPI is a freemium MCP server for analytics and data.
- [StationSignals](https://ai-powered.com/mcp/stationsignals): StationSignals is a freemium MCP server for smart home.

---
Source: https://ai-powered.com/mcp/aivy-energy
