Introduction to the Skylar One SyncPack

Download this manual as a PDF file 

This section describes the "Skylar One" SyncPack, which contains a set of tools used by the Model Context Protocol (MCP) server introduced in version 3.4.0 of Skylar Automation.

Contents of the Skylar One SyncPack

This section lists the contents of the "Skylar One" SyncPack.

MCP Components

The following MCP tools and their filters work in conjunction with the MCP server introduced in version 3.4.0 of Skylar Automation. For more information, see the Configuring the Skylar Automation MCP Server chapter in the Skylar Automation manual.

All MCP tools listed below require a config_name that points to a Skylar Automation configuration object with the following fields:

  • sl1_host. The hostname or IP address of the Skylar One instance.

  • sl1_basic_auth_token. Base64-encoded Basic authorization credentials.

  • list_devices. Returns a paginated list of devices from Skylar One. All filters are optional and can be combined. Filters include:

    • device_id. Integer. Filters to a specific device.

    • severity_level. Integer of one to five. The minimum severity to return. Five is the most severe.

    • device_class. String. Filters by device class name.

    • collector_group_name. String. Filters by collector group name.

    • limit. Integer between 1 and 50. Defines results per page. The default value is 10.

    • cursor. String. Pagination cursor from a previous response.

  • list_events. Returns a paginated list of active events, ordered by the most recent first. Filters include:

    • device_id. Integer. Filters events to a specific device.

    • severity_level. Integer of one to five. The minimum severity to return. Five is the most severe.

    • limit. Integer between 1 and 50. Defines results per page. The default value is 10.

    • cursor. String. Pagination cursor from a previous response.

  • get_asset_by_device_id. Returns asset records (hardware inventory) associated with a device. Filter includes:

    • device_id. Integer. Required. The ID of the device that contains the asset records.

  • list_business_services. Returns a paginated list of business services. All filters are optional. Filters include:

    • risk_level. Integer of one to five. The minimum risk level to return.

    • health_level. Integer of one to five. The minimum health degradation level to return.

    • unavailable_only. Boolean. If true, only returns unavailable services.

    • name_contains. String. Filters by partial name matches.

    • limit. Integer between 1 and 50. Defines results per page. The default value is 10.

    • cursor. String. Pagination cursor from a previous response.

  • get_appliance_status. Returns status information for all appliances in the Skylar One instance (excludes Collector Unit and Message Collector appliance types). No additional parameters.

All paginated tools return a cursor in the response. Pass the cursor as the cursor parameter on the next call to fetch the next page.