Action1 MCP by usefulapi
Read endpoints, missing updates, CVE vulnerabilities, installed software and reports in Action1.
Should I use this
Quality & Safety
Findings (3)
- LOWin action1_list_vulnerability_endpoints
- LOWin action1_list_installed_software
- LOWin action1_list_automation_instances
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"action1": {
"url": "https://action1.usefulapi.io/mcp"
}
}
}Remote endpoints
https://action1.usefulapi.io/mcpstreamable-httpWhat it can do
Tool inventory
Tools (16)
🟢action1_list_organizations(admin)
List the Action1 organizations these API credentials can reach, with their ids. Call this first: most other tools need an organization id. Action1 API: GET /organizations.
Input Schema
{
"type": "object",
"properties": {
"admin": {
"description": "true = only organizations where the credentials are at least an organization admin.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_get_current_user
Get the settings and roles of the user behind these API credentials. Use it to check what the credentials can see. Action1 API: GET /me.
Input Schema
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_search(orgId, query, limit)
Search endpoints, software and other Action1 objects in one organization by text. Action1 API: GET /search/{orgId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"query": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Search text."
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
}
},
"required": [
"orgId",
"query"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_endpoints(orgId, from, limit, sortby, filter, ...)
List the managed endpoints (computers) of one organization or of all organizations, with status, OS, last-seen time and update state. Filter by status, update state, OS or reboot need. Action1 API: GET /endpoints/managed/{orgId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"description": "Organization id from action1_list_organizations, or 'all' (default) for every organization these credentials can reach.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"status": {
"description": "Agent connection status.",
"type": "string",
"enum": [
"Connected",
"Disconnected",
"Pending Uninstall"
]
},
"online_status": {
"description": "Last-seen online status.",
"type": "string",
"enum": [
"SUCCESS",
"WARNING",
"ERROR"
]
},
"update_status": {
"description": "Update status of the endpoint.",
"type": "string",
"enum": [
"SUCCESS",
"WARNING",
"ERROR"
]
},
"vulnerability_status": {
"description": "Vulnerability status of the endpoint.",
"type": "string",
"enum": [
"SUCCESS",
"WARNING",
"ERROR"
]
},
"reboot_required": {
"description": "Only endpoints that need a reboot (Yes) or not (No).",
"type": "string",
"enum": [
"Yes",
"No"
]
},
"os": {
"description": "Operating system filter, as Action1 names it (for example Windows 11).",
"type": "string",
"maxLength": 100
},
"fields": {
"description": "Extra detail. 'missing_updates' or 'vulnerabilities' adds counts (slower). '*' adds all of them.",
"type": "string",
"enum": [
"*",
"missing_updates",
"vulnerabilities"
]
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_get_endpoint(orgId, endpointId)
Get one managed endpoint: name, OS, hardware, agent version, last seen and status. Action1 API: GET /endpoints/managed/{orgId}/{endpointId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"description": "Organization id from action1_list_organizations, or 'all' (default) for every organization these credentials can reach.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"endpointId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Endpoint id from action1_list_endpoints."
}
},
"required": [
"endpointId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_endpoint_groups(orgId, from, limit, sortby, filter)
List the endpoint groups (dynamic or manual sets of endpoints) of one organization. Action1 API: GET /endpoints/groups/{orgId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
}
},
"required": [
"orgId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_group_endpoints(orgId, groupId, from, limit, sortby, ...)
List the endpoints in one endpoint group, with the same filters as action1_list_endpoints. Action1 API: GET /endpoints/groups/{orgId}/{groupId}/contents.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"groupId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Endpoint group id from action1_list_endpoint_groups."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"status": {
"description": "Agent connection status.",
"type": "string",
"enum": [
"Connected",
"Disconnected",
"Pending Uninstall"
]
},
"online_status": {
"description": "Last-seen online status.",
"type": "string",
"enum": [
"SUCCESS",
"WARNING",
"ERROR"
]
},
"update_status": {
"description": "Update status of the endpoint.",
"type": "string",
"enum": [
"SUCCESS",
"WARNING",
"ERROR"
]
},
"vulnerability_status": {
"description": "Vulnerability status of the endpoint.",
"type": "string",
"enum": [
"SUCCESS",
"WARNING",
"ERROR"
]
},
"reboot_required": {
"description": "Only endpoints that need a reboot (Yes) or not (No).",
"type": "string",
"enum": [
"Yes",
"No"
]
},
"os": {
"description": "Operating system filter, as Action1 names it (for example Windows 11).",
"type": "string",
"maxLength": 100
}
},
"required": [
"orgId",
"groupId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_missing_updates(orgId, from, limit, sortby, filter, ...)
List the software updates (patches) that endpoints still miss, across one organization or all organizations. Filter by approval status and severity. Action1 API: GET /updates/{orgId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"description": "Organization id from action1_list_organizations, or 'all' (default) for every organization these credentials can reach.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"approval_status": {
"description": "Approval status of the update.",
"type": "string",
"enum": [
"New",
"Approved",
"Declined",
"-Declined"
]
},
"security_severity": {
"description": "Security severity. '-Critical' means every severity except Critical.",
"type": "string",
"enum": [
"-Critical",
"Critical",
"Important",
"Moderate",
"Low",
"Unspecified"
]
},
"only_latest": {
"description": "true (default) hides superseded updates.",
"type": "boolean"
},
"custom": {
"description": "true = only custom packages, false = only built-in packages.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_package_updates(orgId, packageId, from, limit, sortby, ...)
List the updates of one software package and the endpoints they affect. Action1 API: GET /updates/{orgId}/{packageId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"description": "Organization id from action1_list_organizations, or 'all' (default) for every organization these credentials can reach.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"packageId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Software package id from action1_list_package_updates or action1_list_missing_updates."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"approval_status": {
"description": "Approval status of the update.",
"type": "string",
"enum": [
"New",
"Approved",
"Declined",
"-Declined"
]
},
"security_severity": {
"description": "Security severity. '-Critical' means every severity except Critical.",
"type": "string",
"enum": [
"-Critical",
"Critical",
"Important",
"Moderate",
"Low",
"Unspecified"
]
},
"only_latest": {
"description": "true (default) hides superseded updates.",
"type": "boolean"
}
},
"required": [
"packageId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_vulnerabilities(orgId, from, limit, sortby, filter, ...)
List the CVE vulnerabilities found on endpoints in one organization or all organizations, with CVSS score, remediation deadline and affected endpoint counts. Action1 API: GET /vulnerabilities/{orgId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"description": "Organization id from action1_list_organizations, or 'all' (default) for every organization these credentials can reach.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"score": {
"description": "CVSS severity band.",
"type": "string",
"enum": [
"Critical",
"High",
"Medium",
"Low"
]
},
"remediation_status": {
"description": "Remediation status of the CVE.",
"type": "string",
"enum": [
"Overdue",
"Due_soon",
"Overdue_due_soon",
"Due_later",
"Control_applied",
"All_except_control_applied"
]
},
"endpoint_id": {
"description": "Only vulnerabilities on this endpoint id.",
"type": "string",
"maxLength": 100
},
"cve_ids": {
"description": "Comma-separated CVE ids, e.g. CVE-2021-44228,CVE-2023-0001.",
"type": "string",
"maxLength": 500
},
"published_date_start": {
"description": "Earliest CVE publish date, yyyy-mm-dd.",
"type": "string",
"maxLength": 20
},
"published_date_end": {
"description": "Latest CVE publish date, yyyy-mm-dd.",
"type": "string",
"maxLength": 20
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_get_vulnerability(orgId, cveId)
Get one CVE as Action1 sees it in one organization: CVSS vector, exploitability, CISA KEV flag, remediation status and deadline. Action1 API: GET /vulnerabilities/{orgId}/{cveId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"cveId": {
"type": "string",
"pattern": "^CVE-\\d{4}-\\d{4,}$",
"description": "CVE id, e.g. CVE-2021-44228."
}
},
"required": [
"orgId",
"cveId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_vulnerability_endpoints(orgId, cveId, from, limit, sortby, ...)
List the endpoints in one organization or all organizations that a CVE affects, with the software involved. Action1 API: GET /vulnerabilities/{orgId}/{cveId}/endpoints.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"description": "Organization id from action1_list_organizations, or 'all' (default) for every organization these credentials can reach.",
"type": "string",
"minLength": 1,
"maxLength": 100
},
"cveId": {
"type": "string",
"pattern": "^CVE-\\d{4}-\\d{4,}$",
"description": "CVE id, e.g. CVE-2021-44228."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"product_names": {
"description": "Comma-separated product names to narrow the list.",
"type": "string",
"maxLength": 300
}
},
"required": [
"cveId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_installed_software(orgId, from, limit, sortby, filter, ...)
List the software installed across the endpoints of one organization (the software inventory). Action1 API: GET /installed-software/{orgId}/data.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"live_only": {
"description": "true = only results from the latest inventory scan.",
"type": "boolean"
}
},
"required": [
"orgId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_automation_instances(orgId, from, limit, sortby, filter, ...)
List automation runs (instances) of one organization with their status and completion. Action1 API: GET /automations/instances/{orgId}.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"status": {
"description": "Run status.",
"type": "string",
"enum": [
"Pending",
"Stopped",
"Running",
"Success",
"Warning",
"Error"
]
},
"completed": {
"description": "true = only completed runs, false = only runs still going.",
"type": "boolean"
},
"endpoint_id": {
"description": "Only runs that touched this endpoint id.",
"type": "string",
"maxLength": 100
}
},
"required": [
"orgId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_list_reports(subtree)
List the Action1 report definitions available to these credentials (built-in and custom). Use the report ids with action1_get_report_rows. Action1 API: GET /reports/all.
Input Schema
{
"type": "object",
"properties": {
"subtree": {
"description": "true = include every report in the category tree.",
"type": "boolean"
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢action1_get_report_rows(orgId, reportId, from, limit, sortby, ...)
Get the rows of one Action1 report for one organization. Use action1_list_reports for report ids. Action1 API: GET /reportdata/{orgId}/{reportId}/data.
Input Schema
{
"type": "object",
"properties": {
"orgId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Organization id from action1_list_organizations."
},
"reportId": {
"type": "string",
"minLength": 1,
"maxLength": 100,
"description": "Report id from action1_list_reports."
},
"from": {
"description": "Number of the first record to return (paging).",
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991
},
"limit": {
"description": "Maximum records per page, 1-500.",
"type": "integer",
"minimum": 1,
"maximum": 500
},
"sortby": {
"description": "Sort field. Prefix with '-' for descending, e.g. '-name'.",
"type": "string",
"maxLength": 100
},
"filter": {
"description": "Case-insensitive text. Keeps records where any field contains it.",
"type": "string",
"maxLength": 200
},
"live_only": {
"description": "true = only live results.",
"type": "boolean"
},
"details": {
"description": "true = expand the details of a summary report (summary reports only).",
"type": "boolean"
},
"endpoint_id": {
"description": "Only rows for this endpoint id.",
"type": "string",
"maxLength": 100
}
},
"required": [
"orgId",
"reportId"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}Community
Evidence