English | 中文

Ecovacs core API now fully supports the MCP protocol, making it the world's first robot service provider compatible with the MCP protocol.

Ecovacs has completed the integration of 4 core API interfaces with the MCP protocol, including device list query, cleaning control, recharging control, and working status query.

As the world's first cleaning robot service provider to support the MCP protocol, after the release of Ecovacs MCP Server, AI agent developers only need simple configuration to quickly access robot services in large language models, enabling query, cleaning, recharging, and other capabilities.

This significantly lowers the threshold for calling robot control services during AI agent application development and greatly improves the development efficiency of AI agent applications.

Get a list of all robots bound to the user.

No parameters

{
  "status": 0,
  "message": "success",
  "data": [
    {
      "nickname": "Robot nickname",
    }
  ]
}

Control the robot vacuum to start, pause, resume, or stop cleaning.

• nickname: Robot nickname, used to find the device, supports fuzzy matching
• act: Cleaning action
  • s: Start cleaning
  • r: Resume cleaning
  • p: Pause cleaning
  • h: Stop cleaning

{
  "msg": "OK",
  "code": 0,
  "data": []
}

Control the robot to start or stop recharging.

• nickname: Robot nickname, used to find the device
• act: Robot action
  • go-start: Start recharging
  • stopGo: Stop recharging

{
  "msg": "OK",
  "code": 0,
  "data": []
}

Query the robot's current working status.

• nickname: Robot nickname, used to find the device

{
	"code": 0,
	"msg": "success",
	"data": {
		"ctl": {
			"data": {
				"ret": "ok",
				"cleanSt": "h",
				"chargeSt": "charging",
				"stationSt": "i"
			}
		}
	}
}

Status Code Description:

git clone git@github.com:ecovacs-ai/ecovacs-mcp.git

uv add "mcp[cli]" mcp requests

uv run ecovacs_mcp/robot_mcp_stdio.py

pip install ecovacs-robot-mcp

python3 -m ecovacs_robot_mcp

• ECO_API_KEY: API access key, used to authenticate API call permissions
• ECO_API_URL: API HOST
  • Mainland China:https://open.ecovacs.cn
  • Outside Mainland China: https://open.ecovacs.com

Before choosing between the two methods (local or SSE), you need to create a server AK in the Ecovacs Open Platform Console to call the robot's API capabilities through the AK.

If you want to cancel the authorization, you can also remove the AK authorization in the Ecovacs Open Platform Console.

Ecovacs Open Platform (Mainland China): https://open.ecovacs.cn

Ecovacs Open Platform (Outside Mainland China): https://open.ecovacs.com

Add the following configuration to any MCP client (such as Claude.app). Some clients may require formatting adjustments.

ECO_API_KEY is the API access key ECO_API_URL is the API HOST

• Using uvx

{
  "mcpServers": {
    "ecovacs_mcp": {
      "command": "uvx",
      "args": ["ecovacs-robot-mcp"],
      "env": {
        "ECO_API_KEY": "your AK...........",
        "ECO_API_URL": "https://open.ecovacs.cn" // For regions outside Mainland China, configure as https://open.ecovacs.com
      }
    }
  }
}

• Using pip installation

{
  "mcpServers": {
    "ecovacs_mcp": {
      "command": "python",
      "args": ["-m", "ecovacs-robot-mcp"],
      "env": {
          "ECO_API_KEY": "your AK...........",
          "ECO_API_URL": "https://open.ecovacs.cn" // For regions outside Mainland China, configure as https://open.ecovacs.com
      }
    }
  }
}

Open Claude for Desktop's Setting, switch to Developer, click Edit Config, and open the configuration file with any IDE.

Add the following configuration to the configuration file. ECO_API_KEY is the AK for accessing the Ecovacs Open Platform API, which can be obtained from this page:

{
    "mcpServers": {
        "ecovacs_mcp": {
            "command": "python3",
            "args": ["-m", "ecovacs_robot_mcp"],
            "env": {
                "ECO_API_KEY": "your ak......",
                "ECO_API_URL": "https://open.ecovacs.cn" // For regions outside Mainland China, configure as https://open.ecovacs.com
            }
        }
    }
}

Restart Claude, and the settings panel will successfully load the Ecovacs Robot MCP Server. In the main interface dialog, you can see 4 available MCP tools. Click to view details.

Now you can ask questions and verify the capabilities of the Ecovacs robot assistant.

{
  "mcpServers": {
    "robot_control_server": {
      "url": "https://open.ecovacs.cn/sse?ak=your ak"
      // For regions outside Mainland China, configure as https://open.ecovacs.com/sse?ak=your ak
    }
  }
}

MIT © ecovacs

For any issues encountered while using the Ecovacs Robot MCP Server, please feel free to contact us through issue or direct contact. We also welcome every positive PR. Thank you very much for your support and contribution ❤️

Mail: pei.zhou@ecovacs.com

WeChat: