datadog-mcp 5.7.0 → 5.8.1

package/README.md

@@ -158,7 +158,7 @@ When running with `--transport=http`:
 | `events` | get | Events | Get event by ID | `events_read` |
 | `events` | create | Events | Create an event | `events_read` |
 | `events` | search | Events | Search events with v2 API and cursor pagination. Optional `transitionType` filter (e.g. `["alert","alert recovery"]`) restricts to monitor state-transition events — without it, `source:alert` includes renotifies. For monitor-specific fires use `monitors action=history`. Optional `timezone` adds `*Local` ISO 8601 siblings to every timestamp. Zero-result responses include a `diagnostics` array hinting at the cause (`UNINDEXED_TAG_PREFIX`, `NARROW_TIME_RANGE`, `RESTRICTIVE_SOURCE_FILTER`). | `events_read` |
-| `events` | histogram | Events | Server-side bucketing of events by `hour_of_day`, `day_of_week`, or `day_of_month` in an IANA `timezone` (DST-safe via `Intl.DateTimeFormat`). Cursor-paginates the underlying search; cap at `limits.maxEventsForHistogram` (default 5000, `MCP_MAX_EVENTS_HISTOGRAM` env var). When the cap is hit, returns `bucketCountIncomplete: true` and `nextCursor` for continuation. | `events_read` |
+| `events` | histogram | Events | Server-side bucketing of events by `hour_of_day`, `day_of_week`, or `day_of_month` in an IANA `timezone` (DST-safe via `Intl.DateTimeFormat`). Accepts the same `transitionType` filter as `search` so monitor histograms can exclude renotifies. Cursor-paginates the underlying search; cap at `limits.maxEventsForHistogram` (default 5000, `MCP_MAX_EVENTS_HISTOGRAM` env var). When the cap is hit, returns `bucketCountIncomplete: true` and `nextCursor` for continuation. | `events_read` |
 | `events` | aggregate | Events | Client-side aggregation by monitor_name, source, etc. | `events_read` |
 | `events` | top | Events | Top N event groups by count with generic groupBy support (deployments, configs, alerts, etc.). Groups without context tags are included as "no_context" | `events_read` |
 | `events` | timeseries | Events | Time-bucketed alert trends (hourly/daily counts) | `events_read` |

package/dist/index.js

@@ -302786,6 +302786,10 @@ function buildRumSessionUrl(applicationId, sessionId, site = "datadoghq.com") {
   const base = getAppBaseUrl(site);
   return `${base}/rum/replay/sessions/${sessionId}?applicationId=${encodeURIComponent(applicationId)}`;
 }
+function buildSloUrl(sloId, site = "datadoghq.com") {
+  const base = getAppBaseUrl(site);
+  return `${base}/slo/${sloId}`;
+}
 
 // src/utils/time.ts
 function hoursAgo(hours) {
@@ -303150,8 +303154,41 @@ var InputSchema = {
   ),
   timezone: external_exports.string().optional().describe(
     'Optional IANA timezone (e.g. "UTC", "Europe/Paris"). DST-safe. For histogram: controls hour/day bucketing (default: UTC). For search/aggregate/top/incidents read actions: adds sibling *Local ISO 8601 strings (e.g. timestampLocal) next to existing timestamps. Omit for byte-identical legacy shape.'
+  ),
+  // Projection — applied to search action only. Reduces response payload
+  // when callers only need a subset of fields. Unknown field names are silently ignored so
+  // older clients are not broken when the EventSummary shape evolves.
+  fields: external_exports.array(external_exports.string()).optional().describe(
+    "Search action only: return only these event fields. Allowed values: id, title, message, timestamp, priority, source, tags, alertType, host, monitorId, monitorInfo, monitorMetadata (only populated when enrich=true). Default: full event."
   )
 };
