@aaa-sentinel/mcp-server 0.3.0 → 0.5.0

package/README.md

@@ -117,6 +117,7 @@ status as plain JSON.
 | `get_cost_by_tags` | `accountId` | `reports:read` | Pro |
 | `get_multicloud_report` | — | `reports:read` | Pro |
 | `list_alerts` | `limit?` | `alerts:read` | Pro |
+| `get_alert_policies` | `clientId?`, `accountId?` | `alerts:read` | Pro |
 | `list_disabled_rules` | — | `rules:read` | Pro |
 | `list_business_metrics` | — | `metrics:read` | Business |
 | `get_metric_values` | `metricId`, `billingPeriod` | `metrics:read` | Business |
@@ -137,12 +138,17 @@ status as plain JSON.
 | `get_agent_playbook` | `playbookId` | `agent:read` | Business |
 | `list_agent_playbook_templates` | — | `agent:read` | Business |
 | `list_monitors` | `pinned?`, `clientId?` | `monitoring:read` | Pro |
+| `count_monitors_by_client` | — | `monitoring:read` | Pro |
 | `get_monitor` | `monitorId` | `monitoring:read` | Pro |
 | `list_monitor_results` | `monitorId`, `limit?`, `before?` | `monitoring:read` | Pro |
 | `get_monitor_uptime` | `monitorId`, `days?` | `monitoring:read` | Pro |
 | `list_monitoring_services` | — | `monitoring:read` | Pro |
 | `get_monitoring_service` | `serviceId` | `monitoring:read` | Pro |
 | `get_service_history` | `serviceId`, `limit?` | `monitoring:read` | Pro |
+| `list_monitoring_incidents` | `state?`, `monitorId?`, `limit?`, `before?` | `monitoring:read` | Pro |
+| `get_monitoring_incident` | `incidentId` | `monitoring:read` | Pro |
+| `list_status_pages` | — | `monitoring:read` | Pro |
+| `get_status_page` | `pageId` | `monitoring:read` | Pro |
 
 In `list_savings`, `type` is one of `compute`, `storage`, `network`, `database`, `serverless`,
 `governance`. `source` is one of `own`, `corroborated`, `securityhub`, `guardduty`, `defender`,

package/dist/cli.js

@@ -4420,6 +4420,13 @@ var TOOLS = [
     argsSchema: external_exports.object({ limit: external_exports.number().int().min(1).max(100).optional() }),
     handler: async ({ limit }, config) => apiGet("/v1/alerts", { limit: asText(limit) }, config)
   }),
