Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
FELICITY_PASSYesFelicity Solar account password
FELICITY_PORTNoHTTP server port (default 3010)3010
FELICITY_USERYesFelicity Solar account email
FELICITY_POLL_MSNoBackground poll interval in ms (default 30000)30000

Capabilities

Features and capabilities supported by this server

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_all_batteriesA

Live status of all Felicity batteries: SOC, power, voltage, temperature, charging state.

get_batteryA

Detailed status of one battery by alias (Bat1/Bat2/Bat3) or serial number.

get_cell_voltagesA

Individual cell voltages (mV) for one battery. Useful for detecting cell imbalance.

get_fleet_summaryB

Compact health summary: total energy, worst cell imbalance, temperatures.

get_balance_trendA

Balance trend for batteries over the last ~60 min. Shows whether cell delta (mV spread) is improving, stable, or degrading.

get_snapshotsA

Raw battery pack snapshots for the last ~60 min (one per ~10 min). Includes cell voltages, delta, SOC, and balancing state.

get_healthB

Per-battery health report: cell delta status, temperature status, SOH, weak/outlier cell indices, average C-rate, and discharge-phase delta.

get_autonomyA

Fleet autonomy estimate: hours until the pack hits minSoc, hours to full charge, and optional SOC projection at a given sunrise time.

get_alertsA

Active alert list ranked by severity. Checks cell imbalance, temperature, SOH, outlier cells, BMS warnings, under-voltage events, and data staleness.

get_energy_historyA

Daily charge/discharge energy totals (kWh) — up to 90 days from persistent store, merged with live intraday data. Shows peak rates and net balance.

get_cell_statsA

Per-cell voltage statistics from intraday snapshots: mean, stddev, min/max, deviation from pack average, and trend direction.

get_module_healthB

Per-module voltage aggregates (min/max/mean/delta) for one battery using live cell voltages. Flags modules containing persistent outlier cells.

get_limit_headroomA

Headroom between current voltage/current and BMS protection limits. Useful for spotting packs running close to cutoff thresholds.

get_lifetime_statsA

Cycle count, full-charge events, under-voltage events, warning count, and projected remaining LFP cycle life (nominal 4000 cycles).

get_capacity_estimateA

Estimates real usable capacity (remainingKwh ÷ SOC%) vs rated capacity per battery. Most accurate at 20–80% SOC.

get_power_statsA

Charge/discharge power statistics from intraday snapshots: peak kW, average kW, C-rate, and fraction of samples above 0.5C.

get_cost_savingsA

Estimated monetary savings from discharged energy × electricity tariff. Pass tariffKwh or set FELICITY_TARIFF_KWH env var.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/RicardoSantos/mcp-fsolar'

If you have feedback or need assistance with the MCP directory API, please join our Discord server