+var ALLOWED_EVENT_FIELDS = /* @__PURE__ */ new Set([
+  "id",
+  "title",
+  "message",
+  "timestamp",
+  "priority",
+  "source",
+  "tags",
+  "alertType",
+  "host",
+  "monitorId",
+  "monitorInfo",
+  "monitorMetadata"
+]);
+function pickEventFields(event, fields) {
+  if (!fields || fields.length === 0) {
+    return event;
+  }
+  const projection = {};
+  for (const key of fields) {
+    if (ALLOWED_EVENT_FIELDS.has(key)) {
+      ;
+      projection[key] = event[key];
+    }
+  }
+  return projection;
+}
 function annotateEventTimezone(event, tz) {
   if (!event.timestamp) return event;
   const ms = new Date(event.timestamp).getTime();
@@ -303585,7 +303622,8 @@ async function histogramEventsV2(api, params, limits, site) {
   const fullQuery = buildEventQuery({
     query: params.query,
     sources: params.sources,
-    tags: params.tags
+    tags: params.tags,
+    transitionType: params.transitionType
   });
   const cap = limits.maxEventsForHistogram;
   const perPage = Math.max(1, Math.min(1e3, cap));
@@ -304185,7 +304223,8 @@ histogram: Bucket events by local hour_of_day / day_of_week / day_of_month in th
       maxEvents,
       transitionType,
       bucket_by,
-      timezone
+      timezone,
+      fields
     }) => {
       try {
         checkReadOnly(action, readOnly);
@@ -304243,9 +304282,11 @@ histogram: Bucket events by local hour_of_day / day_of_week / day_of_month in th
             );
             if (enrich && result.events.length > 0) {
               const enrichedEvents = await enrichWithMonitorMetadata(result.events, monitorsApi);
-              return toolResult({ ...result, events: enrichedEvents });
+              const projected = fields?.length ? enrichedEvents.map((e) => pickEventFields(e, fields)) : enrichedEvents;
+              return toolResult({ ...result, events: projected });
             }
-            return toolResult(result);
+            const projectedEvents = fields?.length ? result.events.map((e) => pickEventFields(e, fields)) : result.events;
+            return toolResult({ ...result, events: projectedEvents });
           }
           case "aggregate":
             return toolResult(
@@ -304354,7 +304395,8 @@ histogram: Bucket events by local hour_of_day / day_of_week / day_of_month in th
                   tags,
                   bucket_by: histogramBucketBy,
                   timezone,
-                  cursor
+                  cursor,
+                  transitionType
                 },
                 limits,
                 site
@@ -306797,10 +306839,11 @@ var InputSchema8 = {
   from: external_exports.string().optional().describe('Start time for history (ISO 8601 or relative like "7d", "1w")'),
   to: external_exports.string().optional().describe("End time for history (ISO 8601 or relative, default: now)")
 };
