Skip to main content
Glama
appleton

Eufy RoboVac MCP Server

by appleton

robovac_get_work_mode

Retrieve the current cleaning mode of your Eufy RoboVac vacuum to understand its active operation and adjust settings as needed.

Instructions

Get the current work mode of the robovac

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
forceNoForce refresh of cached data

Implementation Reference

  • Executes the tool by ensuring the RoboVac instance is initialized, calling getWorkMode(force) on it, and returning the result as formatted text.
    case "robovac_get_work_mode":
      this.ensureRoboVacInitialized();
      const workMode = await this.robovac!.getWorkMode(
        args?.force as boolean
      );
      return {
        content: [
          {
            type: "text",
            text: `Work Mode: ${workMode}`,
          },
        ],
      };
  • Tool definition including input schema with optional 'force' boolean parameter for refreshing cached data.
    {
      name: "robovac_get_work_mode",
      description: "Get the current work mode of the robovac",
      inputSchema: {
        type: "object",
        properties: {
          force: {
            type: "boolean",
            description: "Force refresh of cached data",
            default: false,
          },
        },
      },
    },
  • src/server.ts:118-385 (registration)
    The tool is registered in the ListToolsRequestHandler by including it in the returned tools array.
      tools: [
        {
          name: "robovac_set_work_mode",
          description: "Set the cleaning mode of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              mode: {
                type: "string",
                description: "The work mode to set",
                enum: ["AUTO", "SMALL_ROOM", "SPOT", "EDGE", "NO_SWEEP"],
              },
            },
            required: ["mode"],
          },
        },
        {
          name: "robovac_set_clean_speed",
          description: "Set the suction speed of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              speed: {
                type: "string",
                description: "The cleaning speed to set",
                enum: ["STANDARD", "BOOST_IQ", "MAX", "NO_SUCTION"],
              },
            },
            required: ["speed"],
          },
        },
        {
          name: "robovac_play",
          description: "Start/resume robovac cleaning",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_pause",
          description: "Pause robovac cleaning",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_find_robot",
          description: "Make the robovac beep to help locate it",
          inputSchema: {
            type: "object",
            properties: {
              enable: {
                type: "boolean",
                description: "Whether to enable or disable find robot mode",
                default: true,
              },
            },
          },
        },
        {
          name: "robovac_get_error_code",
          description: "Get the current error code of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              force: {
                type: "boolean",
                description: "Force refresh of cached data",
                default: false,
              },
            },
          },
        },
        {
          name: "robovac_get_work_mode",
          description: "Get the current work mode of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              force: {
                type: "boolean",
                description: "Force refresh of cached data",
                default: false,
              },
            },
          },
        },
        {
          name: "robovac_get_clean_speed",
          description: "Get the current cleaning speed of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              force: {
                type: "boolean",
                description: "Force refresh of cached data",
                default: false,
              },
            },
          },
        },
        {
          name: "robovac_get_work_status",
          description: "Get the current work status of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              force: {
                type: "boolean",
                description: "Force refresh of cached data",
                default: false,
              },
            },
          },
        },
        {
          name: "robovac_get_play_pause",
          description: "Get the current play/pause state of the robovac",
          inputSchema: {
            type: "object",
            properties: {
              force: {
                type: "boolean",
                description: "Force refresh of cached data",
                default: false,
              },
            },
          },
        },
        {
          name: "robovac_format_status",
          description:
            "Get a formatted display of all robovac status information",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_get_all_statuses",
          description: "Get all status information from the robovac at once",
          inputSchema: {
            type: "object",
            properties: {
              force: {
                type: "boolean",
                description: "Force refresh of cached data",
                default: false,
              },
            },
          },
        },
        {
          name: "robovac_auto_initialize",
          description:
            "Automatically discover and initialize the first RoboVac device found",
          inputSchema: {
            type: "object",
            properties: {
              email: {
                type: "string",
                description: "Your Eufy account email address",
              },
              password: {
                type: "string",
                description: "Your Eufy account password",
              },
              deviceIndex: {
                type: "number",
                description:
                  "Index of device to connect to (0 for first device)",
                default: 0,
              },
            },
            required: ["email", "password"],
          },
        },
        {
          name: "robovac_connect_discovered",
          description:
            "Connect to a discovered RoboVac device by IP (requires device ID and local key)",
          inputSchema: {
            type: "object",
            properties: {
              ip: {
                type: "string",
                description: "IP address of the discovered device",
              },
              deviceId: {
                type: "string",
                description: "The device ID of your Eufy RoboVac",
              },
              localKey: {
                type: "string",
                description: "The local key for your Eufy RoboVac",
              },
            },
            required: ["ip", "deviceId", "localKey"],
          },
        },
        {
          name: "robovac_connect",
          description:
            "Connect to your RoboVac using device credentials (manual setup)",
          inputSchema: {
            type: "object",
            properties: {
              deviceId: {
                type: "string",
                description: "The device ID of your Eufy RoboVac",
              },
              localKey: {
                type: "string",
                description: "The local key for your Eufy RoboVac",
              },
              ip: {
                type: "string",
                description:
                  "The IP address of your Eufy RoboVac (optional, defaults to 192.168.1.100)",
              },
            },
            required: ["deviceId", "localKey"],
          },
        },
        {
          name: "robovac_start_cleaning",
          description: "Start the robovac cleaning cycle",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_stop_cleaning",
          description: "Stop the robovac cleaning cycle",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_return_home",
          description: "Send the robovac back to its charging dock",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_get_status",
          description: "Get the current status of the robovac",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
        {
          name: "robovac_get_battery",
          description: "Get the battery level of the robovac",
          inputSchema: {
            type: "object",
            properties: {},
          },
        },
      ],
    })
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations are provided, so the description carries the full burden of behavioral disclosure. It states the tool retrieves data ('Get'), implying a read-only operation, but doesn't mention any side effects, authentication needs, rate limits, or error handling. For a tool with no annotation coverage, this leaves significant gaps in understanding its behavior.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is a single, direct sentence that efficiently conveys the core purpose without any unnecessary words. It is front-loaded with the essential action and resource, making it highly concise and well-structured for quick comprehension.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the lack of annotations and output schema, the description is incomplete for a tool in this context. It doesn't explain what 'work mode' entails (e.g., cleaning modes, status types), how the data is returned, or potential errors, leaving the agent with insufficient information to use the tool effectively beyond its basic purpose.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The input schema has 100% description coverage, with the single parameter 'force' clearly documented as 'Force refresh of cached data' with a default value. The description adds no additional parameter information beyond what the schema provides, so it meets the baseline score of 3 for high schema coverage without compensating value.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose with a specific verb ('Get') and resource ('current work mode of the robovac'), making it immediately understandable. However, it doesn't explicitly differentiate from similar sibling tools like 'robovac_get_status' or 'robovac_get_work_status', which might retrieve overlapping or related information.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. With sibling tools like 'robovac_get_status' and 'robovac_get_work_status' available, there's no indication of what distinguishes this tool, such as whether it returns a subset of data or a specific mode type, leaving the agent to guess based on naming alone.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Install Server

Other Tools

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/appleton/sam'

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