Skip to main content
Glama

action1-mcp-server

License: MIT Node

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 in TESTING.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_script with target_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.md and 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_script payload; the API answers not applicable to Mac platform for any missing field.

  • Windows PowerShell actions need a non-empty success_exit_codes.

  • last_seen is YYYY-MM-DD_HH-MM-SS (UTC), not ISO-8601, so Date.parse returns NaN. The server parses it and renders it readable.

  • The self URL of a list item contains a /general segment that is not a real REST resource.

  • Script output is interleaved with Starting / Waiting / Completed lifecycle markers that need to be filtered.

  • OS is upper-case and platform lower-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

  1. Download action1-mcp-<version>.mcpb from the project's GitHub Releases. The release workflow attaches it to every version tag.

  2. Double-click it (or drag it onto Claude Desktop, or use Settings > Extensions > Install from file).

  3. 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.js

npm 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-server

Any 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 as action1_list_endpoint_groups, unless a curated tool covers it. Exceptions: POST /oauth2/token is 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 into docs/_coverage_table.md; docs/api-coverage.md explains 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 need confirm: "YES" to execute. Account operations need a second switch. See Destructive guard.

  • Scoping. ACTION1_ALLOWED_ORG_IDS limits which organizations the tools may address; ACTION1_TOOLSETS=read registers only read-only tools.

  • Output for agents. Every read-only tool accepts response_format (markdown default, json); every tool sets all four MCP annotations and declares an outputSchema. Paginated results carry count, has_more, next_cursor, and total on 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 by ACTION1_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 Host and Origin against DNS rebinding, limits bodies to 1 MB and rate-limits per client IP.

  • Logs. Structured JSON lines on stderr with credential redaction, one tool_call line 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

ACTION1_BASE_URL

required

API base URL of your region, see below.

ACTION1_CLIENT_ID

required

OAuth2 client ID from Action1 > Settings > API Credentials.

ACTION1_CLIENT_SECRET

required

OAuth2 client secret, shown once when the credential is created.

ACTION1_ORG_ID

unset

Default organization UUID; tools can override it with org_id. Recommended.

ACTION1_ALLOWED_ORG_IDS

any

Comma-separated organization UUIDs the tools may address; others are refused. Recommended for HTTP and shared setups.

ACTION1_ALLOW_ENTERPRISE_OPS

false

With ACTION1_ALLOWED_ORG_IDS set: also allows mutations not bound to one allowed organization (enterprise settings, script library, roles, users, Enterprise scopes).

ACTION1_ALLOW_DESTRUCTIVE

false

true / 1 / yes allows tools that change state to execute.

ACTION1_ALLOW_ACCOUNT_OPS

false

Also allows account operations: changes to users, roles, /me, the enterprise account, organizations and subscriptions, and every non-GET action1_raw_request.

ACTION1_DESTRUCTIVE_AUTO_CONFIRM

false

Isolated single-operator setups only: drops the per-call confirm: "YES". dry_run still defaults to true.

ACTION1_TOOLSETS

all

all, read (read-only tools) or curated (no generated tools); comma-separated values intersect.

ACTION1_REDACT_PII

false

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 User Name and CSV export columns), resource reads and upstream error bodies. Rules and limits: SECURITY.md.

ACTION1_DEFAULT_TIMEOUT_MINUTES

10

Default script timeout, 0 to 10080.

ACTION1_DEFAULT_RETRY_MINUTES

1440

How long Action1 retries an action for an offline endpoint, 0 to 10080.

ACTION1_LAST_SEEN_STALE_MINUTES

10

Minutes since last_seen before an endpoint counts as offline, 1 to 1440: the offline check before an action, connectivity.online of action1_get_endpoint and the fresh / stale counts of action1_endpoints_summary.

ACTION1_REQUEST_TIMEOUT_MS

60000

Budget for one Action1 API call including retries, 1000 to 600000.

ACTION1_TOKEN_TIMEOUT_MS

15000

Timeout for one OAuth token attempt, 1000 to 600000.

ACTION1_LOG_LEVEL

info

debug, info, notice, warn, error, critical, alert or emergency (case-insensitive).

PORT

3000

HTTP mode: listen port.

HOST

