Skip to main content
Glama

Yeelight IoT MCP Server

get_currnet_house_info

获取用户当前家庭(或项目)的信息

Input Schema

NameRequiredDescriptionDefault

No arguments

Output Schema

NameRequiredDescriptionDefault
idNo家庭/项目ID
descNo家庭/项目别称
iconNo家庭/项目图标
nameNo家庭/项目名称
isErrorNo是否请求失败
propertiesNo属性列表
errorMessageNo错误信息

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observed

TDQS

B3.1/5.0
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 behavioral burden, yet it discloses almost nothing beyond the operation itself. It does not state whether this is read-only, what scope 'current' resolves to, whether auth is required, or how 'home' relates to 'project'; the only mitigating factor is that an output schema exists to document the return shape.

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

Conciseness4/5

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

A single short sentence with no filler, front-loading the verb and resource. It is efficiently sized, though its brevity is partly a result of under-specification rather than disciplined editing.

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

Completeness3/5

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

For a parameterless getter with an existing output schema, the description need not explain return values, so the core need is covered. However, it leaves the agent without any sense of how the 'current home/project' scope is determined or how this tool relates to its siblings, which is the main contextual gap.

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

Parameters4/5

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

The tool takes zero parameters, so per the rubric the baseline is 4. The schema coverage is 100% and there are no parameters whose meaning needs elaboration.

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 states a clear verb+resource: retrieve the user's current home (or project) information. It is specific enough to know what is fetched, but it never distinguishes itself from the sibling getters (get_areas, get_devices, get_rooms, get_scenes), so an agent must infer that this returns the top-level home rather than any sub-resource.

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?

There is no when-to-use guidance, no prerequisites, and no mention of alternatives among the numerous sibling getters. The agent gets no signal about when this is the right call versus get_areas or get_devices.

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

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.