+  defineTool({
+    name: "get_alert_policies",
+    description: "Get the alert policy in force for each source (cost, security, monitoring) at the organization, a managed client or an account, plus what that level sets itself: minimum severity, quiet hours, maintenance windows and escalation, the filters that decide whether an alert goes out. `channels` only limits delivery to the channels configured for the level, which this tool does not show. Pass clientId or accountId, not both; the organization and client levels need a token that sees the whole organization. Requires the alerts:read scope.",
+    inputSchema: objectWith({ clientId: CLIENT_ID, accountId: ACCOUNT_ID }),
+    argsSchema: external_exports.object({ clientId: external_exports.string().min(1).optional(), accountId: external_exports.string().min(1).optional() }),
+    handler: async ({ clientId: clientId2, accountId }, config) => apiGet("/v1/alerts/policies", { clientId: clientId2, accountId }, config)
+  }),
   defineTool({
     name: "list_disabled_rules",
     description: 'List the detection rules the customer has turned off, so you can tell "nothing found" apart from "that check is disabled". Requires the rules:read scope.',
@@ -4591,6 +4598,13 @@ var TOOLS = [
     argsSchema: external_exports.object({ pinned: external_exports.boolean().optional(), clientId: external_exports.string().min(1).optional() }),
     handler: async ({ pinned, clientId: clientId2 }, config) => apiGet("/v1/monitoring/monitors", { pinned: pinned ? "true" : void 0, clientId: clientId2 }, config)
   }),
+  defineTool({
+    name: "count_monitors_by_client",
+    description: "Count the monitors and flows of each managed client, to rebill monitoring per client. Every client the token can see is listed, with zeros if it has none; the organization\u2019s own monitors do not count. Requires the monitoring:read scope and the Pro plan or above.",
+    inputSchema: { type: "object", properties: {} },
+    argsSchema: external_exports.object({}),
+    handler: async (_args, config) => apiGet("/v1/monitoring/clients/counts", void 0, config)
+  }),
   defineTool({
     name: "get_monitor",
     description: "Get one monitor with its definition, current state, since when, and last result (outcome, reason code, status code, latency). Requires the monitoring:read scope and the Pro plan or above.",
@@ -4645,15 +4659,61 @@ var TOOLS = [
     ),
     argsSchema: external_exports.object({ serviceId: external_exports.string().min(1), limit: external_exports.number().int().min(1).max(200).optional() }),
     handler: async ({ serviceId, limit }, config) => apiGet(`/v1/monitoring/services/${encodeURIComponent(serviceId)}/history`, { limit: asText(limit) }, config)
+  }),
+  defineTool({
+    name: "list_monitoring_incidents",
+    description: 'List monitoring incidents (each alerted outage, from when it started until it recovered), newest first, with duration, who acknowledged it and what it cost: the business impact per minute set on the monitor and, for cloud resources, an approximate cloud cost, in the organization currency. This answers "what is on fire and who is on it". Filter by state (open or resolved) or monitor. Paginated: pass the returned "nextCursor" as "before"; a page can come back short or empty with a cursor. Requires the monitoring:read scope and the Pro plan or above.',
+    inputSchema: objectWith({
+      state: { type: "string", enum: ["open", "resolved"], description: "Only open or only resolved incidents (optional)." },
+      monitorId: { ...MONITOR_ID, description: "Only the incidents of this monitor (optional)." },
+      limit: { type: "integer", minimum: 1, maximum: 200, description: "Page size (default 50)." },
+      before: { type: "string", description: 'The "nextCursor" value of the previous page (optional).' }
+    }),
+    argsSchema: external_exports.object({
+      state: external_exports.enum(["open", "resolved"]).optional(),
+      monitorId: external_exports.string().min(1).optional(),
+      limit: external_exports.number().int().min(1).max(200).optional(),
+      before: external_exports.string().min(1).optional()
+    }),
+    handler: async ({ state, monitorId, limit, before }, config) => apiGet("/v1/monitoring/incidents", { state, monitorId, limit: asText(limit), before }, config)
+  }),
+  defineTool({
+    name: "get_monitoring_incident",
+    description: "Get one monitoring incident with its timeline (opened, re-alerted, acknowledged, notes, closed), its cause (reason code, status code, failed flow step) and what it cost in the organization currency. Requires the monitoring:read scope and the Pro plan or above.",
+    inputSchema: objectWith({ incidentId: { type: "string", description: "Incident identifier, as returned by list_monitoring_incidents." } }, ["incidentId"]),
+    argsSchema: external_exports.object({ incidentId: external_exports.string().min(1) }),
+    handler: async ({ incidentId }, config) => apiGet(`/v1/monitoring/incidents/${encodeURIComponent(incidentId)}`, void 0, config)
+  }),
+  defineTool({
+    name: "list_status_pages",
+    description: "List the status pages (the public or link-only pages that show customers whether each service is up), with which client each belongs to, its services, language and custom domain, and how many more fit in the plan. A private page comes without its address: that link opens it for anyone. Requires the monitoring:read scope and the Pro plan or above.",
+    inputSchema: objectWith({}),
+    argsSchema: external_exports.object({}),
+    handler: async (_args, config) => {
+      const body = await apiGet("/v1/monitoring/status-pages", void 0, config);
+      return { ...body, pages: (body.pages ?? []).map(withoutPrivateLink) };
+    }
+  }),
+  defineTool({
+    name: "get_status_page",
+    description: "Get one status page: its settings and the step its custom domain is at, with the DNS records still to create. A private page comes without its address: that link opens it for anyone. Requires the monitoring:read scope and the Pro plan or above.",
+    inputSchema: objectWith({ pageId: { type: "string", description: "Status page identifier, as returned by list_status_pages." } }, ["pageId"]),
+    argsSchema: external_exports.object({ pageId: external_exports.string().min(1) }),
+    handler: async ({ pageId }, config) => withoutPrivateLink(await apiGet(`/v1/monitoring/status-pages/${encodeURIComponent(pageId)}`, void 0, config))
   })
 ];
+function withoutPrivateLink(page) {
+  if (page["visibility"] !== "private") return page;
+  const { url: _url, ...rest } = page;
+  return rest;
+}
 function findTool(name) {
   return TOOLS.find((tool) => tool.name === name);
 }
 
 // src/protocol.ts
 var SERVER_NAME = "aaa-sentinel-mcp";
-var SERVER_VERSION = "0.3.0";
+var SERVER_VERSION = "0.5.0";
 var SUPPORTED_PROTOCOL_VERSIONS = ["2025-06-18", "2025-03-26", "2024-11-05"];
 var PARSE_ERROR = -32700;
 var INVALID_REQUEST = -32600;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aaa-sentinel/mcp-server",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Read-only MCP server for AAA Sentinel: query cloud costs, savings, security posture, AI spend, uptime monitoring, the remediation agent and managed clients from an AI assistant",
   "license": "MIT",
   "type": "module",