mcp server

OrbitEOS Energy Management

Energy management platform — 61 tools for solar, battery, grid, and EV charging control

Description as published by the maintainer. Source

• version 1.0.0
• archived

archived — The linked repository returns 404. It was deleted, renamed or made private.

What this server can do

61 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

analyze_battery_usage(siteId, toDate, fromDate)

Analyze battery charge/discharge patterns and provide sizing recommendations. Answers "Should I get a bigger battery?" Required: siteId, fromDate, toDate.

analyze_grid_usage(date, siteId)

Analyze why grid import is high. Compares production vs consumption patterns. Answers "Why am I importing so much from the grid?" Required: siteId.

assign_plugin_to_site(siteId, configOverride, installedPluginId)

Assign an installed plugin to a specific site. This creates a device/algorithm/integration instance at the site level. E.g., assign "SMA Inverter" driver to "Munich Factory" site. Required: installedPluginId, siteId.

browse_plugins(type, query, pricing, category)

Browse available plugins in the marketplace. Filter by category, type, or search text.

check_platform_health

Check the health of the OrbitEOS platform itself (database connection, edge backend connectivity).

check_system_health(siteId)

Check if a site's energy system is running normally. Answers "Is my system running normally?" by checking online status, battery SoC, grid connection, and component states. Required: siteId.

compare_solar_performance(siteId, period1To, period2To, period1From, period2From)

Compare solar production across two periods. Answers "Solar seems lower than usual" by comparing recent vs previous period. Required: siteId, period1From, period1To, period2From, period2To.

create_account(name, plan, slug)

Create a new account (organization) on the platform. Root admin only. Required: name, slug.

create_component(siteId, factoryId, properties)

Create a new component (controller, meter, inverter, etc.) on a site. Requires the factory ID and configuration properties. Required: siteId, factoryId, properties.

create_marketplace_category(icon, name, slug, sortOrder, description)

Create a new marketplace category. Root admin only. Required: name, slug.

create_plugin(name, slug, type, pricing, categoryId, isOfficial, description, capabilities, configSchema)

Create a new plugin in the marketplace. Root admin only. Required: name, slug, categoryId, type.

create_role(name, description, permissionIds)

Create a custom role with specific permissions. Required: name.

create_site(name, type, edgeIds, location, metadata, parentId, description, subAccountId)

Create a new site in the hierarchy. Types: region, hub, site, zone. Only "site" type can have edge mappings. Required: name, type.

create_sub_account(name, slug, accountId)

Create a sub-account (division) within an account. Required: accountId, name, slug.

create_user(name, email, roleId, siteIds, password, subAccountId)

Create a new user in the account. Assign a role and optionally specific sites. Required: email, password, name.

delete_component(siteId, componentId)

Delete a component from a site. Use with caution — this removes the component from the energy system. Required: siteId, componentId.

delete_role(roleId)

Delete a custom role. Cannot delete system roles or roles assigned to users. Required: roleId.

delete_site(siteId)

Delete a site and all its children in the hierarchy. Required: siteId.

delete_sub_account(subAccountId)

Delete a sub-account. Required: subAccountId.

delete_user(userId)

Deactivate a user account. Does not permanently delete — can be reactivated. Required: userId.

describe_site(siteId)

Get a human-readable summary of a site: what components it has, its capabilities, current status. Required: siteId.

describe_system

Explain what OrbitEOS is, what sections the dashboard has, and what metrics are available. Useful for orientation.

execute_command(params, siteId, command)

Execute a system command on a site's edge controller. Use with caution. Commands: restart, factoryReset, etc. Required: siteId, command.

export_csv(siteId, toDate, channels, fromDate)

Export historical data as CSV for a site and date range. Required: siteId, fromDate, toDate.

get_audit_log(limit, action, offset, resourceType)

Query the audit log to see who did what and when. Shows user actions like logins, creates, updates, deletes.

get_channel_value(siteId, channel)

Get a single channel value from a site. Channels are addresses like "_sum/GridActivePower" or "ess0/Soc". Required: siteId, channel.

get_energy_summary(siteId, toDate, fromDate)

Get energy summary for a site over a period. Answers "How much solar did I generate this month?" or "What's my energy usage?" Required: siteId, fromDate, toDate.

get_live_data(siteId, channels)

Get current live power/energy snapshot for a site. Returns grid power, solar production, consumption, battery SoC, etc. Required: siteId.

