Action1 MCP by usefulapi

Read endpoints, missing updates, CVE vulnerabilities, installed software and reports in Action1.

¿Debería usar esto?

Calidad y seguridad

A
Calidad de la descripción
100%
Integridad del esquema
93%
Calidad de los nombres
76%
Riesgo de envenenamiento
100%
Coincidencia de permisos
100%
Cumplimiento del protocolo
100%

Hallazgos (3)

  • LOWTool 'action1_list_vulnerability_endpoints' name length outside 3-30 rangeen action1_list_vulnerability_endpoints
  • LOWTool 'action1_list_installed_software' name length outside 3-30 rangeen action1_list_installed_software
  • LOWTool 'action1_list_automation_instances' name length outside 3-30 rangeen action1_list_automation_instances

Basado en el análisis automatizado de las definiciones de herramientas y el cumplimiento del protocolo.

Costo de contexto

~4,418Tokens (definiciones de herramientas)
~2.5 KBTamaño de respuesta típico
Impacto significativo en la atención (3.45% del contexto de 128k)

Este es el número aproximado de tokens que se consumen cada vez que las herramientas del servidor se cargan en el contexto de un modelo. Los recuentos más altos reducen la atención disponible para otras tareas.

Instalar

Instalación con un clic

Agrega esto a tu archivo `claude_desktop_config.json`:

{
  "mcpServers": {
    "action1": {
      "url": "https://action1.usefulapi.io/mcp"
    }
  }
}

Puntos de conexión remotos

https://action1.usefulapi.io/mcpstreamable-http

Qué puede hacer

Inventario de herramientas

Herramientas (16)

🟢 Solo lectura🟡 Escritura🔴 Eliminación⚪ Desconocido
🟢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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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}.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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.

Esquema de entrada

{
  "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"
}

Comunidad

Califica este servidor

Evidencia

Observaciones recientes

verificadoversión no registrada16 herramientas