127.0.0.1

HTTP mode: bind address.

MCP_HTTP_TOKEN

required for --http

Bearer token clients must send, at least 16 characters (openssl rand -hex 32).

MCP_HTTP_ALLOW_NO_AUTH

false

HTTP mode without a token; loopback binds only, local development.

MCP_HTTP_ALLOWED_HOSTS

loopback and bind address

Extra Host names to accept, e.g. the public name behind a reverse proxy. Required for 0.0.0.0 / ::.

MCP_HTTP_ALLOWED_ORIGINS

loopback origins

Browser Origin values to accept.

TRUST_PROXY

false

Express trust proxy: false, true, loopback, a hop count or a CIDR list. Set loopback behind a local reverse proxy so the rate limit sees real client IPs.

Action1 regions (ACTION1_BASE_URL):

Region

Base URL

Europe

https://app.eu.action1.com/api/3.0

North America

https://app.action1.com/api/3.0

North America 2

https://app.na-2.action1.com/api/3.0

United Kingdom

https://app.uk.action1.com/api/3.0

Australia

https://app.au.action1.com/api/3.0

Connecting to MCP hosts

Host

Transport

Doc

Claude Code (CLI)

stdio

INSTALLATION: Claude Code

Claude Desktop (macOS / Windows)

MCPB bundle or stdio

INSTALLATION: Claude Desktop

Claude.ai (web)

Streamable HTTP

INSTALLATION: Claude.ai

Cursor

stdio

INSTALLATION: Cursor

Continue.dev / Cody

stdio

INSTALLATION: generic

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

docs/INSTALLATION.md

Step-by-step setup for every supported MCP host.

docs/USAGE.md

Tool reference for the curated and wrapper layers, resources, prompts, output format, cancellation, logging.

docs/EXAMPLES.md

End-to-end recipes (patching, triage, CVE remediation).

docs/DEPLOYMENT.md

stdio, HTTP behind a reverse proxy, systemd, MCPB, production checklist.

docs/SECURITY.md

Threat model, destructive guard, data flow to the LLM, reporting vulnerabilities.

docs/permissions.md

Action1 permission per operation and tool (generated).

docs/TROUBLESHOOTING.md

Common failure modes and fixes.

docs/FAQ.md

Questions across topics.

docs/CONTRIBUTING.md

Development setup, codegen workflow, tests, pull requests.

docs/api-coverage.md

How spec operations map to tools; full table in docs/_coverage_table.md.

docs/api-coverage-gaps.md

What the server does not cover, or covers only with a caveat.

docs/GOTCHAS.md

Action1 API quirks and the undocumented endpoints the curated tools use.

docs/adr/

Architecture decision records.

docs/403-investigation.md

Why /general is not a real path.

evals/

Evaluation questions for an LLM-driven harness.

TESTING.md

Test layers and the live-run record.

CHANGELOG.md

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 server

The 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

Available Tools

