get_device_listLABSCO SUMMARY
Cleaning as something an assistant can start, stop and check on.
List, clean, dock, status is the whole surface, and it covers what people actually ask for. The status read is more detailed than the four operations suggest, because it distinguishes drying mops from collecting dust from genuinely idle.
What it is
The official Ecovacs robot-control server. Four core Ecovacs API endpoints are exposed as tools: the list of robots bound to your account, cleaning control, return-to-dock control, and a working-status read. Robots are addressed by nickname, with fuzzy matching.
What you get
- Every robot bound to your account, returned by nickname
- Cleaning started, resumed, paused or stopped, through the act values s, r, p and h
- Return-to-dock started or stopped, through go-start and stopGo
- A status read returning cleanSt for what it is doing, including cruising, map-building and pet-finding states
- chargeSt for charging state, distinguishing heading back, idle, dock charging and cable charging
- stationSt for the base station: washing mops, drying, dust collection or cleaning itself
Requirements
pip install ecovacs-robot-mcp, or clone the repository and run it under uv. Set an API key for access, and point the server at the API host for your region, https://open.ecovacs.cn inside mainland China and the international host outside it.
Setup effort
One command plus a key — pip install ecovacs-robot-mcp, then supply credentials
USE CASES
01
Starting a clean without finding the app
Name the robot, and fuzzy matching on the nickname means you do not have to reproduce it exactly. The act value decides whether it starts, resumes, pauses or stops.
02
Finding out whether it is done
The status read separates still cleaning from paused from idle, and tells you whether the base station is washing or drying, which is the difference between finished and nearly finished.
03
Sending it home mid-run
Return-to-dock is its own control, so you can recall the robot when someone is on a call and send it back out afterwards without restarting the whole clean.
04
Working out which robot you are talking to
List the robots bound to the account first, so a household with more than one gets the right nickname before any command is sent.
4 tools
Listed in project docs. Your client may show a different list.
set_cleaningset_chargingget_work_stateBEFORE YOU INSTALL
What to know first
Tools you get
4 tools named in the project's documentation.
Requires
- Python 3.8 or later, with pip install ecovacs-robot-mcp
- ECO_API_KEY in your environment
Where it runs
Of the 2 documented clients, 1 runs the server on your machine and 1 connects to a hosted endpoint.
INSTALLATION
Connect your client
Server setup
TERMINAL
pip install ecovacs-robot-mcpMCP Clients
Claude Desktop
CLAUDE DESKTOP · JSON
{
"mcpServers": {
"ecovacs_mcp": {
"command": "python3",
"args": [
"-m",
"ecovacs_robot_mcp"
],
"env": {
"ECO_API_KEY": "<YOUR_ECO_API_KEY>",
"ECO_API_URL": "https://open.ecovacs.cn"
}
}
}
}ECO_API_KEY is the AK from the Ecovacs open platform (open.ecovacs.cn/preparationForUse). Outside mainland China, set ECO_API_URL to https://open.ecovacs.com.
Cursor — SSE
CURSOR — SSE · JSON
{
"mcpServers": {
"robot_control_server": {
"url": "https://mcp-open.ecovacs.cn/sse?ak=<YOUR_ACCESS_KEY>"
}
}
}<YOUR_ACCESS_KEY> is the AK you get from the Ecovacs open platform (open.ecovacs.cn/preparationForUse). Outside mainland China the address is https://mcp-open.ecovacs.com/sse?ak=<YOUR_ACCESS_KEY>.
