action1-mcp-server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| HOST | No | HTTP transport host. | 127.0.0.1 |
| PORT | No | HTTP transport port. | 3000 |
| TRUST_PROXY | No | Reverse-proxy hop trust for correct client IPs in rate-limiting. One of false / true / loopback / a CIDR. | false |
| ACTION1_ORG_ID | No | Default org UUID. Each tool can override via org_id. | |
| MCP_HTTP_TOKEN | No | Required Authorization: Bearer <token> on /mcp when set. Strongly recommended for any non-loopback bind. | |
| ACTION1_BASE_URL | Yes | Region-specific instance, e.g. https://app.eu.action1.com/api/3.0. | |
| ACTION1_CLIENT_ID | Yes | OAuth2 client id from Action1 → Settings → API Credentials. | |
| ACTION1_LOG_LEVEL | No | One of debug, info, notice, warn, warning, error, critical, alert, emergency. | info |
| ACTION1_CLIENT_SECRET | Yes | OAuth2 client secret. Shown once at credential creation. | |
| MCP_HTTP_ALLOWED_ORIGINS | No | Comma-separated allowlist for browser Origin headers. Required when binding to a non-loopback host — the server hard-fails to start otherwise. | |
| ACTION1_ALLOW_DESTRUCTIVE | No | Set to true / 1 / yes to allow tools with destructiveHint: true to mutate state. | false |
| ACTION1_DEFAULT_RETRY_MINUTES | No | Window during which Action1 retries when an endpoint is offline. | 1440 |
| ACTION1_DEFAULT_TIMEOUT_MINUTES | No | Per-action timeout (PowerShell, etc.). | 10 |
| ACTION1_LAST_SEEN_STALE_MINUTES | No | Minutes since last_seen before an endpoint is treated as offline (range 1–1440). | 10 |
| ACTION1_DESTRUCTIVE_AUTO_CONFIRM | No | Single-operator only: waives the per-call confirm: YES requirement. dry_run still defaults to true — pass dry_run: false to actually execute. Still requires ACTION1_ALLOW_DESTRUCTIVE=true. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| action1_list_organizationsB | List every organization the configured API key can access. |
| action1_list_endpointsA | List endpoints with server-side filters (status, online_status, os, reboot_required, …). For counts, use action1_endpoints_summary instead. |
| action1_endpoints_summaryA | Walks every endpoint and returns counts (total, by status/platform/OS/online, reboot_required). ~1 KB output regardless of fleet size. |
| action1_get_endpointA | Fetch the general info block for a single endpoint, plus derived platform and connectivity.online flags. |
| action1_search_endpointsA | Case-insensitive substring search restricted to hostname, user, OS and status fields. Walks the endpoint list page by page and matches client-side. |
| action1_list_missing_updatesB | Returns missing-update items for one endpoint. Each item.id can be passed to action1_deploy_update. |
| action1_list_vulnerabilitiesA | Returns vulnerability findings for one endpoint. Returns a clear 403 if the API key lacks the vulnerabilities scope. |
| action1_list_action_templatesA | List every action template (id, name, description). Use ids with action1_get_action_template. |
| action1_get_action_templateA | Fetch full details (parameters, supported platforms) for a single action template by id. |
| action1_list_recent_automationsA | List recent automation instances for the org. For counts use action1_automations_summary instead. |
| action1_automations_summaryA | Walks up to max_scan (default 1000) automation instances and returns counts (by_status, success/warning/failure); has_more: true means instances beyond max_scan were not counted. Instance lists carry no actions, so there is no per-template count. ~1 KB output. |
| action1_run_powershellB | Run PowerShell on a Windows endpoint via the run_powershell template. Runs as SYSTEM (no user profile). |
| action1_run_bash_macosA | Run a Bash script on a macOS endpoint via the run_script template. For OS-aware routing use action1_run_script. |
| action1_run_scriptA | Cross-platform script runner. Routes to PowerShell (Windows) or Bash (macOS); errors on Linux/unknown. For target_type='EndpointGroup' pass os ('windows' or 'macos'). |
| action1_reboot_endpointA | Reboots the host via the reboot action template. Combine with action1_wait_for_automation to track recovery. |
| action1_deploy_updateC | Deploy one or more updates (by package id) via the deploy_update template. |
| action1_deploy_packageA | Deploy software via the deploy_package template. Use action1_get_action_template for the params schema. |
| action1_uninstall_programA | Uninstall software via the uninstall_program template. Use action1_get_action_template for the params schema. |
| action1_run_data_collectionC | Trigger the run_data_collection template on an endpoint. |
| action1_get_automation_statusA | Returns the high-level status of one automation instance. For stdout use action1_get_automation_output. |
| action1_get_automation_resultsB | Per-endpoint result rollup for an instance. Use action1_get_automation_output for stdout. |
| action1_get_automation_outputA | Returns filtered stdout for one endpoint of an automation instance. Strips Action1 status markers. |
| action1_wait_for_automationA | Block until an automation instance reaches a terminal status (Stopped/Success/Warning/Error) or timeout. |
| action1_execute_and_waitA | One-shot helper: starts an action (auto-routes by OS for 'script', or runs a template), polls until terminal, returns filtered output. |
| action1_create_organizationC | Create an organization. Creates a new organization. Perm: manage_organizations. |
| action1_get_meC | Get the current user settings. Gets settings for the currently authenticated user. |
| action1_update_meC | Update the current user settings. Updates settings for the currently authenticated user. |
| action1_searchC | Search. Perm: view_endpoints, view_software_repository, view_reports. |
| action1_get_endpoints_onboarded_statusB | Check endpoint status. Retrieves information if any endpoints were added to an organization. |
| action1_get_agent_install_urlA | Get the URL for agent installation. In order to manage an endpoint, the Action1 agent needs to be installed on it first. Perm: manage_endpoints. |
| action1_update_endpointB | Change an endpoint comment or name. Changes the user-defined 'comment', 'name' and custom attributes for the specified endpoint. Perm: manage_endpoint_attributes. |
| action1_delete_endpointB | Delete an endpoint. Removes a specified endpoint and attempts to uninstall its agent. Perm: manage_endpoints. |
| action1_move_endpointB | Move the endpoint to another organization. Moves the endpoint to another organization. Perm: manage_endpoints. |
| action1_list_endpoint_missing_updatesA | Filtered/paginated variant of action1_list_missing_updates (curated). Use for severity/approval_status/sortby filtering. Get missing updates for an endpoint. Obtains a list of missing software updates for a specific endpoint. Perm: view_endpoints. |
| action1_list_endpoint_groupsB | List endpoint groups. Lists existing endpoint groups. Use filters and narrow down and sort the returned results. Perm: view_endpoints. |
| action1_create_endpoint_groupA | Create a new group. Creates a new endpoint group within the specified organization. Perm: manage_endpoints. |
| action1_get_groupB | Get an endpoint group. Gets a specific endpoint group by its ID. Perm: view_endpoints. |
| action1_update_groupC | Change group settings. Changes settings for an existing endpoint group in the specified organization. Perm: manage_endpoints. |
| action1_delete_groupB | Delete an endpoint group. Deletes an existing group in the specified organization. Perm: manage_endpoints. |
| action1_list_group_contentsB | List endpoints from the group. Lists all endpoints included in the specified group. Perm: view_endpoints. |
| action1_create_endpoint_remote_sessionB | Start a new remote session. Sends a request to the endpoint to start a new remote session. Perm: remote_connect. |
| action1_get_remote_sessionB | Get a remote session. Gets details for an existing remote session specified by ID. Perm: remote_connect. |
| action1_update_remote_sessionB | Switch a current monitor. Changes the 'current_monitor' parameter for a specific remote session. Perm: remote_connect. |
| action1_get_endpoint_discovery_settingsB | Get Agent Deployment settings. Obtains the current Agent Deployment settings in a specified organization. Perm: manage_endpoints. |
| action1_update_endpoint_agent_deploymentB | Update Agent Deployment settings. Updates the Agent Deployment configuration for a specific organization. Perm: manage_endpoints. |
| action1_list_endpoint_deployersB | List Deployers. Lists all Action1 Deployer services in the specified organization. Perm: manage_endpoints. |
| action1_get_windows_deployer_urlB | Get Deployer installation URL. Obtains an URL to download the Deployer installation file. Perm: manage_endpoints. |
| action1_get_deployerA | Get a specific Deployer. Obtains the current information about the specified Action1 Deployer service. Perm: manage_endpoints. |
| action1_delete_deployerC | Delete Deployer. Perm: manage_endpoints. |
| action1_list_data_sourcesB | List data sources. Gets a list of existing data sources. To filter out built-in data sources, set the 'builtin'. Perm: manage_data_sources, manage_reports. |
| action1_create_data_sourceB | Create a data source. Creates a new custom data source. At this time, all data sources are enterprise-wide. Perm: manage_data_sources. |
| action1_get_data_sourceB | Get a specific data source. Gets details about a specific data source. Perm: manage_data_sources, manage_reports. |
| action1_update_data_sourceC | Update a custom data source. Updates a custom data source specified by its ID. Perm: manage_data_sources. |
| action1_delete_data_sourceA | Delete a custom data source. Deletes an existing custom data source. Note that you cannot remove built-in data sources. Perm: manage_data_sources. |
| action1_list_scriptsB | List scripts. Gets a list of existing scripts from the Script Library. Perm: use_scripts. |
| action1_create_scriptB | Create a custom script. Creates a new custom script and adds it to the Script Library. Perm: manage_scripts. |
| action1_get_scriptB | Get a specific script. Gets details for a script specified by its ID. Perm: use_scripts. |
| action1_update_scriptA | Update a custom script. Updates details for an existing custom script specified by its ID. Perm: manage_scripts. |
| action1_delete_scriptB | Delete a custom script. Deletes an existing custom script specified by its ID. Perm: manage_scripts. |
| action1_list_setting_templatesC | List setting templates. Gets a list of existing setting templates. |
| action1_get_setting_templateC | Get a setting template. Gets details about a setting template specified by its ID. |
| action1_list_settingsA | List settings. Lists all existing settings. At this time, all settings are enterprise-wide. Perm: manage_advanced_settings. |
| action1_create_settingB | Create a new setting. Creates a new setting. At this time, all setting templates are enterprise-wide. Perm: manage_advanced_settings. |
| action1_get_settingC | Get setting configuration. Gets details about the setting configuration. Perm: manage_advanced_settings. |
| action1_update_settingA | Update a setting. Updates an existing setting specified by its ID. Perm: manage_advanced_settings. |
| action1_delete_settingB | Delete a setting. Deletes an existing setting specified by its ID. Perm: manage_advanced_settings. |
| action1_list_reportsC | List reports. Gets a list of existing reports. At this time all reports are enterprise-wide. |
| action1_get_report_or_categoryC | List reports and categories. Gets a list of reports and categories. At this time all reports are enterprise-wide. |
| action1_create_reportA | Create a custom report. Creates a custom report in the predefined Custom report category. Perm: manage_reports. |
| action1_update_reportC | Update a custom report. Updates a custom report. You cannot changes a custom report's category. Perm: manage_reports. |
| action1_delete_reportA | Delete a custom report. Deletes a custom report specified by its ID. Perm: manage_reports. |
| action1_list_report_dataB | Get report rows. Gets data organized by report rows. Use parameters to filter out returned results. Perm: view_reports. |
| action1_list_report_errorsB | Get report errors. Returns report errors for the specified report. Perm: view_reports. |
| action1_get_export_for_reportC | Export a report. Exports data from the report. Use parameters to filter out exported data. Perm: view_reports. |
| action1_requery_reportA | Re-querying a report. This API method initiates an asynchronous update ("requery") of the report's underlying data source. Perm: view_reports. |
| action1_get_drilldown_for_report_rowC | Drill down to details. Expands report details to provide more information. Perm: view_reports. |
| action1_get_export_for_report_rowC | Export report details. Exports reports data. Use parameters to filter out exported data. Perm: view_reports. |
| action1_list_software_repositoryB | List Software Repository packages. Gets a list of Software Repository packages for the entire enterprise. Perm: view_software_repository. |
| action1_create_packageB | Create new Software Repository package. Create a new custom Software Repository package object (with no versions) and set its initial basic. Perm: manage_software_repository. |
| action1_get_software_repository_packageA | Get Software Repository package settings. Gets details for a Software Repository package specified by its ID. Perm: view_software_repository. |
| action1_update_packageB | Update Software Repository package settings. Perm: manage_software_repository. |
| action1_delete_packageB | Delete custom Software Repository package. Deletes a custom Software Repository package specified by its ID. Perm: manage_software_repository. |
| action1_clone_packageA | Clone Software Repository package. Creates a full copy of an existing Software Repository package under a new package ID. Perm: manage_software_repository. |
| action1_create_package_versionB | Create new version in Software Repository package. Adds a new version to the specified Software Repository package. Perm: manage_software_repository. |
| action1_get_versionB | Get version in Software Repository package. Gets details about a package version specified by its ID. Perm: view_software_repository. |
| action1_update_versionC | Modify version in Software Repository package. |
| action1_delete_versionB | Delete version from Software Repository package. Deletes the specified version of the specified custom Software Repository package. Perm: manage_software_repository. |
| action1_delete_package_version_actionB | Delete additional action from version of Software Repository package. Perm: manage_software_repository. |
| action1_get_match_conflicts_for_software_repositoryA | Check for Software Repository package matching conflicts before creating a new package version. Perm: view_software_repository. |
| action1_get_match_conflicts_for_packageA | Check for package matching conflicts when editing and existing package version. Perm: view_software_repository. |
| action1_init_software_uploadC | Not supported by this server (see error text). Initialize package file upload. Initializes package file upload. The client starts by sending the initial upload request. Perm: manage_software_repository. |
| action1_upload_software_chunkC | Not supported by this server (see error text). Upload package file chunks. Uploads package file chunks. Perm: manage_software_repository. |
| action1_list_updatesC | List missing updates. Gets a list of all missing updates. Use parameters to filter out updates in the returned results. Perm: approve_updates, view_dashboards, manage_automations. |
| action1_get_update_packageB | List updates for a package. Gets a list of updates available for a package specified by its ID. Perm: approve_updates, view_dashboards, manage_automations. |
| action1_list_version_endpointsA | List endpoints missing a specific update. Gets a list of endpoints that are missing updates for a specific package and its version,. Perm: approve_updates, view_dashboards, manage_automations. |
| action1_create_approvalB | Manage updates approvals. Manages approval status for multiple packages in bulk. Perm: approve_updates. |
| action1_list_installed_software_dataC | Get installed apps. Gets a list of installed apps. Use parameters to filter out apps in the returned results. Perm: view_installed_software. |
| action1_requery_installed_software_for_orgB | Re-querying installed apps. This API method initiates an asynchronous update ("requery") of the installed software inventory. Perm: view_installed_software. |
| action1_list_installed_software_errorsC | Get apps report errors. Returns apps report errors. Use parameters to filter out returned results. Perm: view_installed_software. |
| action1_get_installed_software_endpointB | Get installed apps on a specific endpoint. Gets a list of installed apps on an endpoint specified by its ID. Perm: view_installed_software, view_endpoints. |
| action1_requery_installed_software_for_endpointB | Re-querying installed apps on a specific endpoint. Perm: view_installed_software, view_endpoints. |
| action1_list_automation_schedulesB | List automation schedules. Lists existing scheduled automations. Use parameters to filter out automations in the returned. Perm: view_automations. |
| action1_create_automation_scheduleA | Create a automation schedule. Schedules a new automation. The automation will be executed against a specified list of endpoints. Perm: manage_automations. |
| action1_get_automation_scheduleB | Get a specific automation schedule. Gets a scheduled automation specified by its ID. Perm: view_automations. |
| action1_update_automationB | Update a automation schedule. Perm: manage_automations. |
| action1_delete_automationB | Delete a automation schedule. Deletes a scheduled automation specified by its ID. Perm: manage_automations. |
| action1_list_automation_deployment_statusesB | Get the deployment statuses of a automation. Gets the deployment statuses of a automation specified by its ID. Perm: view_automations. |
| action1_delete_automation_actionB | Delete an action from a automation. Deletes a specified action from a scheduled automation. Perm: manage_automations. |
| action1_list_automation_instancesB | List automation instances. Gets a list of running and completed automations for the specified organization. Perm: view_automations. |
| action1_create_automation_instanceC | Apply a automation. Immediately runs an instance of the automation on the specified endpoints in the specified. Perm: run_automations. |
| action1_get_automation_instanceC | Get a specific instance. Gets details about a automation instance specified by its ID. Perm: view_automations. |
| action1_list_instance_endpoint_resultsC | List results. Gets a list of endpoints where the automation instance is being applied or has been executed. Perm: view_automations. |
| action1_get_automation_script_outputB | Raw automation-script output struct. For filtered stdout (status markers stripped) prefer action1_get_automation_output (curated). Get details of a specific endpoint. Gets details about the automation instance applied to an endpoint specified by its ID. Perm: view_automations. |
| action1_stop_instanceA | Stop a automation. Stops applying a automation instance and aborts actions running on a remote endpoint. Perm: manage_automations. |
| action1_list_logsC | Get diagnostic logs. Gets diagnostic logs. Use parameters to pre-filter returned results. Perm: manage_endpoints. |
| action1_get_subscriptionC | Get enterprise license information. Gets details about the enterprise license. Perm: manage_enterprise. |
| action1_request_enterprise_trialB | Request a free trial or its extension. Perm: manage_enterprise. |
| action1_request_enterprise_quoteB | Request a quote. Sends a quote request to the Action1 Sales department. Perm: manage_enterprise. |
| action1_get_subscription_usageB | Get usage statistics for an enterprise. Gets details about license usage for the entire enterprise. Perm: manage_enterprise. |
| action1_list_subscription_usage_organizationsB | Get usage statistics for organizations. Gets details about license usage with statistics for each organization individually. Perm: manage_organizations. |
| action1_get_org_subscription_usageB | Get usage statistics for a specific organization. Gets details about license usage for an organization specified by its ID. Perm: manage_organizations. |
| action1_list_rolesC | List roles. Gets a list of available roles. Perm: manage_roles. |
| action1_create_roleC | Create a role. Creates a new role. Perm: manage_roles. |
| action1_get_roleB | Get a specific role. Gets details about a role specified by its ID. Perm: manage_roles. |
| action1_update_roleA | Update a specific role. Updates a role specified by its ID. Perm: manage_roles. |
| action1_delete_roleB | Delete a specific role. Deletes a role specified by its ID. Perm: manage_roles. |
| action1_clone_roleB | Clone a role. Creates a copy of an existing role. Perm: manage_roles. |
| action1_list_role_usersB | List users in a specific role. Gets a list of users in a role specified by its ID. Perm: view_users, assign_roles, manage_roles. |
| action1_create_role_userB | Assign user to a specific role. Assigns user to a role specified by its ID. Perm: assign_roles. |
| action1_delete_role_userA | Unassign user from a specific role. Unassigns user from a role specified by its ID. Perm: assign_roles. |
| action1_list_permissionsC | List permission templates. Gets a list of available permission templates. |
| action1_get_enterpriseB | Get enterprise settings. Gets settings for an enterprise. You can query data for your enterprise only. |
| action1_update_enterpriseC | Update enterprise settings. Updates settings for a current enterprise. Perm: manage_enterprise. |
| action1_request_enterprise_closureA | Close the entire enterprise associated with Action1 account. The request is available only for a free Action1 account. Perm: manage_enterprise. |
| action1_revoke_enterprise_closureA | Revoke account closure. The Action1 enterprise will be immediately reactivated and all your data will be retained. Perm: manage_enterprise. |
| action1_update_organizationC | Update organization settings. Updates settings for an organization specified by its ID. Perm: manage_organizations. |
| action1_delete_organizationA | Delete an organization. Removes an organization from the enterprise. Perm: manage_organizations. |
| action1_list_report_subscriptionsC | List report subscriptions. Gets a list of report subscriptions. |
| action1_create_report_subscriptionC | Create a new report subscription. Creates a new report subscription. Perm: view_reports. |
| action1_update_report_subscriptionC | Update the report subscription. Updates the report subscription. Perm: view_reports. |
| action1_delete_report_subscriptionC | Delete the report subscription. Removes the report subscription. |
| action1_list_usersA | List users. Gets a list of users within the current Action1 enterprise. Perm: view_users. |
| action1_create_userC | Create new user. Creates a new user. To create an SSO user, please first review the following documentation: -. Perm: manage_users. |
| action1_get_userC | Get user. Gets an existing user. Perm: view_users. |
| action1_update_userC | Update user. Updates an existing user. Perm: manage_users. |
| action1_delete_userC | Delete user. Deletes an existing user. Perm: manage_users. |
| action1_list_user_rolesA | List the roles assigned to a user. Retrieves all roles assigned to a user specified by ID. Perm: manage_users. |
| action1_list_org_vulnerabilitiesA | Org-wide CVE rollup with 13 server-side filters. For per-endpoint vulnerabilities use action1_list_vulnerabilities (curated). List of all vulnerable software within the organization. Perm: view_vulnerabilities. |
| action1_list_cve_endpointsA | Lists endpoints in an organization affected by a specific vulnerability. Perm: view_vulnerabilities. |
| action1_get_cveB | Detailed information on a specific vulnerability within an organization, including CVE details like attack vector. Perm: view_vulnerabilities. |
| action1_get_cve_descriptionB | Detailed information on a specific vulnerability in general (not for an organization), including CVE details like attack vector. Perm: view_vulnerabilities. |
| action1_list_cve_remediationsB | Lists past remediation actions for a specific vulnerability. Perm: view_vulnerabilities. |
| action1_create_cve_remediationB | Documents applied compensating controls for a specific vulnerability. Perm: manage_vulnerabilities. |
| action1_update_remediationB | Updates record of compensating controls when remediation changes. Perm: manage_vulnerabilities. |
| action1_delete_remediationB | Deletes remediation record of compensating controls. Perm: manage_vulnerabilities. |
| action1_list_audit_eventsB | Get audit records of user actions. 'The Audit Trail contains event records associated with user actions, such as logins, remote. Perm: view_audit. |
| action1_export_audit_logC | Export of audit trail data. Exports audit data. Use parameters to filter out exported data. Perm: view_audit. |
| action1_get_audit_eventC | Get an audit record by its ID. Get a specific audit record by its ID. Perm: view_audit. |
| action1_endpoint_groups_resolveA | Look up an endpoint group by name or UUID using exact-id/exact-name/starts-with/contains. |
| action1_software_inventory_for_endpointA | Fetch installed-software inventory for one endpoint, with optional name substring filter. |
| action1_recurring_schedulesB | List recurring automations with optional client-side filters (status, template_id, group id substring). |
| action1_audit_log_searchA | Search /audit/events with an optional time window (sent to Action1 as timefrom/timeto) and case-insensitive substring filters on user, event and object. |
| action1_report_exportB | Resolve a report by name or UUID, then return JSON rows or a CSV export blob. |
| action1_cve_remediation_planA | Read-only correlation of vulnerabilities and the updates that fix them. Does NOT execute; pass the result to action1_deploy_update. |
| action1_add_endpoint_to_groupB | Add a single endpoint to an endpoint group. POSTs the spec array body [{method:POST,data:{endpoint_id,type}}] to /endpoints/groups/{org}/{group}/contents. Re-adding an existing member is a no-op. |
| action1_remove_endpoint_from_groupA | Remove a single endpoint from an endpoint group. POSTs the spec array body [{method:DELETE,endpoint_id}] to /endpoints/groups/{org}/{group}/contents (there is no DELETE verb or /contents/{id} sub-path). |
| action1_raw_requestA | Generic passthrough to any Action1 API path. Bypasses per-tool schemas; use only when no dedicated tool exists. GET/HEAD run free; POST/PUT/PATCH/DELETE require the destructive guard (ACTION1_ALLOW_DESTRUCTIVE + confirm:YES + dry_run-default-true) and, as account operations, ACTION1_ALLOW_ACCOUNT_OPS. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| patch-windows-fleet | Walks through resolving an endpoint group, picking the missing-update set, previewing the deploy, and executing it once you confirm. |
| audit-vulnerabilities | Surveys org-wide vulnerabilities, ranks the worst, builds a remediation plan, presents it for approval - no execution by default. |
| triage-offline-endpoints | Walks the endpoint inventory and surfaces hosts whose status or last_seen suggest they are not actually online. |
| run-script-fleetwide | Runs the supplied script (PowerShell with os=windows, Bash with os=macos) on every member of a group. Read-only by default, guard rails on. |
| software-inventory-sweep | Find every endpoint that has (or doesn't have) a given software package installed. |
| check-my-permissions | Reads the /me identity, lists the granted permissions, and flags which tool families will 403 with this role. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| me | The authenticated API user (GET /me). Useful as a startup probe - agents can read this to know which permissions / role they have before calling potentially-403 tools. |
| organizations | All organizations the configured API key can access (GET /organizations). |
| templates | All action templates (run_powershell, run_script, deploy_update, …) with their parameter shapes (GET /automations/action-templates). |
| reports | All reports the API key can see (GET /reports/all). Use action1_report_export to fetch one by id or name fragment. |
TDQS
Scored across 167 tools
The set contains many overlapping tools: list_missing_updates vs list_endpoint_missing_updates, list_vulnerabilities vs list_org_vulnerabilities, list_endpoints vs search_endpoints, and multiple automation instance/output/summary tools. Curated aliases and generic tools like raw_request further blur boundaries, making misselection likely despite helpful descriptions.
Most tools use a consistent action1_ prefix and snake_case, but the naming pattern is mixed: many are verb_noun, while others are noun-style or summary/resolve/export helpers. The inconsistency is readable but not predictable enough for a large toolset.
With 167 tools, this far exceeds a practical surface for an agent, even for a broad RMM platform. The count creates selection burden and increases the chance of using near-duplicate or wrong-domain tools.
Coverage is very broad across endpoints, organizations, users, roles, scripts, reports, software repository, automations, vulnerabilities, audit, and subscriptions. Some lifecycle gaps remain, such as unsupported software upload tools and partial automation action/version management, but most core workflows are covered.