-function formatSlo(s) {
+function formatSlo(s, site = "datadoghq.com") {
   const primaryThreshold = s.thresholds?.[0];
+  const id = s.id ?? "";
   const summary = {
-    id: s.id ?? "",
+    id,
     name: s.name ?? "",
     description: s.description ?? null,
     type: String(s.type ?? "unknown"),
@@ -306815,7 +306858,8 @@ function formatSlo(s) {
     },
     overallStatus: [],
     createdAt: s.createdAt ? new Date(s.createdAt * 1e3).toISOString() : "",
-    modifiedAt: s.modifiedAt ? new Date(s.modifiedAt * 1e3).toISOString() : ""
+    modifiedAt: s.modifiedAt ? new Date(s.modifiedAt * 1e3).toISOString() : "",
+    url: id ? buildSloUrl(id, site) : ""
   };
   if (s.query?.numerator && s.query.denominator) {
     summary.query = { numerator: s.query.numerator, denominator: s.query.denominator };
@@ -306831,11 +306875,12 @@ function formatSlo(s) {
   }
   return summary;
 }
-function formatSearchSlo(slo) {
+function formatSearchSlo(slo, site = "datadoghq.com") {
   const attrs = slo.data?.attributes;
   const primaryThreshold = attrs?.thresholds?.[0];
+  const id = slo.data?.id ?? "";
   const summary = {
-    id: slo.data?.id ?? "",
+    id,
     name: attrs?.name ?? "",
     description: attrs?.description ?? null,
     type: String(attrs?.sloType ?? "unknown"),
@@ -306856,7 +306901,8 @@ function formatSearchSlo(slo) {
       timeframe: String(os.timeframe ?? "")
     })),
     createdAt: attrs?.createdAt ? new Date(attrs.createdAt * 1e3).toISOString() : "",
-    modifiedAt: attrs?.modifiedAt ? new Date(attrs.modifiedAt * 1e3).toISOString() : ""
+    modifiedAt: attrs?.modifiedAt ? new Date(attrs.modifiedAt * 1e3).toISOString() : "",
+    url: id ? buildSloUrl(id, site) : ""
   };
   if (attrs?.query?.numerator && attrs.query.denominator) {
     summary.query = { numerator: attrs.query.numerator, denominator: attrs.query.denominator };
@@ -306875,14 +306921,14 @@ function buildSearchQuery(query, tags) {
   if (tags?.length) parts.push(...tags);
   return parts.join(" ");
 }
-async function listSlos(api, params, limits) {
+async function listSlos(api, params, limits, site = "datadoghq.com") {
   const effectiveLimit = params.limit ?? limits.defaultLimit;
   if (params.ids?.length) {
     const response2 = await api.listSLOs({
       ids: params.ids.join(","),
       limit: effectiveLimit
     });
-    const slos3 = (response2.data ?? []).map(formatSlo);
+    const slos3 = (response2.data ?? []).map((s) => formatSlo(s, site));
     return { slos: slos3, total: slos3.length };
   }
   const searchQuery = buildSearchQuery(params.query, params.tags);
@@ -306891,16 +306937,16 @@ async function listSlos(api, params, limits) {
     pageSize: effectiveLimit
   });
   const searchSlos = response.data?.attributes?.slos ?? [];
-  const slos2 = searchSlos.map(formatSearchSlo);
+  const slos2 = searchSlos.map((s) => formatSearchSlo(s, site));
   return {
     slos: slos2,
     total: slos2.length
   };
 }
-async function getSlo(api, id) {
+async function getSlo(api, id, site = "datadoghq.com") {
   const response = await api.getSLO({ sloId: id });
   return {
-    slo: response.data ? formatSlo(response.data) : null
+    slo: response.data ? formatSlo(response.data, site) : null
   };
 }
 function normalizeSloConfig(config2) {
@@ -306916,20 +306962,20 @@ function normalizeSloConfig(config2) {
   }
   return normalized;
 }
-async function createSlo(api, config2) {
+async function createSlo(api, config2, site = "datadoghq.com") {
   const body = normalizeSloConfig(config2);
   const response = await api.createSLO({ body });
   return {
     success: true,
-    slo: response.data?.[0] ? formatSlo(response.data[0]) : null
+    slo: response.data?.[0] ? formatSlo(response.data[0], site) : null
   };
 }
-async function updateSlo(api, id, config2) {
+async function updateSlo(api, id, config2, site = "datadoghq.com") {
   const body = normalizeConfigKeys(config2);
   const response = await api.updateSLO({ sloId: id, body });
   return {
     success: true,
-    slo: response.data?.[0] ? formatSlo(response.data[0]) : null
+    slo: response.data?.[0] ? formatSlo(response.data[0], site) : null
   };
 }
 async function deleteSlo(api, id) {
@@ -306969,29 +307015,29 @@ async function getSloHistory(api, id, params) {
     }
   };
 }
-function registerSlosTool(server, api, limits, readOnly = false, _site = "datadoghq.com") {
+function registerSlosTool(server, api, limits, readOnly = false, site = "datadoghq.com") {
   server.tool(
     "slos",
-    "Manage Datadog Service Level Objectives. Actions: list (with SLI status & error budget), get, create, update, delete, history. SLO types: metric-based, monitor-based. Use for: reliability tracking, error budgets, SLA compliance, performance targets.",
+    "Manage Datadog Service Level Objectives. Actions: list (with SLI status & error budget), get, create, update, delete, history. SLO types: metric-based, monitor-based. Each list/get/create/update response includes a `url` field deep-linking to the Datadog UI. Use for: reliability tracking, error budgets, SLA compliance, performance targets.",
     InputSchema8,
     async ({ action, id, ids, query, tags, limit, config: config2, from, to }) => {
       try {
         checkReadOnly(action, readOnly);
         switch (action) {
           case "list":
-            return toolResult(await listSlos(api, { ids, query, tags, limit }, limits));
+            return toolResult(await listSlos(api, { ids, query, tags, limit }, limits, site));
           case "get": {
             const sloId = requireParam(id, "id", "get");
-            return toolResult(await getSlo(api, sloId));
+            return toolResult(await getSlo(api, sloId, site));
           }
           case "create": {
             const sloConfig = requireParam(config2, "config", "create");
-            return toolResult(await createSlo(api, sloConfig));
+            return toolResult(await createSlo(api, sloConfig, site));
           }
           case "update": {
             const sloId = requireParam(id, "id", "update");
             const sloConfig = requireParam(config2, "config", "update");
-            return toolResult(await updateSlo(api, sloId, sloConfig));
+            return toolResult(await updateSlo(api, sloId, sloConfig, site));
           }
           case "delete": {
             const sloId = requireParam(id, "id", "delete");