ThinQ Connect MCP Server

Instructions

Returns:
    String containing device status information

Implementation Reference

• thinqconnect_mcp/tools.py:318-332 (handler)

  Core handler function that fetches the device status from ThinQApi and formats it for return.

  async def get_device_status(thinq_api: ThinQApi, device_id: str) -> str:
      """
      Retrieve status information for a specific device.
      """
      try:
          thinq_api._session = ClientSession()
          device_status = await thinq_api.async_get_device_status(device_id=device_id)
          return f"""Device status information is as follows.
  Please relay appropriately to the user.
  ## Status Information
  {device_status}
  """
      except Exception as e:
          return f"An error occurred while retrieving device status: {str(e)}"

• thinqconnect_mcp/server.py:91-101 (registration)

  MCP tool registration decorator and thin wrapper handler that delegates to the core implementation in tools.py.

  @mcp.tool(
      description="""Retrieves status information for a specific device
      Args:
          device_id: Unique ID of the device to query
  
      Returns:
          String containing device status information
      """
  )
  async def get_device_status(device_id: str) -> str:
      return await tools.get_device_status(thinq_api=thinq_api, device_id=device_id)