get_platform_settings(category)

Get all platform configuration settings. Root admin only. Includes SMTP, branding, security, edge connection, LLM config.

get_plugin_details(slug)

Get detailed information about a marketplace plugin including its configuration schema and capabilities. Required: slug.

get_site(siteId)

Get detailed information about a specific site including edge mappings. Required: siteId.

get_site_config(siteId)

Get the full component configuration for a site (fetched live from the energy system). Shows all controllers, meters, inverters, etc. Required: siteId.

get_system_log(level, siteId, toDate, fromDate)

Get system logs for a site. Shows runtime log entries filtered by level. Required: siteId.

get_user(userId)

Get detailed information about a specific user including their assigned sites. Required: userId.

install_plugin(config, pluginId)

Install a marketplace plugin for your account. Once installed, it can be assigned to specific sites. Required: pluginId.

invite_user(email, roleId, siteIds, subAccountId)

Send an email invitation for someone to join the account. Required: email.

list_accounts

List all accounts (organizations) on the platform. Root admin only.

list_installed_plugins

List all plugins installed in your account, including their site assignments.

list_marketplace_categories

List all marketplace categories: Energy Devices, Cloud Integrations, Analytics, Control Strategies, Notifications, Dashboard Widgets, Data Export, Protocols, UI Apps.

list_permissions

List all available permissions that can be assigned to roles.

list_roles

List all roles in the account with their permissions.

list_site_plugins(siteId)

List all plugins/devices/algorithms assigned to a specific site. Required: siteId.

list_sites(flat, parentId, subAccountId)

List all sites accessible to the current user. Supports tree view (lazy loading by parentId) or flat list.

list_sub_accounts(accountId)

List sub-accounts (divisions) for an account. Required: accountId.

list_users

List all users in the current account. Shows name, email, role, last login, and active status.

query_energy_totals(siteId, toDate, channels, fromDate)

Query cumulative energy totals (kWh) for a site over a date range. Returns production, consumption, grid import/export, battery charge/discharge. Required: siteId, fromDate, toDate.

query_history(siteId, toDate, channels, fromDate)

Query historical timeseries power data for a site. Returns time-indexed power values (watts) for the specified channels and date range. Required: siteId, fromDate, toDate.

remove_plugin_from_site(siteId, installedPluginId)

Remove a plugin assignment from a site. Required: installedPluginId, siteId.

search_sites(type, limit, query)

Search sites by name, description, or location across the entire hierarchy. Returns breadcrumb paths. Required: query.

set_channel_value(value, siteId, channelId, componentId)

Write a value to a writable channel on a site. Used for manual control (e.g., set EV charger power limit, force battery charge/discharge). Required: siteId, componentId, channelId.

test_smtp(recipientEmail)

Test SMTP email configuration by sending a test email. Required: recipientEmail.

uninstall_plugin(installedPluginId)

Uninstall a plugin from your account. Removes all site assignments. Required: installedPluginId.

universal_search(limit, query)

Search across all entities: accounts, sub-accounts, sites, users. Returns matching results with entity types. Required: query.

update_account(name, plan, isActive, accountId)

Update an account. Root admin only. Required: accountId.

update_component(siteId, properties, componentId)

Update configuration properties of an existing component on a site. Required: siteId, componentId, properties.

update_platform_settings(settings)

Update platform configuration settings. Root admin only. Pass an array of {key, value} pairs. Required: settings.

update_plugin_config(config, status, installedPluginId)

Update configuration of an installed plugin. Required: installedPluginId.

update_role(name, roleId, description, permissionIds)

Update a role's name, description, or permissions. Required: roleId.

update_site(name, type, siteId, edgeIds, isActive, location, metadata, parentId, description, subAccountId)

Update a site's properties, hierarchy position, or edge mappings. Required: siteId.

update_sub_account(name, isActive, subAccountId)

Update a sub-account. Required: subAccountId.

update_user(name, email, roleId, userId, siteIds, isActive, subAccountId)

Update a user's profile, role, active status, or site assignments. Required: userId.

Last successful function declaration observed on 2026-08-13. Source: https://mcp.orbiteos.cloud/sse. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://mcp.orbiteos.cloud/sse.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/OrbitEOS/orbiteos-core
• Website — https://orbiteos.cloud
• Remote endpoint (sse) — https://mcp.orbiteos.cloud/sse