get_device_info
Retrieve detailed capabilities and properties for a specific Bond Bridge smart home device to enable AI-assisted control and management.
Instructions
Get detailed information about a specific device.
Args: device_id: The Bond device identifier
Returns: Detailed device information including capabilities and properties.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| device_id | Yes |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Implementation Reference
- src/bond_mcp/server.py:73-94 (handler)MCP tool handler decorated with @mcp.tool(). It creates a BondClient, calls get_device_info on it, and returns the device information or error.
@mcp.tool() async def get_device_info(device_id: str) -> Dict[str, Any]: """Get detailed information about a specific device. Args: device_id: The Bond device identifier Returns: Detailed device information including capabilities and properties. """ try: async with await get_bond_client() as client: device_info = await client.get_device_info(device_id) return { "device_id": device_id, "info": device_info } except BondAPIError as e: return {"error": f"Failed to get device info: {str(e)}"} except Exception as e: logger.error(f"Unexpected error getting device info: {e}") return {"error": f"Unexpected error: {str(e)}"} - src/bond_mcp/bond_client.py:108-117 (helper)BondClient helper method that sends a GET request to the Bond Bridge API endpoint /v2/devices/{device_id} to fetch the device information.
async def get_device_info(self, device_id: str) -> Dict[str, Any]: """Get detailed information about a specific device. Args: device_id: Device identifier Returns: Device information """ return await self._request("GET", f"devices/{device_id}")