Aivy Energy
ivyenergy/aivy-mcp
Read and control your own home solar + battery: Sungrow, Sigenergy, FoxESS, AlphaESS, SolaX.
- GitHub stars
- 2
- tools
- 32
- auth
- Secret needed
- transport
- STDIO
- env vars
- 2
- last updated
- Nov 9, 2026
Tools
32 toolsPublic tool metadata for what this MCP can expose to an agent.
get_agent_guideThe playbook above
The playbook above
No parameter schema in public metadata yet.
whoamiWho the key is, read or control; says when there is no key yet
Who the key is, read or control; says when there is no key yet
No parameter schema in public metadata yet.
get_registration_termsCreate an Aivy account from the chat; the key is stored locally
Create an Aivy account from the chat; the key is stored locally
No parameter schema in public metadata yet.
register_accountCreate an Aivy account from the chat; the key is stored locally
Create an Aivy account from the chat; the key is stored locally
No parameter schema in public metadata yet.
verify_registrationCreate an Aivy account from the chat; the key is stored locally
Create an Aivy account from the chat; the key is stored locally
No parameter schema in public metadata yet.
sign_inCreate and store a key for an existing account (password used once)
Create and store a key for an existing account (password used once)
No parameter schema in public metadata yet.
list_sitesYour sites; ids look like sungrow:1445844
Your sites; ids look like sungrow:1445844
No parameter schema in public metadata yet.
get_siteCapacity, limits, timezone, mode, live SOC
Capacity, limits, timezone, mode, live SOC
No parameter schema in public metadata yet.
get_statusLive SOC and power flows
Live SOC and power flows
No parameter schema in public metadata yet.
get_curve5-minute or daily history
5-minute or daily history
No parameter schema in public metadata yet.
get_earningsA day's energy, priced at Amber's actual prices
A day's energy, priced at Amber's actual prices
No parameter schema in public metadata yet.
get_operationsWhat the platform did and why
What the platform did and why
No parameter schema in public metadata yet.
get_pricesAmber prices now and forecast
Amber prices now and forecast
No parameter schema in public metadata yet.
list_alertsAlert rules on a site and what fired
Alert rules on a site and what fired
No parameter schema in public metadata yet.
get_alert_eventsAlert rules on a site and what fired
Alert rules on a site and what fired
No parameter schema in public metadata yet.
create_alertThreshold alerts to inbox, push and email; never control the battery
Threshold alerts to inbox, push and email; never control the battery
No parameter schema in public metadata yet.
delete_alertThreshold alerts to inbox, push and email; never control the battery
Threshold alerts to inbox, push and email; never control the battery
No parameter schema in public metadata yet.
send_test_alert_emailOne test alert to the account's email
One test alert to the account's email
No parameter schema in public metadata yet.
list_vendorsSupported brands and what connecting one needs
Supported brands and what connecting one needs
No parameter schema in public metadata yet.
connect_siteLink the user's system (serial + NMI, system id, or an OAuth link to open)
Link the user's system (serial + NMI, system id, or an OAuth link to open)
No parameter schema in public metadata yet.
disconnect_siteRemove a site from the account
Remove a site from the account
No parameter schema in public metadata yet.
get_energy_modeMode, windows, pending hand-back
Mode, windows, pending hand-back
No parameter schema in public metadata yet.
set_energy_modeselfConsumption / amber_smart (Ai+) / au_forecast_export, au_negative_price, au_smart_energy, au_weather_season (AU-01..04 student strategies) / forced (time-boxed)
selfConsumption / amber_smart (Ai+) / au_forecast_export, au_negative_price, au_smart_energy, au_weather_season (AU-01..04 student strategies) / forced (time-boxed)
No parameter schema in public metadata yet.
get_ai_plusAi+ variant, settings and tunable ranges
Ai+ variant, settings and tunable ranges
No parameter schema in public metadata yet.
update_ai_plusChange Ai+ levers or variant
Change Ai+ levers or variant
No parameter schema in public metadata yet.
plan_best_price_dischargePropose a sell schedule from the forecast
Propose a sell schedule from the forecast
No parameter schema in public metadata yet.
plan_discharge_to_targetPropose a discharge that lands on a SOC at a time
Propose a discharge that lands on a SOC at a time
No parameter schema in public metadata yet.
get_strategyStrategy mode: what is running; dry-run AI-written rules against the readings
Strategy mode: what is running; dry-run AI-written rules against the readings
No parameter schema in public metadata yet.
preview_strategyStrategy mode: what is running; dry-run AI-written rules against the readings
Strategy mode: what is running; dry-run AI-written rules against the readings
No parameter schema in public metadata yet.
start_strategyRun, change or stop the AI-written rules; the server keeps the limits and hands the site back when it ends
Run, change or stop the AI-written rules; the server keeps the limits and hands the site back when it ends
No parameter schema in public metadata yet.
update_strategy_rulesRun, change or stop the AI-written rules; the server keeps the limits and hands the site back when it ends
Run, change or stop the AI-written rules; the server keeps the limits and hands the site back when it ends
No parameter schema in public metadata yet.
end_strategyRun, change or stop the AI-written rules; the server keeps the limits and hands the site back when it ends
Run, change or stop the AI-written rules; the server keeps the limits and hands the site back when it ends
No parameter schema in public metadata yet.
Sponsors
Promote your product hereReach 125k+ visitors monthlyPromote your product hereReach 125k+ visitors monthly
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any language
Agent CaffeineSponsoredClose your lid, come back to finished workSnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthlyWaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthlyknobsSponsoredSee your site on any phone, any day, in any languageConfiguration
AIVY_API_KEYsecretPersonal Aivy API key (aivy_sk_...). Optional: without one, register_account or sign_in creates and stores a key from the chat.
AIVY_API_URLdefault: https://bridge.ivyenergy.com.au/v1API base URL. Default https://bridge.ivyenergy.com.au/v1
Readme
aivy-mcp
An MCP server that lets your own AI assistant (Claude Code, Claude Desktop, ChatGPT, Codex, Cursor, ...) read and control your own solar + battery system through the Aivy Developer API by Ivy Energy.
Works with every brand Aivy runs: Sungrow, Sigenergy, FoxESS, AlphaESS, SolaX and more. The same tools, whatever the inverter.
1. Get a key (or let the chat do it)
In the chat. Add the server without any key (step 2) and say "sign me up
to Aivy" or "sign in to my Aivy account". The assistant walks through the
terms, the emailed code and the permission level (read only, or read and
control), and the server stores the key on your computer
(~/.aivy/credentials.json, readable by you only). The key is never shown
in the chat.
Details
- Repository
- github.com/ivyenergy/aivy-mcp
- Website
- bridge.ivyenergy.com.au/developers
- Package
aivy-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active