datadog-mcp 5.2.1 → 5.3.0

package/dist/index.js

@@ -21,7 +21,8 @@ var ALL_TOOLS = [
   "teams",
   "tags",
   "usage",
-  "auth"
+  "auth",
+  "schema"
 ];
 var configSchema = z.object({
   datadog: z.object({
@@ -1248,8 +1249,8 @@ async function enrichWithMonitorMetadata(events, monitorsApi) {
     const response = await monitorsApi.listMonitors({
       pageSize: 1e3
     });
-    const monitors = response ?? [];
-    for (const monitor of monitors) {
+    const monitors2 = response ?? [];
+    for (const monitor of monitors2) {
       if (monitor.id && monitorIds.has(monitor.id)) {
         monitorCache.set(monitor.id, monitor);
       }
@@ -1525,7 +1526,7 @@ async function listMonitors(api, params, limits, site) {
     tags: params.tags?.join(","),
     groupStates: params.groupStates?.join(",")
   });
-  const monitors = response.slice(0, effectiveLimit).map((m) => formatMonitor(m, site));
+  const monitors2 = response.slice(0, effectiveLimit).map((m) => formatMonitor(m, site));
   const statusCounts = {
     total: response.length,
     alert: response.filter((m) => m.overallState === "Alert").length,
@@ -1534,7 +1535,7 @@ async function listMonitors(api, params, limits, site) {
     noData: response.filter((m) => m.overallState === "No Data").length
   };
   return {
-    monitors,
+    monitors: monitors2,
     summary: statusCounts,
     datadog_url: buildMonitorsListUrl(
       { name: params.name, tags: params.tags, groupStates: params.groupStates },
@@ -1555,7 +1556,7 @@ async function getMonitor(api, id, site) {
 }
 async function searchMonitors(api, query, limits, site) {
   const response = await api.searchMonitors({ query });
-  const monitors = (response.monitors ?? []).map((m) => ({
+  const monitors2 = (response.monitors ?? []).map((m) => ({
     id: m.id ?? 0,
     name: m.name ?? "",
     status: String(m.status ?? "unknown"),
@@ -1564,9 +1565,9 @@ async function searchMonitors(api, query, limits, site) {
     url: buildMonitorUrl(m.id ?? 0, site)
   }));
   return {
-    monitors,
+    monitors: monitors2,
     metadata: {
-      totalCount: response.metadata?.totalCount ?? monitors.length,
+      totalCount: response.metadata?.totalCount ?? monitors2.length,
       pageCount: response.metadata?.pageCount ?? 1,
       page: response.metadata?.page ?? 0
     },
@@ -1908,12 +1909,12 @@ async function listDashboards(api, params, limits) {
   const response = await api.listDashboards({
     filterShared: false
   });
-  let dashboards = response.dashboards ?? [];
+  let dashboards2 = response.dashboards ?? [];
   if (params.name) {
     const lowerName = params.name.toLowerCase();
-    dashboards = dashboards.filter((d) => d.title?.toLowerCase().includes(lowerName));
+    dashboards2 = dashboards2.filter((d) => d.title?.toLowerCase().includes(lowerName));
   }
-  const result = dashboards.slice(0, effectiveLimit).map(formatDashboardSummary);
+  const result = dashboards2.slice(0, effectiveLimit).map(formatDashboardSummary);
   return {
     dashboards: result,
     total: response.dashboards?.length ?? 0
@@ -2543,9 +2544,9 @@ async function listMetrics(api, params, _limits) {
     host: void 0,
     tagFilter: params.query
   });
-  const metrics = response.metrics ?? [];
+  const metrics2 = response.metrics ?? [];
   return {
-    metrics,
+    metrics: metrics2,
     total: response.metrics?.length ?? 0
   };
 }
@@ -3202,9 +3203,9 @@ async function listSlos(api, params, limits) {
     tagsQuery: params.tags?.join(","),
     limit: effectiveLimit
   });
-  const slos = (response.data ?? []).map(formatSlo);
+  const slos2 = (response.data ?? []).map(formatSlo);
   return {
-    slos,
+    slos: slos2,
     total: response.data?.length ?? 0
   };
 }
@@ -4121,23 +4122,23 @@ async function getPerformanceMetrics(api, params, _limits, site) {
   });
   const buckets = (response.data?.buckets ?? []).map((bucket) => {
     const computes = bucket.computes ?? {};
-    const metrics = {};
+    const metrics2 = {};
     for (const metricName of requestedMetrics) {
       const config = METRIC_CONFIGS[metricName];
       if (!config) continue;
-      metrics[metricName] = {};
+      metrics2[metricName] = {};
       for (const aggregation of config.aggregations) {
         const computeIndex = computeConfigs.findIndex(
           (c) => c.metric === config.field && c.aggregation === aggregation
         );
         const key = `c${computeIndex}`;
         const value = computes[key]?.value;
-        metrics[metricName][String(aggregation)] = value ?? null;
+        metrics2[metricName][String(aggregation)] = value ?? null;
       }
     }
     return {
       by: bucket.by ?? {},
-      metrics
+      metrics: metrics2
     };
   });
   return {
@@ -4239,7 +4240,7 @@ function registerRumTool(server, api, limits, site = "datadoghq.com") {
       limit,
       groupBy,
       compute,
-      metrics,
+      metrics: metrics2,
       applicationId,
       sessionId,
       viewId
@@ -4258,7 +4259,7 @@ function registerRumTool(server, api, limits, site = "datadoghq.com") {
             );
           case "performance":
             return toolResult(
-              await getPerformanceMetrics(api, { query, from, to, groupBy, metrics }, limits, site)
+              await getPerformanceMetrics(api, { query, from, to, groupBy, metrics: metrics2 }, limits, site)
             );
           case "waterfall":
             if (!applicationId || !sessionId) {
@@ -5274,6 +5275,224 @@ async function validateCredentials(clients) {
   }
 }
 
+// src/tools/schema.ts
+import { z as z21 } from "zod";
+
+// src/schema/dashboards.ts
+var dashboards = {
+  palettes: [
+    "blue",
+    "custom_bg",
+    "custom_image",
+    "custom_text",
+    "gray_on_white",
+    "grey",
+    "green",
+    "orange",
+    "red",
+    "red_on_white",
+    "white_on_gray",
+    "white_on_green",
+    "green_on_white",
+    "white_on_red",
+    "white_on_yellow",
+    "yellow_on_white",
+    "black_on_light_yellow",
+    "black_on_light_green",
+    "black_on_light_red"
+  ],
+  widgetTypes: [
+    "alert_graph",
+    "alert_value",
+    "bar_chart",
+    "change",
+    "check_status",
+    "distribution",
+    "event_stream",
+    "event_timeline",
+    "free_text",
+    "funnel",
+    "geomap",
+    "group",
+    "heatmap",
+    "hostmap",
+    "iframe",
+    "image",
+    "list_stream",
+    "log_stream",
+    "manage_status",
+    "note",
+    "powerpack",
+    "query_table",
+    "query_value",
+    "run_workflow",
+    "scatterplot",
+    "servicemap",
+    "slo",
+    "slo_list",
+    "split_group",
+    "sunburst",
+    "timeseries",
+    "toplist",
+    "topology_map",
+    "trace_service",
+    "treemap"
+  ],
+  displayTypes: ["area", "bars", "line", "overlay"],
+  lineTypes: ["dashed", "dotted", "solid"],
+  lineWidths: ["normal", "thick", "thin"],
+  comparators: ["=", ">", ">=", "<", "<="],
+  aggregators: ["avg", "last", "max", "min", "sum", "percentile"],
+  layoutTypes: ["ordered", "free"],
+  responseFormats: ["timeseries", "scalar", "event_list"],
+  sortOrders: ["asc", "desc"],
+  textAligns: ["center", "left", "right"],
+  verticalAligns: ["center", "top", "bottom"],
+  horizontalAligns: ["center", "left", "right"],
+  imageSizings: ["fill", "contain", "cover", "none", "scale-down", "zoom", "fit", "center"],
+  eventSizes: ["s", "l"],
+  tickEdges: ["bottom", "left", "right", "top"],
+  sizeFormats: ["small", "medium", "large"],
+  viewModes: ["overall", "component", "both"],
+  groupings: ["check", "cluster"],
+  liveSpans: [
+    "1m",
+    "5m",
+    "10m",
+    "15m",
+    "30m",
+    "1h",
+    "4h",
+    "1d",
+    "2d",
+    "1w",
+    "1mo",
+    "3mo",
+    "6mo",
+    "week_to_date",
+    "month_to_date",
+    "1y",
+    "alert"
+  ],
+  eventsDataSources: [
+    "logs",
+    "spans",
+    "network",
+    "rum",
+    "security_signals",
+    "profiles",
+    "audit",
+    "events",
+    "ci_tests",
+    "ci_pipelines",
+    "incident_analytics",
+    "product_analytics",
+    "on_call_events"
+  ],
+  metricAggregations: ["avg", "min", "max", "sum", "last", "area", "l2norm", "percentile"],
+  eventAggregations: [
+    "count",
+    "cardinality",
+    "median",
+    "pc75",
+    "pc90",
+    "pc95",
+    "pc98",
+    "pc99",
+    "sum",
+    "min",
+    "max",
+    "avg"
+  ],
+  docsUrl: "https://docs.datadoghq.com/api/latest/dashboards/"
+};
+
+// src/schema/metrics.ts
+var metrics = {
+  aggregators: ["avg", "max", "min", "sum", "count"],
+  rollupMethods: ["avg", "max", "min", "sum", "count"],
+  metricTypes: ["gauge", "rate", "count", "distribution"],
+  dataSources: ["metrics", "logs", "spans", "rum", "events", "profiles", "cloud_cost"],
+  docsUrl: "https://docs.datadoghq.com/api/latest/metrics/"
+};
+
+// src/schema/monitors.ts
+var monitors = {
+  types: [
+    "composite",
+    "event alert",
+    "log alert",
+    "metric alert",
+    "process alert",
+    "query alert",
+    "rum alert",
+    "service check",
+    "synthetics alert",
+    "trace-analytics alert",
+    "slo alert",
+    "event-v2 alert",
+    "audit alert",
+    "ci-pipelines alert",
+    "ci-tests alert",
+    "error-tracking alert",
+    "database-monitoring alert",
+    "network-performance alert",
+    "cost alert",
+    "data-quality alert",
+    "network-path alert"
+  ],
+  aggregators: ["avg", "last", "max", "min", "sum", "count", "percentile"],
+  comparators: [">", "<", ">=", "<=", "="],
+  priorities: ["1", "2", "3", "4", "5"],
+  notifyStates: ["Alert", "No Data", "Warn", "OK"],
+  docsUrl: "https://docs.datadoghq.com/api/latest/monitors/"
+};
+
+// src/schema/slos.ts
+var slos = {
+  types: ["metric", "monitor", "time_slice"],
+  timeframes: ["7d", "30d", "90d", "custom"],
+  correctionCategories: ["Scheduled Maintenance", "Outside Business Hours", "Deployment", "Other"],
+  measures: [
+    "good_events",
+    "bad_events",
+    "good_minutes",
+    "bad_minutes",
+    "slo_status",
+    "error_budget_remaining",
+    "burn_rate",
+    "error_budget_burndown"
+  ],
+  docsUrl: "https://docs.datadoghq.com/api/latest/service-level-objectives/"
+};
+
+// src/schema/index.ts
+var schemas = { dashboards, metrics, monitors, slos };
+var schemaResources = Object.keys(schemas);
+
+// src/tools/schema.ts
+var ResourceSchema = z21.enum(schemaResources);
+var InputSchema20 = {
+  resource: ResourceSchema.describe(
+    "Datadog resource type to get schema for: dashboards, metrics, monitors, slos"
+  )
+};
+function getSchema(resource) {
+  const schema = schemas[resource];
+  return { resource, schema };
+}
+function registerSchemaTool(server) {
+  server.tool(
+    "schema",
+    "Get valid enum values for Datadog API fields. Returns palettes, widget types, aggregators, comparators, time spans, and other valid values for constructing dashboards, monitors, metrics queries, and SLOs. Use this to discover valid options before creating or updating Datadog resources.",
+    InputSchema20,
+    async ({ resource }) => {
+      const result = getSchema(resource);
+      return toolResult(result);
+    }
+  );
+}
+
 // src/tools/index.ts
 function registerAllTools(server, clients, limits, features, site = "datadoghq.com", datadogConfig) {
   const { readOnly, disabledTools } = features;
@@ -5315,6 +5534,7 @@ function registerAllTools(server, clients, limits, features, site = "datadoghq.c
   if (enabled("tags")) registerTagsTool(server, clients.tags, limits, readOnly);
   if (enabled("usage")) registerUsageTool(server, clients.usage, limits);
   if (enabled("auth")) registerAuthTool(server, clients);
+  if (enabled("schema")) registerSchemaTool(server);
 }
 
 // src/server.ts