show_device_status_ui
Display an interactive status card for WeMo smart devices to view device details and control power states with toggle buttons.
Instructions
Show a device status card with interactive controls.
Returns rich HTML for a single device showing its name, IP, model, and On / Off / Toggle buttons. Supported in Claude Desktop, VS Code, ChatGPT, Goose and any other MCP Apps-compatible host.
Args:
device_identifier: Device name or IP address.Text-only fallback: use get_device_status + control_device instead.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_identifier | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/wemo_mcp_server/server.py:1717-1809 (handler)Implementation of the show_device_status_ui tool, which returns an interactive HTML card for a single WeMo device.
async def show_device_status_ui(device_identifier: str) -> list[UIResource]: # type: ignore[return] """Show a device status card with interactive controls. Returns rich HTML for a single device showing its name, IP, model, and On / Off / Toggle buttons. Supported in Claude Desktop, VS Code, ChatGPT, Goose and any other MCP Apps-compatible host. Args: ---- device_identifier: Device name or IP address. Text-only fallback: use get_device_status + control_device instead. """ # Look up device in cache (same lookup order used by other tools) device: Any = _device_cache.get(device_identifier) if device is None: device = await _reconnect_device_from_cache(device_identifier) if device is not None and hasattr(device, "host"): d_name = str(device.name) d_host = str(device.host) d_model = str(getattr(device, "model_name", type(device).__name__)) else: # Try persistent cache try: persisted = _cache_manager.load() or {} entry = persisted.get(device_identifier, {}) except Exception: entry = {} if entry: d_name = str(entry.get("name", device_identifier)) d_host = str(entry.get("host", "?")) d_model = str(entry.get("model_name", entry.get("model", "WeMo Device"))) else: d_name = device_identifier d_host = "?" d_model = "Unknown" nh = _h(d_name) nj = _js(d_name) status_css = """ *{box-sizing:border-box;margin:0;padding:0} body{font-family:-apple-system,BlinkMacSystemFont,"Segoe UI",sans-serif; background:#f1f5f9;color:#1e293b;padding:16px} .card{background:#fff;border:1px solid #e2e8f0;border-radius:14px; padding:20px;max-width:320px;box-shadow:0 1px 4px rgba(0,0,0,.07)} .title{font-size:17px;font-weight:700;margin-bottom:4px} .sub{font-size:12px;color:#94a3b8;margin-bottom:18px} .row{display:flex;gap:8px} button{flex:1;padding:10px;border:none;border-radius:9px;cursor:pointer; font-size:14px;font-weight:600;color:#fff;transition:background .15s} .btn-on{background:#22c55e}.btn-on:hover{background:#16a34a} .btn-off{background:#94a3b8}.btn-off:hover{background:#64748b} .btn-toggle{background:#3b82f6}.btn-toggle:hover{background:#2563eb} button:disabled{opacity:.55;cursor:not-allowed} .footer{margin-top:14px;font-size:11px;color:#cbd5e1;text-align:center} """ status_js = """ function call(action, btn, label) { btn.disabled = true; btn.textContent = "\u23f3"; window.parent.postMessage( {type:"tool",payload:{toolName:"control_device", params:{device_identifier:NAME,action:action}}},"*"); setTimeout(function(){ btn.disabled=false; btn.textContent=label; }, 3000); } """.replace("NAME", f"'{nj}'") html = ( '<!DOCTYPE html><html lang="en"><head><meta charset="utf-8">' f"<style>{status_css}</style></head><body>" '<div class="card">' f'<div class="title">{nh}</div>' f'<div class="sub">{_h(d_host)} · {_h(d_model)}</div>' '<div class="row">' "<button class=\"btn-on\" onclick=\"call('on',this,'On')\">On</button>" "<button class=\"btn-off\" onclick=\"call('off',this,'Off')\">Off</button>" "<button class=\"btn-toggle\" onclick=\"call('toggle',this,'Toggle')\">Toggle</button>" "</div></div>" '<div class="footer">wemo-mcp-server · MCP Apps</div>' f"<script>{status_js}</script></body></html>" ) resource = create_ui_resource( { "uri": "ui://wemo/device-status", "content": {"type": "rawHtml", "htmlString": html}, "encoding": "text", } ) return [resource] # type: ignore[return-value]