167 tools
action1_add_endpoint_to_groupAdd an endpoint to an endpoint groupB
Destructive

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_automations_summaryServer-side aggregation over recent automation instancesA
Read-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 packageA
Destructive

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 roleB
Destructive

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 approvalsB
Destructive

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 automationC
Destructive

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 scheduleA
Destructive

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 vulnerabilityB
Destructive

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 sourceB
Destructive

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 groupA
Destructive

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 sessionB
Destructive

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 organizationC
Destructive

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 packageB
Destructive

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 packageB
Destructive

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 reportA
Destructive

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 subscriptionC
Destructive

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 roleC
Destructive

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 roleB
Destructive

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 scriptB
Destructive

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 settingB
Destructive

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 userC
Destructive

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)A
Read-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 scheduleB
DestructiveIdempotent

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 automationB
DestructiveIdempotent

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 sourceA
DestructiveIdempotent

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 DeployerC
DestructiveIdempotent

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 endpointB
DestructiveIdempotent

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 groupB
DestructiveIdempotent

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 organizationA
DestructiveIdempotent

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 packageB
DestructiveIdempotent

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 packageB
DestructiveIdempotent

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 controlsB
DestructiveIdempotent

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 reportA
DestructiveIdempotent

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 subscriptionC
DestructiveIdempotent

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 roleB
DestructiveIdempotent

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 roleA
DestructiveIdempotent

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 scriptB
DestructiveIdempotent

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 settingB
DestructiveIdempotent

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 userC
DestructiveIdempotent

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 packageB
DestructiveIdempotent

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 packageA
Destructive

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 endpointC
Destructive

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)A
Read-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 endpointsA
Read-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)A
Destructive

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 dataC
Read-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 detailsA
Read-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 installationA
Read-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 IDC
Read-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 instanceC
Read-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)A
Read-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 overviewB
Read-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 scheduleB
Read-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 endpointB
Read-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 statusA
Read-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…B
Read-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…B
Read-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 sourceB
Read-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 DeployerA
Read-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 detailsC
Read-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 infoA
Read-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 settingsB
Read-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 statusB
Read-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 settingsB
Read-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 reportC
Read-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 detailsC
Read-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 groupB
Read-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 endpointB
Read-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 versionA
Read-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…A
Read-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 settingsC
Read-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 organizationB
Read-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 sessionB
Read-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 categoriesC
Read-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 roleB
Read-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 scriptB
Read-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 configurationC
Read-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 templateC
Read-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 settingsA
Read-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 informationC
Read-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 enterpriseB
Read-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 packageB
Read-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 userC
Read-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 packageB
Read-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 URLB
Read-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 uploadC
Destructive

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 templatesA
Read-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 actionsB
Read-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 automationB
Read-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 instancesB
Read-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 schedulesB
Read-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 vulnerabilityA
Read-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 vulnerabilityB
Read-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 sourcesB
Read-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 DeployersB
Read-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 groupsB
Read-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 endpointA
Read-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)A
Read-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 groupB
Read-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 appsC
Read-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 errorsC
Read-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 resultsC
Read-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 logsC
Read-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 endpointB
Read-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 organizationsB
Read-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 organizationA
Read-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 templatesC
Read-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 instancesA
Read-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 rowsB
Read-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 errorsB
Read-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 reportsC
Read-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 subscriptionsC
Read-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 rolesC
Read-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 roleB
Read-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 scriptsB
Read-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 settingsA
Read-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 templatesC
Read-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 packagesB
Read-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 organizationsB
Read-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 updatesC
Read-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 userA
Read-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 usersA
Read-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 updateA
Read-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 endpointA
Read-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 organizationB
Destructive

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)A
Destructive

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 endpointA
Destructive

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)B
Read-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 groupA
Destructive

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 exportB
Read-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 endpointB
Destructive

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 appsB
Destructive

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 reportA
Destructive

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 accountA
Destructive

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 quoteB
Destructive

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 extensionB
Destructive

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 closureA
Destructive

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 endpointA
Destructive

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 collectionC
Destructive

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 endpointB
Destructive

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)A
Destructive

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_search_endpointsSearch endpoints (client-side substring filter, cursor-paginated)A
Read-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 endpointA
Read-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 automationA
Destructive

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 programA
Destructive

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 scheduleB
Destructive

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 sourceC
Destructive

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 nameB
Destructive

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 settingsB
Destructive

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 settingsC
Destructive

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 settingsC
Destructive

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 settingsC
Destructive

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 settingsC
Destructive

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 settingsB
Destructive

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 changesB
Destructive

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 monitorB
Destructive

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 reportC
Destructive

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 subscriptionC
Destructive

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 roleA
Destructive

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 scriptA
Destructive

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 settingA
Destructive

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 userC
Destructive

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 packageC
Destructive

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 chunksC
DestructiveIdempotent

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 terminatesA
Read-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

    C2.7/5.0

    Scored across 167 tools

    Disambiguation2/5

    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.

    Naming Consistency3/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      A
      quality
      B
      maintenance
      An MCP server for Action1, a cloud-native RMM platform, enabling remote monitoring, patch management, and endpoint management through Action1's API.
      6
      4
      Apache 2.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      MCP 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.
      1
      Apache 2.0
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      10
      27
      MIT
    • F
      license
      Not graded
      quality
      D
      maintenance
      Autonomous network monitoring and auto-remediation MCP server for Claude Desktop, enabling observation, planning, human-approved execution, verification, and session summarization.
      1
      -