action1-mcp-server
An MCP server that exposes the Action1 RMM REST API to an AI host (Claude, Cursor, etc.) so it can read your fleet, run scripts, deploy updates and reboot endpoints — with every state-changing tool behind a dry-run + confirm: "YES" guard that is off by default.
Fleet discovery (read-only): list organizations, endpoints, endpoint groups and group contents; get a single endpoint with derived platform/online flags; substring-search endpoints; server-side summaries of endpoints and automations that stay ~1 KB regardless of fleet size.
Inventory insights (read-only): list missing updates (per endpoint and fleet-wide, filterable by severity/approval status), vulnerabilities, installed software, action templates, setting templates, reports, report rows/errors, data sources, scripts, software-repository packages and their versions, deployers, remote sessions, and audit-style searches.
Script execution (destructive, guarded):
action1_run_powershell(auto-fills success exit codes),action1_run_bash_macos(fills the tenrun_scriptfields), andaction1_run_scriptwhich auto-routes by endpoint OS; all support single-endpoint orEndpointGroupfan-out.Remediation actions (destructive, guarded): deploy updates, deploy packages, uninstall programs, run data collection, and reboot endpoints.
Polling & results (read-only): get automation status, per-endpoint results, filtered stdout (strips Action1 lifecycle markers), and block-and-wait until an automation reaches a terminal state.
One-shot workflow:
action1_execute_and_waitstarts a script or template, polls to completion and returns the filtered output.High-level wrappers: fuzzy group-name → UUID resolver, per-endpoint software inventory, recurring schedules, audit log search, report export, and CVE remediation planning.
Full API coverage: every operation of the pinned Action1 OpenAPI snapshot is reachable via a generated verb-first tool (e.g.
action1_list_endpoint_groups,action1_create_script,action1_update_package) unless a curated tool supersedes it; all mutating ones carry the same guard.Safety & scoping controls:
ACTION1_ALLOW_DESTRUCTIVE/ACTION1_ALLOW_ACCOUNT_OPSenv switches,ACTION1_ALLOWED_ORG_IDSallowlist,ACTION1_TOOLSETS=readfor read-only mode, PII redaction, dry-run previews, and per-callconfirm: "YES".Agent-friendly output: every read tool accepts
response_format(markdown or json), declares anoutputSchema, and paginates withcount,has_more,next_cursor,total; unknown arguments are rejected.Extras: MCP resources (
action1://me,action1://endpoints/{orgId}, etc.) and slash prompts (/patch-windows-fleet,/audit-vulnerabilities,/triage-offline-endpoints,/check-my-permissions) for multi-step jobs, over stdio or Streamable HTTP.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@action1-mcp-server list endpoints offline for more than 24 hours"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
action1-mcp-server
An unofficial Model Context Protocol (MCP) server for the Action1 RMM REST API. It lets Claude (or any other MCP host) query your Action1 fleet, run PowerShell on Windows and Bash on macOS, deploy updates, reboot endpoints, search audit trails and build CVE remediation plans, with a guard that keeps state changes off unless you switch them on.
Unofficial project. This server is not affiliated with, endorsed by, sponsored by or supported by Action1 Corporation. "Action1" is a trademark of Action1 Corporation. See
NOTICE.
Status
Every operation of the pinned Action1 OpenAPI snapshot is reachable
through a tool (see What is covered). The server
speaks stdio and Streamable HTTP and ships as an MCPB bundle for Claude
Desktop and as the npm package action1-mcp-server. Releases and their changes: CHANGELOG.md.
Validation status
Read this before you let an agent change anything in your fleet.
Automated tests (
npm test) run against mocked Action1 responses: unit tests, MCP protocol round trips through the SDK client, the destructive-guard truth table, redaction and size limits. Every generated tool that changes state is driven through MCP to prove it is guarded. These tests run in CI on Node 22, 24 and 26.Live runs against a real Action1 tenant are recorded in
TESTING.md. They were made while versions 0.1 to 0.3 were developed and were not dated. They cover the read tools (organizations, endpoints, pagination, templates, missing updates), read-only script execution on Windows and macOS (action1_execute_and_wait,action1_run_script) and the guard's refusal paths.Read-only live shape check (2026-10-26) for 0.6.0: GET requests against a real tenant compared the returned record shapes with the vendored spec. Endpoints, vulnerabilities, installed software, automation instances and schedules, missing updates, endpoint groups and both list envelopes match the spec; audit events are still unverified (the key lacked
view_audit). Details inTESTING.md. Apart from this check, the changes in 0.6.0 are covered by the automated tests only; a live smoke run of the 0.6.0 tools is pending.Never run against a live tenant:
action1_reboot_endpoint,action1_deploy_update,action1_deploy_package,action1_uninstall_program,action1_run_data_collection, removing an endpoint from a group,action1_run_scriptwithtarget_type: "EndpointGroup", every generated tool that changes state, and every account operation (users, roles, organizations, enterprise). Their request bodies follow the Action1 OpenAPI spec and are checked by tests, but nobody has confirmed that Action1 accepts them. Try them on a test endpoint first and look at the dry-run preview before you execute.
Maintenance status
Maintained on a best-effort basis by one maintainer (@mguttmann) in spare time. The author uses it in production. There is no support contract and no guaranteed response time.
Security fixes take priority over features. Report vulnerabilities privately (see Security).
Dependency updates come from Dependabot; CI fails when a runtime dependency has a known high or critical advisory. A weekly job reports when Action1 serves a different API spec than the pinned snapshot.
Only the latest minor release gets fixes.
Issues and pull requests are welcome; see
docs/CONTRIBUTING.mdand the Code of Conduct.
Related MCP server: atera-mcp
Why this project
Action1 has a clean REST API, but a few quirks silently produce wrong results when an LLM calls it naively:
macOS Bash actions need a ten-field
run_scriptpayload; the API answersnot applicable to Mac platformfor any missing field.Windows PowerShell actions need a non-empty
success_exit_codes.last_seenisYYYY-MM-DD_HH-MM-SS(UTC), not ISO-8601, soDate.parsereturnsNaN. The server parses it and renders it readable.The
selfURL of a list item contains a/generalsegment that is not a real REST resource.Script output is interleaved with
Starting/Waiting/Completedlifecycle markers that need to be filtered.OSis upper-case andplatformlower-case, and both can carry the platform string; one detector normalises them.
The curated tools encode all of these. What the server does not cover is
listed in docs/api-coverage-gaps.md.
Install
Claude Desktop: MCPB bundle (recommended)
Download
action1-mcp-<version>.mcpbfrom the project's GitHub Releases. The release workflow attaches it to every version tag.Double-click it (or drag it onto Claude Desktop, or use Settings > Extensions > Install from file).
Fill in the wizard: API base URL of your region, organization ID, client ID and client secret, and whether destructive operations are allowed (leave this off at first).
Claude Desktop runs the bundle with its built-in Node.js. Details and
troubleshooting: docs/INSTALLATION.md.
MCP Registry
The release workflow lists each stable release in the official
MCP Registry as
io.github.mguttmann/action1-mcp: the bundle (download URL and SHA-256
of the release asset) and, from 0.6.2 on, the npm package
action1-mcp-server, both with the same environment variables. MCP hosts and
directories that read the registry can install it from there. Only that
name is this project; Action1 servers under other namespaces are
different code.
glama.json names the maintainer of the
Glama listing.
From source (any MCP host)
Requires Node.js 22.12 or newer (engines in package.json); CI tests
Node 22, 24 and 26.
git clone https://github.com/mguttmann/action1-mcp.git
cd action1-mcp
npm ci
cp .env.example .env # fill in your Action1 credentials
npm run build # compiles to dist/ (tsc only)Attach it to Claude Code:
claude mcp add action1 -- node --env-file=$(pwd)/.env $(pwd)/dist/index.jsnpm run inspector opens the MCP Inspector against the built server
(needs Node 22.19 or newer). Other hosts (Claude Desktop with a JSON
config, Claude.ai, Cursor, Continue.dev, Cody) are covered in
docs/INSTALLATION.md.
npm (npx, any stdio MCP host)
The server is published on npm as
action1-mcp-server
(command action1-mcp). Only that exact name is this project. npx
fetches and runs it, so no clone or build is needed; Node.js 22.12 or
newer must be installed.
Attach it to Claude Code (the values land in Claude Code's own configuration; type them in your shell, never into a chat):
claude mcp add action1 \
-e ACTION1_BASE_URL=https://app.eu.action1.com/api/3.0 \
-e ACTION1_ORG_ID=<your-org-uuid> \
-e ACTION1_CLIENT_ID=<client-id> \
-e ACTION1_CLIENT_SECRET=<client-secret> \
-- npx -y action1-mcp-serverAny other stdio host takes the same command in its JSON configuration:
{
"mcpServers": {
"action1": {
"command": "npx",
"args": ["-y", "action1-mcp-server"],
"env": {
"ACTION1_BASE_URL": "https://app.eu.action1.com/api/3.0",
"ACTION1_ORG_ID": "<your-org-uuid>",
"ACTION1_CLIENT_ID": "<client-id>",
"ACTION1_CLIENT_SECRET": "<client-secret>"
}
}
}
}A configuration file with these values holds the credential: keep it
readable for your user only and out of version control.
action1-mcp-server@<version> pins a version. For Claude Desktop the
MCPB bundle stays the recommended path: its wizard keeps the client ID
and secret in Claude Desktop's secure storage. More hosts and options:
docs/INSTALLATION.md.
What is covered
Generated tools: every operation of the pinned Action1 OpenAPI snapshot (date in
src/codegen/spec/SOURCE.md) becomes a verb-first tool such asaction1_list_endpoint_groups, unless a curated tool covers it. Exceptions:POST /oauth2/tokenis used internally and not exposed, and the two package-upload operations return an explanatory error because they need a binary body. The full mapping is generated intodocs/_coverage_table.md;docs/api-coverage.mdexplains it.Curated tools for the common workflows, including high-level wrappers (CVE remediation plan, audit log search, software inventory, recurring schedules, report export, group resolver).
Resources (
action1://me,action1://orgs,action1://templates,action1://reports,action1://endpoints/{orgId},action1://groups/{orgId},action1://vulnerabilities/{orgId}) for hosts that pre-fetch context.Slash prompts for multi-step jobs (
/patch-windows-fleet,/audit-vulnerabilities,/triage-offline-endpoints,/run-script-fleetwide,/software-inventory-sweep,/check-my-permissions).
tests/unit/specSha.test.ts ties the generated tools to the pinned
snapshot. It does not see changes at Action1; npm run spec:check and a
weekly CI job compare the snapshot with the spec Action1 serves.
Highlights
Guarded state changes. Tools that change state need
ACTION1_ALLOW_DESTRUCTIVE=true, default to a dry-run preview and needconfirm: "YES"to execute. Account operations need a second switch. See Destructive guard.Scoping.
ACTION1_ALLOWED_ORG_IDSlimits which organizations the tools may address;ACTION1_TOOLSETS=readregisters only read-only tools.Output for agents. Every read-only tool accepts
response_format(markdowndefault,json); every tool sets all four MCP annotations and declares anoutputSchema. Paginated results carrycount,has_more,next_cursor, andtotalon the final page. Results stay under the 1 MB host limit with visible truncation notes.Strict inputs. Unknown or misspelled arguments are rejected with a validation error instead of being ignored.
Auth. OAuth2 client credentials with proactive refresh, deduplicated concurrent token requests and a refresh-token fallback.
Transport safety. Reads (GET/HEAD) are retried on network errors, HTTP 5xx and 429 (honouring
Retry-After). Mutations are sent once and retried only on 429 or when the connection failed before the request was sent, so a retry never runs an action twice. Every Action1 call is bounded byACTION1_REQUEST_TIMEOUT_MS.Two transports. stdio (default) and stateless Streamable HTTP, both serving MCP 2026-07-28 next to the 2025 revisions (ADR 0001). HTTP requires a bearer token, checks
HostandOriginagainst DNS rebinding, limits bodies to 1 MB and rate-limits per client IP.Logs. Structured JSON lines on stderr with credential redaction, one
tool_callline per call and audit lines for guarded operations. Stdout is reserved for MCP.
Architecture
+----------------------------------------------------------------------+
| Curated tools and workflow wrappers |
| - script execution (Windows, macOS, OS-aware routing) |
| - execute_and_wait (start + poll + filtered output) |
| - get_endpoint (canonical path + list fallback) |
| - CVE remediation plan, audit log search, software inventory, ... |
+----------------------------------------------------------------------+
| Generated tools |
| - one tool per remaining spec operation, verb-first snake_case |
| - shared runtime: pagination, destructive guard, error mapping |
| - Action1 OpenAPI 3.1 snapshot, SHA-pinned (spec/openapi.sha256) |
+----------------------------------------------------------------------+
| Shared infrastructure |
| - Action1Client (auth, retry, timeouts, path safety, error mapping) |
| - TokenProvider (refresh_token fallback, proactive refresh) |
| - destructive guard, org allowlist, toolset filter |
| - structured stderr logger with redaction |
| - Markdown table renderer, response size budgets |
+----------------------------------------------------------------------+When a generated tool would get the same name as a curated tool, the code
generator (src/codegen/generate.ts) drops the generated one; operations
listed in SKIP_OPERATION_IDS (src/codegen/curated-overrides.ts) are
skipped as well. Design decisions are recorded in
docs/adr/.
Configuration
All configuration is via environment variables. Copy
.env.example to .env and fill it in; empty values mean
"use the default". node dist/index.js --help lists the same variables.
Variable | Default | Description |
| required | API base URL of your region, see below. |
| required | OAuth2 client ID from Action1 > Settings > API Credentials. |
| required | OAuth2 client secret, shown once when the credential is created. |
| unset | Default organization UUID; tools can override it with |
| any | Comma-separated organization UUIDs the tools may address; others are refused. Recommended for HTTP and shared setups. |
|
| With |
|
|
|
|
| Also allows account operations: changes to users, roles, |
|
| Isolated single-operator setups only: drops the per-call |
|
|
|
|
| Masks user names, IP and MAC addresses, other addresses, serial numbers, e-mail addresses, Active Directory fields and personal names in tool output (also report columns such as |
|
| Default script timeout, 0 to 10080. |
|
| How long Action1 retries an action for an offline endpoint, 0 to 10080. |
|
| Minutes since |
|
| Budget for one Action1 API call including retries, 1000 to 600000. |
|
| Timeout for one OAuth token attempt, 1000 to 600000. |
|
|
|
|
| HTTP mode: listen port. |
|
| HTTP mode: bind address. |
| required for | Bearer token clients must send, at least 16 characters ( |
|
| HTTP mode without a token; loopback binds only, local development. |
| loopback and bind address | Extra |
| loopback origins | Browser |
|
| Express |
Action1 regions (ACTION1_BASE_URL):
Region | Base URL |
Europe |
|
North America |
|
North America 2 |
|
United Kingdom |
|
Australia |
|
Connecting to MCP hosts
Host | Transport | Doc |
Claude Code (CLI) | stdio | |
Claude Desktop (macOS / Windows) | MCPB bundle or stdio | |
Claude.ai (web) | Streamable HTTP | |
Cursor | stdio | |
Continue.dev / Cody | stdio |
Tools
docs/USAGE.md is the tool reference and
docs/EXAMPLES.md has end-to-end recipes. The curated
layer in short:
Discovery (read-only)
action1_list_organizations, action1_list_endpoints,
action1_endpoints_summary (server-side counters, small output regardless
of fleet size), action1_get_endpoint (canonical path with list fallback,
plus derived platform and connectivity.online),
action1_search_endpoints (substring filter on hostname, user, OS,
status), action1_list_action_templates, action1_get_action_template,
action1_list_missing_updates, action1_list_vulnerabilities,
action1_list_recent_automations, action1_automations_summary.
Execution (destructive, guarded)
action1_run_powershell (Windows; fills success_exit_codes),
action1_run_bash_macos (macOS; fills the ten run_script fields),
action1_run_script (routes by OS), action1_reboot_endpoint,
action1_deploy_update, action1_deploy_package,
action1_uninstall_program, action1_run_data_collection. All accept
target_type: "Endpoint" (default) or "EndpointGroup";
action1_run_script then also needs os ("windows" or "macos"),
because a group has no single OS to detect.
Polling and results (read-only)
action1_get_automation_status, action1_get_automation_results,
action1_get_automation_output (filters lifecycle markers),
action1_wait_for_automation.
Workflows (destructive, guarded)
action1_execute_and_wait: start an action, poll until it ends and return
the filtered output. Routes by OS in mode: "script" or runs a named
template in mode: "template".
High-level wrappers
action1_endpoint_groups_resolve (fuzzy group name to UUID),
action1_software_inventory_for_endpoint, action1_recurring_schedules,
action1_audit_log_search, action1_report_export,
action1_cve_remediation_plan.
Generated
Every remaining Action1 API operation as a verb-first snake_case tool;
input parameter names are normalised to snake_case. See
docs/api-coverage.md.
Destructive guard
A tool flagged destructiveHint: true executes only when all of these
hold:
ACTION1_ALLOW_DESTRUCTIVE=true server env, restart required
ACTION1_ALLOW_ACCOUNT_OPS=true server env, only for account operations
confirm: "YES" per call, exact (waived by auto-confirm)
dry_run: false per call, the default is true (preview)// Preview only (default)
{ "tool": "action1_run_powershell",
"arguments": { "endpoint_id": "<uuid>", "script_text": "Get-Date" } }
// -> { "dry_run": true, "would_send": { method, path, body } }
// Execute (server env: ACTION1_ALLOW_DESTRUCTIVE=true)
{ "tool": "action1_run_powershell",
"arguments": { "endpoint_id": "<uuid>", "script_text": "Get-Date",
"dry_run": false, "confirm": "YES" } }confirm and dry_run are arguments the model sets itself. They stop
accidents, not a model that follows instructions hidden in Action1 data
(hostnames, script output, audit texts). The controls that hold against
that are the ones the model cannot change: the environment switches,
ACTION1_ALLOWED_ORG_IDS, ACTION1_TOOLSETS=read, the role of the API
credential, and your MCP host's per-tool approval. Do not "always allow"
destructive tools in your host. See docs/SECURITY.md
for the threat model.
Examples
More in docs/EXAMPLES.md:
# 1. Fleet health check
> "How many endpoints are online and how many need a reboot?"
agent -> action1_endpoints_summary
# 2. Read-only PowerShell on one Windows host
> "What's the OS build of <hostname>? Run Get-ComputerInfo OsBuildNumber."
agent -> action1_search_endpoints { query: "<hostname>", fields: ["hostname"] }
agent -> action1_run_powershell { endpoint_id: <uuid>,
script_text: "Get-ComputerInfo OsBuildNumber",
dry_run: false, confirm: "YES" }
agent -> action1_wait_for_automation { instance_id: <id>, endpoint_id: <uuid> }
# 3. CVE remediation plan
> "What's needed to remediate CVE-2024-XXXX?"
agent -> action1_cve_remediation_plan { cve_id: "CVE-2024-XXXX" }
agent -> action1_deploy_update { ... } (after operator confirmation)Rate limits
Action1 does not publish a rate limit. During development about 10 requests per second on the EU instance did not trigger HTTP 429; that is an observation, not a guarantee. If Action1 answers 429:
The client honours
Retry-After(capped at 60 s), for reads and mutations alike, because a 429 means the request was not processed.For mass actions prefer
target_type: "EndpointGroup"over one call per endpoint; Action1 fans out server-side.
The server has no outgoing throttle and does not cache list responses.
The retry policy is in src/client/action1Client.ts.
Required Action1 permissions
The tools can only do what the role of the API credential allows.
docs/permissions.md lists the permission each
operation needs, generated from the permission tags in the pinned spec.
Grant only what the tools you use need. Read action1://me or run the
/check-my-permissions prompt to see what the configured credential can
do before an agent tries a destructive operation.
Documentation
File | What it covers |
Step-by-step setup for every supported MCP host. | |
Tool reference for the curated and wrapper layers, resources, prompts, output format, cancellation, logging. | |
End-to-end recipes (patching, triage, CVE remediation). | |
stdio, HTTP behind a reverse proxy, systemd, MCPB, production checklist. | |
Threat model, destructive guard, data flow to the LLM, reporting vulnerabilities. | |
Action1 permission per operation and tool (generated). | |
Common failure modes and fixes. | |
Questions across topics. | |
Development setup, codegen workflow, tests, pull requests. | |
How spec operations map to tools; full table in | |
What the server does not cover, or covers only with a caveat. | |
Action1 API quirks and the undocumented endpoints the curated tools use. | |
Architecture decision records. | |
Why | |
Evaluation questions for an LLM-driven harness. | |
Test layers and the live-run record. | |
Release notes. |
Development
npm run dev # tsx watch (stdio)
npm run typecheck # source
npm run typecheck:tests # tests (tsconfig.test.json)
npm run lint
npm test # all test categories
npm run test:unit
npm run test:integration # MCP protocol round trips
npm run test:security # destructive-guard truth table, redaction
npm run test:performance # size limits and rendering at scale
npm run test:coverage # tests with the coverage thresholds from vitest.config.ts
npm run test:e2e # builds the MCPB bundle, starts the built servers over stdio
npm run check # lint, both typechecks, format check, tests (what CI gates on)
npm run codegen # regenerate src/tools/generated/index.ts from the spec
npm run spec:check # compare the pinned spec with the one Action1 serves
npm run inspector # MCP Inspector against the built stdio serverThe macOS payload-builder tests are deliberately strict: they protect the reverse-engineered field set. If you change the payload, update the test.
Roadmap
Open candidates (see also
docs/api-coverage-gaps.md):
npm releases with provenance from the release workflow (trusted publisher configured; the first workflow publish is pending).
Live validation of the destructive tools listed under Validation status on a test endpoint.
A Cloudflare Workers deployment of the HTTP transport.
Security
See docs/SECURITY.md. Report vulnerabilities through
a private security advisory at
https://github.com/mguttmann/action1-mcp/security/advisories/new, not in
a public issue.
License
MIT © 2026 mguttmann, with one exception: the vendored Action1
API specification in src/codegen/spec/openapi.json belongs to Action1
Corporation and is not covered by the MIT License. See NOTICE.
Acknowledgements
The MCP community at https://modelcontextprotocol.io.
Anthropic's
mcp-builderguide, which shaped the tool design and the evaluation format.The other open-source Action1 integrations whose code I read while scoping this one, in particular
dimer47/action1-cli,pts211/action1-mcp-serverandghively/Action1MCP.
Available Tools
167 toolsaction1_add_endpoint_to_groupAdd an endpoint to an endpoint groupBDestructive
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.
Inputs: group_id (required), endpoint_id (required), org_id, confirm, +2 more. Returns: object
action1_audit_log_searchSearch the audit logARead-onlyIdempotent
Search /audit/events with an optional time window (sent to Action1 as timefrom/timeto) and case-insensitive substring filters on user, event and object.
Inputs: limit, cursor, to_time, from_time, +4 more. Returns: note, count, items, total, +2 more
action1_automations_summaryServer-side aggregation over recent automation instancesARead-onlyIdempotent
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.
Inputs: org_id, max_scan, response_format. Returns: note, has_more, by_status, failure_count, +3 more
action1_clone_packageClone Software Repository packageADestructive
Clone Software Repository package. Creates a full copy of an existing Software Repository package under a new package ID. Perm: manage_software_repository.
Inputs: package_id (required), org_id, confirm, dry_run. Returns: id, name, self, tool, +10 more
action1_clone_roleClone a roleBDestructive
Clone a role. Creates a copy of an existing role. Perm: manage_roles.
Inputs: role_id (required), confirm, dry_run. Returns: id, name, self, tool, +6 more
action1_create_approvalManage updates approvalsBDestructive
Manage updates approvals. Manages approval status for multiple packages in bulk. Perm: approve_updates.
Inputs: body (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +5 more
action1_create_automation_instanceApply a automationCDestructive
Apply a automation. Immediately runs an instance of the automation on the specified endpoints in the specified. Perm: run_automations.
Inputs: body (required), org_id, confirm, dry_run. Returns: id, name, self, tool, +12 more
action1_create_automation_scheduleCreate a automation scheduleADestructive
Create a automation schedule. Schedules a new automation. The automation will be executed against a specified list of endpoints. Perm: manage_automations.
Inputs: body (required), org_id, confirm, dry_run. Returns: id, name, self, tool, +11 more
action1_create_cve_remediationDocuments applied compensating controls for a specific vulnerabilityBDestructive
Documents applied compensating controls for a specific vulnerability. Perm: manage_vulnerabilities.
Inputs: body (required), cve_id (required), org_id, confirm, +1 more. Returns: tool, comment, dry_run, would_send, +4 more
action1_create_data_sourceCreate a data sourceBDestructive
Create a data source. Creates a new custom data source. At this time, all data sources are enterprise-wide. Perm: manage_data_sources.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +9 more
action1_create_endpoint_groupCreate a new groupADestructive
Create a new group. Creates a new endpoint group within the specified organization. Perm: manage_endpoints.
Inputs: body (required), org_id, confirm, dry_run. Returns: id, name, self, tool, +10 more
action1_create_endpoint_remote_sessionStart a new remote sessionBDestructive
Start a new remote session. Sends a request to the endpoint to start a new remote session. Perm: remote_connect.
Inputs: body (required), endpoint_id (required), org_id, confirm, +1 more. Returns: id, self, tool, type, +12 more
action1_create_organizationCreate an organizationCDestructive
Create an organization. Creates a new organization. Perm: manage_organizations.
Inputs: body, confirm, dry_run. Returns: id, name, self, tool, +4 more
action1_create_packageCreate new Software Repository packageBDestructive
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.
Inputs: body (required), org_id, confirm, dry_run. Returns: id, name, self, tool, +10 more
action1_create_package_versionCreate new version in Software Repository packageBDestructive
Create new version in Software Repository package. Adds a new version to the specified Software Repository package. Perm: manage_software_repository.
Inputs: body (required), package_id (required), org_id, confirm, +1 more. Returns: OS, id, self, tool, +25 more
action1_create_reportCreate a custom reportADestructive
Create a custom report. Creates a custom report in the predefined Custom report category. Perm: manage_reports.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +19 more
action1_create_report_subscriptionCreate a new report subscriptionCDestructive
Create a new report subscription. Creates a new report subscription. Perm: view_reports.
Inputs: body, confirm, dry_run. Returns: id, self, tool, type, +5 more
action1_create_roleCreate a roleCDestructive
Create a role. Creates a new role. Perm: manage_roles.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +6 more
action1_create_role_userAssign user to a specific roleBDestructive
Assign user to a specific role. Assigns user to a role specified by its ID. Perm: assign_roles.
Inputs: role_id (required), user_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_create_scriptCreate a custom scriptBDestructive
Create a custom script. Creates a new custom script and adds it to the Script Library. Perm: manage_scripts.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +12 more
action1_create_settingCreate a new settingBDestructive
Create a new setting. Creates a new setting. At this time, all setting templates are enterprise-wide. Perm: manage_advanced_settings.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +8 more
action1_create_userCreate new userCDestructive
Create new user. Creates a new user. To create an SSO user, please first review the following documentation: -. Perm: manage_users.
Inputs: body (required), confirm, dry_run. Returns: tool, value, dry_run, would_send
action1_cve_remediation_planBuild a remediation plan for a CVE or an endpoint (read-only)ARead-onlyIdempotent
Read-only correlation of vulnerabilities and the updates that fix them. Does NOT execute; pass the result to action1_deploy_update.
Inputs: cve_id, org_id, max_items, endpoint_id, +1 more. Returns: plan, count, warning, truncated
action1_delete_automationDelete a automation scheduleBDestructiveIdempotent
Delete a automation schedule. Deletes a scheduled automation specified by its ID. Perm: manage_automations.
Inputs: automation_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_automation_actionDelete an action from a automationBDestructiveIdempotent
Delete an action from a automation. Deletes a specified action from a scheduled automation. Perm: manage_automations.
Inputs: action_id (required), automation_id (required), org_id, confirm, +1 more. Returns: id, name, self, tool, +7 more
action1_delete_data_sourceDelete a custom data sourceADestructiveIdempotent
Delete a custom data source. Deletes an existing custom data source. Note that you cannot remove built-in data sources. Perm: manage_data_sources.
Inputs: data_source_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_deployerDelete DeployerCDestructiveIdempotent
Delete Deployer. Perm: manage_endpoints.
Inputs: deployer_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_endpointDelete an endpointBDestructiveIdempotent
Delete an endpoint. Removes a specified endpoint and attempts to uninstall its agent. Perm: manage_endpoints.
Inputs: endpoint_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_groupDelete an endpoint groupBDestructiveIdempotent
Delete an endpoint group. Deletes an existing group in the specified organization. Perm: manage_endpoints.
Inputs: group_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_organizationDelete an organizationADestructiveIdempotent
Delete an organization. Removes an organization from the enterprise. Perm: manage_organizations.
Inputs: org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_packageDelete custom Software Repository packageBDestructiveIdempotent
Delete custom Software Repository package. Deletes a custom Software Repository package specified by its ID. Perm: manage_software_repository.
Inputs: package_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_package_version_actionDelete additional action from version of Software Repository packageBDestructiveIdempotent
Delete additional action from version of Software Repository package. Perm: manage_software_repository.
Inputs: action_id (required), package_id (required), version_id (required), org_id, +2 more. Returns: id, tool, type, status, +4 more
action1_delete_remediationDeletes remediation record of compensating controlsBDestructiveIdempotent
Deletes remediation record of compensating controls. Perm: manage_vulnerabilities.
Inputs: cve_id (required), remediation_id (required), org_id, confirm, +1 more. Returns: id, tool, type, status, +4 more
action1_delete_reportDelete a custom reportADestructiveIdempotent
Delete a custom report. Deletes a custom report specified by its ID. Perm: manage_reports.
Inputs: report_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_report_subscriptionDelete the report subscriptionCDestructiveIdempotent
Delete the report subscription. Removes the report subscription.
Inputs: subscription_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_roleDelete a specific roleBDestructiveIdempotent
Delete a specific role. Deletes a role specified by its ID. Perm: manage_roles.
Inputs: role_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_role_userUnassign user from a specific roleADestructiveIdempotent
Unassign user from a specific role. Unassigns user from a role specified by its ID. Perm: assign_roles.
Inputs: role_id (required), user_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_scriptDelete a custom scriptBDestructiveIdempotent
Delete a custom script. Deletes an existing custom script specified by its ID. Perm: manage_scripts.
Inputs: script_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_settingDelete a settingBDestructiveIdempotent
Delete a setting. Deletes an existing setting specified by its ID. Perm: manage_advanced_settings.
Inputs: setting_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_userDelete userCDestructiveIdempotent
Delete user. Deletes an existing user. Perm: manage_users.
Inputs: user_id (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_delete_versionDelete version from Software Repository packageBDestructiveIdempotent
Delete version from Software Repository package. Deletes the specified version of the specified custom Software Repository package. Perm: manage_software_repository.
Inputs: package_id (required), version_id (required), org_id, confirm, +1 more. Returns: id, tool, type, status, +4 more
action1_deploy_packageDeploy a software packageADestructive
Deploy software via the deploy_package template. Use action1_get_action_template for the params schema.
Inputs: params (required), endpoint_id (required), name, org_id, +4 more. Returns: object
action1_deploy_updateDeploy specific updates to an endpointCDestructive
Deploy one or more updates (by package id) via the deploy_update template.
Inputs: updates (required), endpoint_id (required), name, org_id, +6 more. Returns: object
action1_endpoint_groups_resolveResolve endpoint group by name (fuzzy)ARead-onlyIdempotent
Look up an endpoint group by name or UUID using exact-id/exact-name/starts-with/contains.
Inputs: query (required), org_id, response_format. Returns: matches, total_groups, match_strategy
action1_endpoints_summaryServer-side aggregation over all endpointsARead-onlyIdempotent
Walks every endpoint and returns counts (total, by status/platform/OS/online, reboot_required). ~1 KB output regardless of fleet size.
Inputs: org_id, response_format. Returns: by_os, linux, macos, total, +7 more
action1_execute_and_waitExecute and wait for output (script or template)ADestructive
One-shot helper: starts an action (auto-routes by OS for 'script', or runs a template), polls until terminal, returns filtered output.
Inputs: endpoint_id (required), mode, name, org_id, +10 more. Returns: object
action1_export_audit_logExport of audit trail dataCRead-onlyIdempotent
Export of audit trail data. Exports audit data. Use parameters to filter out exported data. Perm: view_audit.
Inputs: from, event, limit, filter, +7 more. Returns: value
action1_get_action_templateGet action template detailsARead-onlyIdempotent
Fetch full details (parameters, supported platforms) for a single action template by id.
Inputs: template_id (required), response_format. Returns: object
action1_get_agent_install_urlGet the URL for agent installationARead-onlyIdempotent
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.
Inputs: install_type (required), org_id, verbose, response_format. Returns: id, self, type, download_URL
action1_get_audit_eventGet an audit record by its IDCRead-onlyIdempotent
Get an audit record by its ID. Get a specific audit record by its ID. Perm: view_audit.
Inputs: id (required), verbose, response_format. Returns: id, self, type, event, +10 more
action1_get_automation_instanceGet a specific instanceCRead-onlyIdempotent
Get a specific instance. Gets details about a automation instance specified by its ID. Perm: view_automations.
Inputs: automation_id (required), org_id, verbose, response_format. Returns: id, name, self, type, +9 more
action1_get_automation_outputGet automation script output (filtered)ARead-onlyIdempotent
Returns filtered stdout for one endpoint of an automation instance. Strips Action1 status markers.
Inputs: endpoint_id (required), instance_id (required), org_id, include_raw, +1 more. Returns: raw, output, skipped_status_lines
action1_get_automation_resultsGet automation endpoint-results overviewBRead-onlyIdempotent
Per-endpoint result rollup for an instance. Use action1_get_automation_output for stdout.
Inputs: instance_id (required), org_id, response_format. Returns: results
action1_get_automation_scheduleGet a specific automation scheduleBRead-onlyIdempotent
Get a specific automation schedule. Gets a scheduled automation specified by its ID. Perm: view_automations.
Inputs: automation_id (required), org_id, verbose, response_format. Returns: id, name, self, type, +8 more
action1_get_automation_script_outputGet details of a specific endpointBRead-onlyIdempotent
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.
Inputs: endpoint_id (required), instance_id (required), org_id, verbose, +1 more. Returns: note, count, items, total, +1 more
action1_get_automation_statusGet automation instance statusARead-onlyIdempotent
Returns the high-level status of one automation instance. For stdout use action1_get_automation_output.
Inputs: instance_id (required), org_id, response_format. Returns: instance
action1_get_cveDetailed information on a specific vulnerability within an organization…BRead-onlyIdempotent
Detailed information on a specific vulnerability within an organization, including CVE details like attack vector. Perm: view_vulnerabilities.
Inputs: cve_id (required), org_id, verbose, response_format. Returns: scope, cve_id, safety, version, +47 more
action1_get_cve_descriptionDetailed information on a specific vulnerability in general (not for an…BRead-onlyIdempotent
Detailed information on a specific vulnerability in general (not for an organization), including CVE details like attack vector. Perm: view_vulnerabilities.
Inputs: cve_id (required), verbose, response_format. Returns: scope, cve_id, safety, version, +47 more
action1_get_data_sourceGet a specific data sourceBRead-onlyIdempotent
Get a specific data source. Gets details about a specific data source. Perm: manage_data_sources, manage_reports.
Inputs: data_source_id (required), verbose, response_format. Returns: id, name, self, type, +6 more
action1_get_deployerGet a specific DeployerARead-onlyIdempotent
Get a specific Deployer. Obtains the current information about the specified Action1 Deployer service. Perm: manage_endpoints.
Inputs: deployer_id (required), org_id, verbose, response_format. Returns: id, os, name, self, +8 more
action1_get_drilldown_for_report_rowDrill down to detailsCRead-onlyIdempotent
Drill down to details. Expands report details to provide more information. Perm: view_reports.
Inputs: report_id (required), report_row_id (required), from, limit, +8 more. Returns: note, count, items, total, +2 more
action1_get_endpointGet endpoint general infoARead-onlyIdempotent
Fetch the general info block for a single endpoint, plus derived platform and connectivity.online flags.
Inputs: endpoint_id (required), org_id, response_format. Returns: source, general, platform, connectivity
action1_get_endpoint_discovery_settingsGet Agent Deployment settingsBRead-onlyIdempotent
Get Agent Deployment settings. Obtains the current Agent Deployment settings in a specified organization. Perm: manage_endpoints.
Inputs: org_id, verbose, response_format. Returns: connector_id, connector_name, connector_status, connector_last_seen
action1_get_endpoints_onboarded_statusCheck endpoint statusBRead-onlyIdempotent
Check endpoint status. Retrieves information if any endpoints were added to an organization.
Inputs: org_id, verbose, response_format. Returns: id, self, type, endpoints_added
action1_get_enterpriseGet enterprise settingsBRead-onlyIdempotent
Get enterprise settings. Gets settings for an enterprise. You can query data for your enterprise only.
Inputs: verbose, response_format. Returns: id, name, self, type, +6 more
action1_get_export_for_reportExport a reportCRead-onlyIdempotent
Export a report. Exports data from the report. Use parameters to filter out exported data. Perm: view_reports.
Inputs: report_id (required), from, limit, filter, +6 more. Returns: value
action1_get_export_for_report_rowExport report detailsCRead-onlyIdempotent
Export report details. Exports reports data. Use parameters to filter out exported data. Perm: view_reports.
Inputs: report_id (required), report_row_id (required), format, org_id, +2 more. Returns: value
action1_get_groupGet an endpoint groupBRead-onlyIdempotent
Get an endpoint group. Gets a specific endpoint group by its ID. Perm: view_endpoints.
Inputs: group_id (required), org_id, verbose, response_format. Returns: id, name, self, type, +7 more
action1_get_installed_software_endpointGet installed apps on a specific endpointBRead-onlyIdempotent
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.
Inputs: endpoint_id (required), from, limit, cursor, +6 more. Returns: note, count, items, total, +2 more
action1_get_match_conflicts_for_packageCheck for package matching conflicts when editing and existing package versionARead-onlyIdempotent
Check for package matching conflicts when editing and existing package version. Perm: view_software_repository.
Inputs: package_id (required), org_id, verbose, app_name_match, +1 more. Returns: id, name, self, type, +4 more
action1_get_match_conflicts_for_software_repositoryCheck for Software Repository package matching conflicts before creating a new…ARead-onlyIdempotent
Check for Software Repository package matching conflicts before creating a new package version. Perm: view_software_repository.
Inputs: org_id, verbose, app_name_match, response_format. Returns: id, name, self, type, +4 more
action1_get_meGet the current user settingsCRead-onlyIdempotent
Get the current user settings. Gets settings for the currently authenticated user.
Inputs: verbose, response_format. Returns: value
action1_get_org_subscription_usageGet usage statistics for a specific organizationBRead-onlyIdempotent
Get usage statistics for a specific organization. Gets details about license usage for an organization specified by its ID. Perm: manage_organizations.
Inputs: org_id, verbose, response_format. Returns: id, self, type, organization, +3 more
action1_get_remote_sessionGet a remote sessionBRead-onlyIdempotent
Get a remote session. Gets details for an existing remote session specified by ID. Perm: remote_connect.
Inputs: session_id (required), endpoint_id (required), org_id, verbose, +1 more. Returns: id, self, type, user_id, +9 more
action1_get_report_or_categoryList reports and categoriesCRead-onlyIdempotent
List reports and categories. Gets a list of reports and categories. At this time all reports are enterprise-wide.
Inputs: report_or_category_id (required), verbose, response_format. Returns: id, name, self, type, +19 more
action1_get_roleGet a specific roleBRead-onlyIdempotent
Get a specific role. Gets details about a role specified by its ID. Perm: manage_roles.
Inputs: role_id (required), verbose, response_format. Returns: id, name, self, type, +3 more
action1_get_scriptGet a specific scriptBRead-onlyIdempotent
Get a specific script. Gets details for a script specified by its ID. Perm: use_scripts.
Inputs: script_id (required), verbose, response_format. Returns: id, name, self, type, +9 more
action1_get_settingGet setting configurationCRead-onlyIdempotent
Get setting configuration. Gets details about the setting configuration. Perm: manage_advanced_settings.
Inputs: setting_id (required), verbose, response_format. Returns: id, name, self, type, +5 more
action1_get_setting_templateGet a setting templateCRead-onlyIdempotent
Get a setting template. Gets details about a setting template specified by its ID.
Inputs: template_id (required), verbose, response_format. Returns: id, name, self, type, +8 more
action1_get_software_repository_packageGet Software Repository package settingsARead-onlyIdempotent
Get Software Repository package settings. Gets details for a Software Repository package specified by its ID. Perm: view_software_repository.
Inputs: package_id (required), fields, org_id, verbose, +1 more. Returns: id, name, self, type, +7 more
action1_get_subscriptionGet enterprise license informationCRead-onlyIdempotent
Get enterprise license information. Gets details about the enterprise license. Perm: manage_enterprise.
Inputs: verbose, response_format. Returns: id, MSP, self, type, +8 more
action1_get_subscription_usageGet usage statistics for an enterpriseBRead-onlyIdempotent
Get usage statistics for an enterprise. Gets details about license usage for the entire enterprise. Perm: manage_enterprise.
Inputs: verbose, response_format. Returns: id, self, type, organization, +3 more
action1_get_update_packageList updates for a packageBRead-onlyIdempotent
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.
Inputs: package_id (required), from, limit, cursor, +12 more. Returns: note, count, items, total, +2 more
action1_get_userGet userCRead-onlyIdempotent
Get user. Gets an existing user. Perm: view_users.
Inputs: user_id (required), verbose, response_format. Returns: value
action1_get_versionGet version in Software Repository packageBRead-onlyIdempotent
Get version in Software Repository package. Gets details about a package version specified by its ID. Perm: view_software_repository.
Inputs: package_id (required), version_id (required), org_id, verbose, +1 more. Returns: OS, id, self, type, +22 more
action1_get_windows_deployer_urlGet Deployer installation URLBRead-onlyIdempotent
Get Deployer installation URL. Obtains an URL to download the Deployer installation file. Perm: manage_endpoints.
Inputs: org_id, verbose, response_format. Returns: id, self, type, download_URL
action1_init_software_uploadInitialize package file uploadCDestructive
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.
Inputs: platform (required), package_id (required), version_id (required), body, +3 more. Returns: tool, value, dry_run, would_send
action1_list_action_templatesList action templatesARead-onlyIdempotent
List every action template (id, name, description). Use ids with action1_get_action_template.
Inputs: applicable_to, response_format. Returns: note, count, items, total, +1 more
action1_list_audit_eventsGet audit records of user actionsBRead-onlyIdempotent
Get audit records of user actions. 'The Audit Trail contains event records associated with user actions, such as logins, remote. Perm: view_audit.
Inputs: from, event, limit, cursor, +8 more. Returns: note, count, items, total, +2 more
action1_list_automation_deployment_statusesGet the deployment statuses of a automationBRead-onlyIdempotent
Get the deployment statuses of a automation. Gets the deployment statuses of a automation specified by its ID. Perm: view_automations.
Inputs: automation_id (required), org_id, verbose, response_format. Returns: note, count, items, total, +1 more
action1_list_automation_instancesList automation instancesBRead-onlyIdempotent
List automation instances. Gets a list of running and completed automations for the specified organization. Perm: view_automations.
Inputs: from, limit, cursor, filter, +8 more. Returns: note, count, items, total, +2 more
action1_list_automation_schedulesList automation schedulesBRead-onlyIdempotent
List automation schedules. Lists existing scheduled automations. Use parameters to filter out automations in the returned. Perm: view_automations.
Inputs: from, limit, cursor, filter, +5 more. Returns: note, count, items, total, +2 more
action1_list_cve_endpointsLists endpoints in an organization affected by a specific vulnerabilityARead-onlyIdempotent
Lists endpoints in an organization affected by a specific vulnerability. Perm: view_vulnerabilities.
Inputs: cve_id (required), from, limit, cursor, +7 more. Returns: note, count, items, total, +2 more
action1_list_cve_remediationsLists past remediation actions for a specific vulnerabilityBRead-onlyIdempotent
Lists past remediation actions for a specific vulnerability. Perm: view_vulnerabilities.
Inputs: cve_id (required), from, limit, cursor, +6 more. Returns: note, count, items, total, +2 more
action1_list_data_sourcesList data sourcesBRead-onlyIdempotent
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.
Inputs: builtin, verbose, response_format. Returns: note, count, items, total, +1 more
action1_list_endpoint_deployersList DeployersBRead-onlyIdempotent
List Deployers. Lists all Action1 Deployer services in the specified organization. Perm: manage_endpoints.
Inputs: os, from, limit, cursor, +8 more. Returns: note, count, items, total, +2 more
action1_list_endpoint_groupsList endpoint groupsBRead-onlyIdempotent
List endpoint groups. Lists existing endpoint groups. Use filters and narrow down and sort the returned results. Perm: view_endpoints.
Inputs: from, limit, cursor, filter, +5 more. Returns: note, count, items, total, +2 more
action1_list_endpoint_missing_updatesGet missing updates for an endpointARead-onlyIdempotent
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.
Inputs: endpoint_id (required), from, limit, cursor, +8 more. Returns: note, count, items, total, +2 more
action1_list_endpointsList managed endpoints (cursor-paginated)ARead-onlyIdempotent
List endpoints with server-side filters (status, online_status, os, reboot_required, …). For counts, use action1_endpoints_summary instead.
Inputs: os, limit, cursor, fields, +12 more. Returns: note, count, items, total, +2 more
action1_list_group_contentsList endpoints from the groupBRead-onlyIdempotent
List endpoints from the group. Lists all endpoints included in the specified group. Perm: view_endpoints.
Inputs: group_id (required), os, from, limit, +13 more. Returns: note, count, items, total, +2 more
action1_list_installed_software_dataGet installed appsCRead-onlyIdempotent
Get installed apps. Gets a list of installed apps. Use parameters to filter out apps in the returned results. Perm: view_installed_software.
Inputs: from, limit, cursor, filter, +6 more. Returns: note, count, items, total, +2 more
action1_list_installed_software_errorsGet apps report errorsCRead-onlyIdempotent
Get apps report errors. Returns apps report errors. Use parameters to filter out returned results. Perm: view_installed_software.
Inputs: from, limit, cursor, filter, +5 more. Returns: note, count, items, total, +2 more
action1_list_instance_endpoint_resultsList resultsCRead-onlyIdempotent
List results. Gets a list of endpoints where the automation instance is being applied or has been executed. Perm: view_automations.
Inputs: instance_id (required), from, limit, cursor, +7 more. Returns: note, count, items, total, +2 more
action1_list_logsGet diagnostic logsCRead-onlyIdempotent
Get diagnostic logs. Gets diagnostic logs. Use parameters to pre-filter returned results. Perm: manage_endpoints.
Inputs: from, level, limit, cursor, +5 more. Returns: note, count, items, total, +2 more
action1_list_missing_updatesList missing updates for an endpointBRead-onlyIdempotent
Returns missing-update items for one endpoint. Each item.id can be passed to action1_deploy_update.
Inputs: endpoint_id (required), limit, org_id, response_format. Returns: note, count, items, total, +1 more
action1_list_organizationsList organizationsBRead-onlyIdempotent
List every organization the configured API key can access.
Inputs: admin, limit, response_format. Returns: note, count, items, total, +1 more
action1_list_org_vulnerabilitiesList of all vulnerable software within the organizationARead-onlyIdempotent
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.
Inputs: from, limit, score, cursor, +14 more. Returns: note, count, items, total, +2 more
action1_list_permissionsList permission templatesCRead-onlyIdempotent
List permission templates. Gets a list of available permission templates.
Inputs: from, limit, cursor, filter, +4 more. Returns: note, count, items, total, +2 more
action1_list_recent_automationsList recent automation instancesARead-onlyIdempotent
List recent automation instances for the org. For counts use action1_automations_summary instead.
Inputs: limit, cursor, org_id, response_format. Returns: note, count, items, total, +2 more
action1_list_report_dataGet report rowsBRead-onlyIdempotent
Get report rows. Gets data organized by report rows. Use parameters to filter out returned results. Perm: view_reports.
Inputs: report_id (required), from, limit, cursor, +9 more. Returns: note, count, items, total, +2 more
action1_list_report_errorsGet report errorsBRead-onlyIdempotent
Get report errors. Returns report errors for the specified report. Perm: view_reports.
Inputs: report_id (required), from, limit, cursor, +6 more. Returns: note, count, items, total, +2 more
action1_list_reportsList reportsCRead-onlyIdempotent
List reports. Gets a list of existing reports. At this time all reports are enterprise-wide.
Inputs: subtree, verbose, response_format. Returns: note, count, items, total, +1 more
action1_list_report_subscriptionsList report subscriptionsCRead-onlyIdempotent
List report subscriptions. Gets a list of report subscriptions.
Inputs: from, limit, cursor, verbose, +2 more. Returns: note, count, items, total, +2 more
action1_list_rolesList rolesCRead-onlyIdempotent
List roles. Gets a list of available roles. Perm: manage_roles.
Inputs: from, limit, cursor, fields, +5 more. Returns: note, count, items, total, +2 more
action1_list_role_usersList users in a specific roleBRead-onlyIdempotent
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.
Inputs: role_id (required), from, limit, cursor, +5 more. Returns: note, count, items, total, +2 more
action1_list_scriptsList scriptsBRead-onlyIdempotent
List scripts. Gets a list of existing scripts from the Script Library. Perm: use_scripts.
Inputs: builtin, verbose, platform, response_format. Returns: note, count, items, total, +1 more
action1_list_settingsList settingsARead-onlyIdempotent
List settings. Lists all existing settings. At this time, all settings are enterprise-wide. Perm: manage_advanced_settings.
Inputs: from, limit, cursor, filter, +5 more. Returns: note, count, items, total, +2 more
action1_list_setting_templatesList setting templatesCRead-onlyIdempotent
List setting templates. Gets a list of existing setting templates.
Inputs: filter, verbose, response_format. Returns: note, count, items, total, +1 more
action1_list_software_repositoryList Software Repository packagesBRead-onlyIdempotent
List Software Repository packages. Gets a list of Software Repository packages for the entire enterprise. Perm: view_software_repository.
Inputs: from, limit, cursor, custom, +11 more. Returns: note, count, items, total, +2 more
action1_list_subscription_usage_organizationsGet usage statistics for organizationsBRead-onlyIdempotent
Get usage statistics for organizations. Gets details about license usage with statistics for each organization individually. Perm: manage_organizations.
Inputs: verbose, response_format. Returns: note, count, items, total, +1 more
action1_list_updatesList missing updatesCRead-onlyIdempotent
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.
Inputs: from, limit, cursor, custom, +13 more. Returns: note, count, items, total, +2 more
action1_list_user_rolesList the roles assigned to a userARead-onlyIdempotent
List the roles assigned to a user. Retrieves all roles assigned to a user specified by ID. Perm: manage_users.
Inputs: user_id (required), from, limit, cursor, +3 more. Returns: note, count, items, total, +2 more
action1_list_usersList usersARead-onlyIdempotent
List users. Gets a list of users within the current Action1 enterprise. Perm: view_users.
Inputs: from, limit, cursor, filter, +4 more. Returns: note, count, items, total, +2 more
action1_list_version_endpointsList endpoints missing a specific updateARead-onlyIdempotent
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.
Inputs: package_id (required), version_id (required), from, limit, +7 more. Returns: note, count, items, total, +2 more
action1_list_vulnerabilitiesList vulnerabilities for an endpointARead-onlyIdempotent
Returns vulnerability findings for one endpoint. Returns a clear 403 if the API key lacks the vulnerabilities scope.
Inputs: endpoint_id (required), org_id, response_format. Returns: note, count, items, total, +1 more
action1_move_endpointMove the endpoint to another organizationBDestructive
Move the endpoint to another organization. Moves the endpoint to another organization. Perm: manage_endpoints.
Inputs: body (required), endpoint_id (required), org_id, confirm, +1 more. Returns: OS, id, MAC, NIC, +37 more
action1_raw_requestRaw Action1 API request (escape hatch)ADestructive
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.
Inputs: path (required), method (required), body, query, +3 more. Returns: object
action1_reboot_endpointReboot an endpointADestructive
Reboots the host via the reboot action template. Combine with action1_wait_for_automation to track recovery.
Inputs: endpoint_id (required), name, org_id, confirm, +4 more. Returns: object
action1_recurring_schedulesList recurring automation schedules (read)BRead-onlyIdempotent
List recurring automations with optional client-side filters (status, template_id, group id substring).
Inputs: limit, cursor, org_id, active_only, +3 more. Returns: note, count, items, total, +2 more
action1_remove_endpoint_from_groupRemove an endpoint from an endpoint groupADestructive
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).
Inputs: group_id (required), endpoint_id (required), org_id, confirm, +2 more. Returns: object
action1_report_exportRun a report and return its data or CSV exportBRead-onlyIdempotent
Resolve a report by name or UUID, then return JSON rows or a CSV export blob.
Inputs: report (required), limit, format, org_id, +1 more. Returns: note, count, items, total, +4 more
action1_requery_installed_software_for_endpointRe-querying installed apps on a specific endpointBDestructive
Re-querying installed apps on a specific endpoint. Perm: view_installed_software, view_endpoints.
Inputs: endpoint_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_requery_installed_software_for_orgRe-querying installed appsBDestructive
Re-querying installed apps. This API method initiates an asynchronous update ("requery") of the installed software inventory. Perm: view_installed_software.
Inputs: org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_requery_reportRe-querying a reportADestructive
Re-querying a report. This API method initiates an asynchronous update ("requery") of the report's underlying data source. Perm: view_reports.
Inputs: report_id (required), org_id, confirm, dry_run, +1 more. Returns: id, tool, type, status, +4 more
action1_request_enterprise_closureClose the entire enterprise associated with Action1 accountADestructive
Close the entire enterprise associated with Action1 account. The request is available only for a free Action1 account. Perm: manage_enterprise.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +9 more
action1_request_enterprise_quoteRequest a quoteBDestructive
Request a quote. Sends a quote request to the Action1 Sales department. Perm: manage_enterprise.
Inputs: body (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_request_enterprise_trialRequest a free trial or its extensionBDestructive
Request a free trial or its extension. Perm: manage_enterprise.
Inputs: body (required), confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_revoke_enterprise_closureRevoke account closureADestructive
Revoke account closure. The Action1 enterprise will be immediately reactivated and all your data will be retained. Perm: manage_enterprise.
Inputs: body (required), confirm, dry_run. Returns: id, name, self, tool, +9 more
action1_run_bash_macosRun a Bash script on a macOS endpointADestructive
Run a Bash script on a macOS endpoint via the run_script template. For OS-aware routing use action1_run_script.
Inputs: endpoint_id (required), script_text (required), name, org_id, +6 more. Returns: object
action1_run_data_collectionRun a data collectionCDestructive
Trigger the run_data_collection template on an endpoint.
Inputs: endpoint_id (required), name, org_id, params, +4 more. Returns: object
action1_run_powershellRun PowerShell on a Windows endpointBDestructive
Run PowerShell on a Windows endpoint via the run_powershell template. Runs as SYSTEM (no user profile).
Inputs: endpoint_id (required), script_text (required), name, org_id, +7 more. Returns: object
action1_run_scriptRun a script (auto-route by endpoint OS)ADestructive
Cross-platform script runner. Routes to PowerShell (Windows) or Bash (macOS); errors on Linux/unknown. For target_type='EndpointGroup' pass os ('windows' or 'macos').
Inputs: endpoint_id (required), script_text (required), os, name, +9 more. Returns: object
action1_searchSearchCRead-onlyIdempotent
Search. Perm: view_endpoints, view_software_repository, view_reports.
Inputs: query (required), limit, org_id, verbose, +1 more. Returns: note, count, items, total, +1 more
action1_search_endpointsSearch endpoints (client-side substring filter, cursor-paginated)ARead-onlyIdempotent
Case-insensitive substring search restricted to hostname, user, OS and status fields. Walks the endpoint list page by page and matches client-side.
Inputs: query (required), limit, cursor, fields, +3 more. Returns: note, count, items, total, +2 more
action1_software_inventory_for_endpointList installed software for an endpointARead-onlyIdempotent
Fetch installed-software inventory for one endpoint, with optional name substring filter.
Inputs: endpoint_id (required), limit, cursor, org_id, +2 more. Returns: note, count, items, total, +2 more
action1_stop_instanceStop a automationADestructive
Stop a automation. Stops applying a automation instance and aborts actions running on a remote endpoint. Perm: manage_automations.
Inputs: instance_id (required), org_id, confirm, dry_run. Returns: id, tool, type, status, +4 more
action1_uninstall_programUninstall a programADestructive
Uninstall software via the uninstall_program template. Use action1_get_action_template for the params schema.
Inputs: params (required), endpoint_id (required), name, org_id, +4 more. Returns: object
action1_update_automationUpdate a automation scheduleBDestructive
Update a automation schedule. Perm: manage_automations.
Inputs: body (required), automation_id (required), org_id, confirm, +1 more. Returns: id, name, self, tool, +11 more
action1_update_data_sourceUpdate a custom data sourceCDestructive
Update a custom data source. Updates a custom data source specified by its ID. Perm: manage_data_sources.
Inputs: data_source_id (required), body, confirm, dry_run. Returns: id, name, self, tool, +9 more
action1_update_endpointChange an endpoint comment or nameBDestructive
Change an endpoint comment or name. Changes the user-defined 'comment', 'name' and custom attributes for the specified endpoint. Perm: manage_endpoint_attributes.
Inputs: body (required), endpoint_id (required), org_id, confirm, +1 more. Returns: OS, id, MAC, NIC, +37 more
action1_update_endpoint_agent_deploymentUpdate Agent Deployment settingsBDestructive
Update Agent Deployment settings. Updates the Agent Deployment configuration for a specific organization. Perm: manage_endpoints.
Inputs: body, org_id, confirm, dry_run. Returns: tool, dry_run, would_send, connector_id, +3 more
action1_update_enterpriseUpdate enterprise settingsCDestructive
Update enterprise settings. Updates settings for a current enterprise. Perm: manage_enterprise.
Inputs: body, confirm, dry_run. Returns: id, name, self, tool, +9 more
action1_update_groupChange group settingsCDestructive
Change group settings. Changes settings for an existing endpoint group in the specified organization. Perm: manage_endpoints.
Inputs: group_id (required), body, org_id, confirm, +1 more. Returns: id, name, self, tool, +10 more
action1_update_meUpdate the current user settingsCDestructive
Update the current user settings. Updates settings for the currently authenticated user.
Inputs: body, confirm, dry_run. Returns: tool, value, dry_run, would_send
action1_update_organizationUpdate organization settingsCDestructive
Update organization settings. Updates settings for an organization specified by its ID. Perm: manage_organizations.
Inputs: body, org_id, confirm, dry_run. Returns: id, name, self, tool, +4 more
action1_update_packageUpdate Software Repository package settingsBDestructive
Update Software Repository package settings. Perm: manage_software_repository.
Inputs: package_id (required), body, org_id, confirm, +1 more. Returns: id, name, self, tool, +10 more
action1_update_remediationUpdates record of compensating controls when remediation changesBDestructive
Updates record of compensating controls when remediation changes. Perm: manage_vulnerabilities.
Inputs: cve_id (required), remediation_id (required), body, org_id, +2 more. Returns: tool, comment, dry_run, would_send, +4 more
action1_update_remote_sessionSwitch a current monitorBDestructive
Switch a current monitor. Changes the 'current_monitor' parameter for a specific remote session. Perm: remote_connect.
Inputs: session_id (required), endpoint_id (required), body, org_id, +2 more. Returns: id, self, tool, type, +12 more
action1_update_reportUpdate a custom reportCDestructive
Update a custom report. Updates a custom report. You cannot changes a custom report's category. Perm: manage_reports.
Inputs: report_id (required), body, confirm, dry_run. Returns: id, name, self, tool, +19 more
action1_update_report_subscriptionUpdate the report subscriptionCDestructive
Update the report subscription. Updates the report subscription. Perm: view_reports.
Inputs: subscription_id (required), body, confirm, dry_run. Returns: id, self, tool, type, +5 more
action1_update_roleUpdate a specific roleADestructive
Update a specific role. Updates a role specified by its ID. Perm: manage_roles.
Inputs: body (required), role_id (required), confirm, dry_run. Returns: id, name, self, tool, +6 more
action1_update_scriptUpdate a custom scriptADestructive
Update a custom script. Updates details for an existing custom script specified by its ID. Perm: manage_scripts.
Inputs: script_id (required), body, confirm, dry_run. Returns: id, name, self, tool, +12 more
action1_update_settingUpdate a settingADestructive
Update a setting. Updates an existing setting specified by its ID. Perm: manage_advanced_settings.
Inputs: setting_id (required), body, confirm, dry_run. Returns: id, name, self, tool, +8 more
action1_update_userUpdate userCDestructive
Update user. Updates an existing user. Perm: manage_users.
Inputs: body (required), user_id (required), confirm, dry_run. Returns: tool, value, dry_run, would_send
action1_update_versionModify version in Software Repository packageCDestructive
Modify version in Software Repository package.
Inputs: package_id (required), version_id (required), body, org_id, +2 more. Returns: OS, id, self, tool, +25 more
action1_upload_software_chunkUpload package file chunksCDestructiveIdempotent
Not supported by this server (see error text). Upload package file chunks. Uploads package file chunks. Perm: manage_software_repository.
Inputs: platform (required), upload_id (required), package_id (required), version_id (required), +4 more. Returns: tool, value, dry_run, would_send
action1_wait_for_automationPoll an automation until it terminatesARead-onlyIdempotent
Block until an automation instance reaches a terminal status (Stopped/Success/Warning/Error) or timeout.
Inputs: instance_id (required), org_id, endpoint_id, response_format, +2 more. Returns: output, status
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
An MCP server that provides an API to LLMs to manage their JumpCloud resources.
MCP server for your apps' tools and custom tools, plus hosted AI agents and approval-gated workflows
MCP server unifying ERPs, CRMs, APIs and knowledge base for Claude, ChatGPT and Gemini.
Hosted Airtable MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Related MCP Servers
- AlicenseAqualityBmaintenanceAn MCP server for Action1, a cloud-native RMM platform, enabling remote monitoring, patch management, and endpoint management through Action1's API.64Apache 2.0
- AlicenseNot gradedqualityBmaintenanceMCP server for the Atera RMM API. Implements a decision tree architecture for efficient tool discovery, enabling Claude to manage devices, alerts, tickets, and customers in Atera.1Apache 2.0
- AlicenseAqualityDmaintenanceA comprehensive Model Context Protocol (MCP) server that enables Claude and other LLM applications to execute PowerShell commands, scripts, and perform system operations on Windows systems.1027MIT
- FlicenseNot gradedqualityDmaintenanceAutonomous network monitoring and auto-remediation MCP server for Claude Desktop, enabling observation, planning, human-approved execution, verification, and session summarization.1-