Skip to content
MCP server

Aivy Energy

Ask an AI assistant about your home solar battery and let it set the energy mode

Runs locallyStatus and history
Pricing
Open source
Platforms
macOS, Linux, CLI
Runs
Locally
Version
0.9.2
Listing updated
3 days ago

About Aivy Energy

Aivy Energy is an open-source MCP server for energy and smart home. It runs locally on your machine and is started by your AI client.

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.

Install

Run in a terminal

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

Add to claude_desktop_config.json

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

Add to ~/.cursor/mcp.json

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

Add to .vscode/mcp.json

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

Add to ~/.codeium/windsurf/mcp_config.json

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

Add to your client's MCP settings (most use this shape)

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

Configuration

  • AIVY_API_KEYPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
  • AIVY_API_URLAPI base URL. Default https://bridge.ivyenergy.com.au/v1

Tools this server provides (9)

Taken from the project documentation; the running server may differ.

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.

What it does

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%

Pricing

Open source

Apache 2.0 per the developer site

Prices change. Check bridge.ivyenergy.com.au before you buy.

Aivy Energy 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 to Aivy Energy

  1. myIO

    MCP server

    Ask Claude about and control a myIO smart home controller: heating, blinds, lighting

    Runs locally
    • 1 tool
    • Open source
    • Smart home
  2. Free no-key MCP server with UK fleet data: fuel prices, EV charging, company car tax

    • 15 tools
    • Remote
    • Free
    • Energy and smart home
  3. Spark Pack

    MCP server

    Free MCP tools for UK electricians: cable sizing, Part P, certificate checks and G98/G99

    • 7 tools
    • Remote
    • Free
    • Home services
  4. Rank Texas electricity plans by yearly cost at your own monthly usage

    • 3 tools
    • Remote
    • Freemium
    • Energy and smart home
  5. Barrio Grid

    MCP server

    Texas grid siting data: substations, ERCOT prices, queue, parcels, water and permits

    Not checked yet
    • 6 tools
    • Remote
    • Freemium
    • Energy and smart home