# EcoFlow MCP Server

MCP (Model Context Protocol) server for controlling and monitoring EcoFlow Power Stations.

## Features

- **List Devices** - View all EcoFlow devices linked to your account
- **Device Status** - Get comprehensive status including battery level, power flow, temperatures
- **Solar Input** - Monitor solar panel power generation
- **AC Output Control** - Enable/disable AC output with X-Boost and voltage settings
- **DC Output Control** - Enable/disable DC (12V car port) output
- **Charging Settings** - Configure max/min charge levels and charging power
- **Standby Timeouts** - Set auto-off timers for device, AC, DC, and LCD
- **Raw Quota Access** - Access all device parameters for debugging

## Supported Devices

- DELTA series (Delta, Delta Max, Delta Pro, Delta 2, Delta 2 Max, Delta Pro 3)
- RIVER series (River, River Max, River Pro, River 2, River 2 Max, River 2 Pro)
- PowerStream micro-inverter
- Smart Plug
- And other EcoFlow devices with API support

## Setup

### 1. Get API Credentials

1. Register at [EcoFlow Developer Platform](https://developer.ecoflow.com)
2. Wait for approval (can take up to a week)
3. Go to your profile and generate Access Key and Secret Key

### 2. Install Dependencies

```bash
cd /Users/timothy.schwarz/Scripts/mcp-servers/ecoflow-mcp
npm install
npm run build
```

### 3. Configure MCP

Add to your `~/.claude/user-mcps.json`:

```json
{
  "ecoflow": {
    "type": "stdio",
    "command": "node",
    "args": ["/Users/timothy.schwarz/Scripts/mcp-servers/ecoflow-mcp/dist/index.js"],
    "env": {
      "ECOFLOW_ACCESS_KEY": "your_access_key_here",
      "ECOFLOW_SECRET_KEY": "your_secret_key_here"
    }
  }
}
```

### Regional API

By default, the server uses `https://api.ecoflow.com` (US/Americas). For Europe, set:

```json
"env": {
  "ECOFLOW_ACCESS_KEY": "...",
  "ECOFLOW_SECRET_KEY": "...",
  "ECOFLOW_BASE_URL": "https://api-e.ecoflow.com"
}
```

## Available Tools

### ecoflow_list_devices
List all EcoFlow devices linked to your account.

### ecoflow_get_device_status
Get comprehensive status for a device including battery level, power input/output, and more.
- `serial_number` (required): Device serial number

### ecoflow_get_solar_input
Get solar panel input data including power, voltage, and current.
- `serial_number` (required): Device serial number

### ecoflow_set_ac_output
Enable or disable AC output on a power station.
- `serial_number` (required): Device serial number
- `enabled` (required): true to enable, false to disable
- `xboost` (optional): Enable X-Boost mode
- `voltage` (optional): Output voltage (110 or 220)
- `frequency` (optional): Output frequency (50 or 60 Hz)

### ecoflow_set_dc_output
Enable or disable DC output (12V car port).
- `serial_number` (required): Device serial number
- `enabled` (required): true to enable, false to disable

### ecoflow_get_charging_settings
Get current charging configuration.
- `serial_number` (required): Device serial number

### ecoflow_set_charging_settings
Configure charging parameters.
- `serial_number` (required): Device serial number
- `max_charge_soc` (optional): Maximum charge level (0-100%)
- `min_discharge_soc` (optional): Minimum discharge level (0-100%)
- `charging_watts` (optional): AC charging power in watts

### ecoflow_set_standby
Configure auto-standby timeouts.
- `serial_number` (required): Device serial number
- `device_timeout` (optional): Device standby timeout in minutes (0 = never)
- `ac_timeout` (optional): AC output timeout in minutes
- `dc_timeout` (optional): DC output timeout in minutes
- `lcd_timeout` (optional): LCD screen timeout in seconds

### ecoflow_get_raw_quota
Get all raw device parameters (for debugging).
- `serial_number` (required): Device serial number
- `filter` (optional): Filter parameters by keyword

## Example Usage

```
> List my EcoFlow devices
> Show battery status for DELTA Pro (serial: R351...)
> Enable AC output on my DELTA 2
> Set charging limit to 80% on my power station
> Get solar panel input data
```

## API Documentation

- [EcoFlow Developer Platform](https://developer.ecoflow.com)
- [API Introduction](https://developer.ecoflow.com/us/document/introduction)

## License

MIT