What tools does the orbiteos MCP server provide?

orbiteos exposes 61 tools: analyze_battery_usage, analyze_grid_usage, assign_plugin_to_site, browse_plugins, check_platform_health, check_system_health, compare_solar_performance, create_account, create_component, create_marketplace_category, create_plugin, create_role, create_site, create_sub_account, create_user, delete_component, delete_role, delete_site, delete_sub_account, delete_user, describe_site, describe_system, execute_command, export_csv, get_audit_log, and others. This list was returned by the running server when we connected to it.

Does orbiteos require an API key?

No. orbiteos answered a tools/list request without credentials.

How do I install orbiteos?

Run: claude mcp add --transport sse orbiteos https://mcp.orbiteos.cloud/sse. One-click install links for Cursor and VS Code are also available on the server's page.

orbiteos — MCP server — mcpserver.lol

analyze_battery_usage read-only siteId*toDate*fromDate*

Analyze battery charge/discharge patterns and provide sizing recommendations. Answers "Should I get a bigger battery?"

analyze_grid_usage read-only datesiteId*

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

assign_plugin_to_site siteId*configOverrideinstalledPluginId*

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.

browse_plugins read-only typequerypricingcategory

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

check_platform_health read-only

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

check_system_health read-only 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.

compare_solar_performance read-only siteId*period1To*period2To*period1From*period2From*

Compare solar production across two periods. Answers "Solar seems lower than usual" by comparing recent vs previous period.

create_account name*planslug*

Create a new account (organization) on the platform. Root admin only.

create_component siteId*factoryId*properties*

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

create_marketplace_category iconname*slug*sortOrderdescription

Create a new marketplace category. Root admin only.

create_plugin name*slug*type*pricingcategoryId*isOfficial +3

Create a new plugin in the marketplace. Root admin only.

create_role name*descriptionpermissionIds

Create a custom role with specific permissions.

create_site name*type*edgeIdslocationmetadataparentId +2

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

create_sub_account name*slug*accountId*

Create a sub-account (division) within an account.

create_user name*email*roleIdsiteIdspassword*subAccountId

Create a new user in the account. Assign a role and optionally specific sites.

delete_component can modify data siteId*componentId*

Delete a component from a site. Use with caution — this removes the component from the energy system.

delete_role can modify data roleId*

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

delete_site can modify data siteId*

Delete a site and all its children in the hierarchy.

delete_sub_account can modify data subAccountId*

Delete a sub-account.

delete_user can modify data userId*

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

describe_site read-only siteId*

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

describe_system read-only

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

execute_command can modify data paramssiteId*command*

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

export_csv read-only siteId*toDate*channelsfromDate*

Export historical data as CSV for a site and date range.

get_audit_log read-only limitactionoffsetresourceType

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

get_channel_value read-only siteId*channel*

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

get_energy_summary read-only 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?"

get_live_data read-only siteId*channels

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

get_platform_settings read-only category

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

get_plugin_details read-only slug*

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

get_site read-only siteId*

Get detailed information about a specific site including edge mappings.

get_site_config read-only siteId*

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

get_system_log read-only levelsiteId*toDatefromDate

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

get_user read-only userId*

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

install_plugin configpluginId*

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

invite_user email*roleIdsiteIdssubAccountId

Send an email invitation for someone to join the account.

list_accounts read-only

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

list_installed_plugins read-only

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

list_marketplace_categories read-only

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

list_permissions read-only

List all available permissions that can be assigned to roles.

list_roles read-only

List all roles in the account with their permissions.

list_site_plugins read-only siteId*

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

list_sites read-only flatparentIdsubAccountId

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

list_sub_accounts read-only accountId*

List sub-accounts (divisions) for an account.

list_users read-only

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

query_energy_totals read-only siteId*toDate*channelsfromDate*

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

query_history read-only siteId*toDate*channelsfromDate*

Query historical timeseries power data for a site. Returns time-indexed power values (watts) for the specified channels and date range.

remove_plugin_from_site can modify data siteId*installedPluginId*

Remove a plugin assignment from a site.

search_sites read-only typelimitquery*

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

set_channel_value valuesiteId*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).

test_smtp recipientEmail*

Test SMTP email configuration by sending a test email.

uninstall_plugin can modify data installedPluginId*

Uninstall a plugin from your account. Removes all site assignments.

universal_search read-only limitquery*

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

update_account nameplanisActiveaccountId*

Update an account. Root admin only.

update_component siteId*properties*componentId*

Update configuration properties of an existing component on a site.

update_platform_settings settings*

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

update_plugin_config configstatusinstalledPluginId*

Update configuration of an installed plugin.

update_role nameroleId*descriptionpermissionIds

Update a role's name, description, or permissions.

update_site nametypesiteId*edgeIdsisActivelocation +4

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

update_sub_account nameisActivesubAccountId*

Update a sub-account.

update_user nameemailroleIduserId*siteIdsisActive +1

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

orbiteos

Tools & capabilities