@vineethnkrishnan/datadog-mcp 0.1.1

package/build/common/types.d.ts

@@ -0,0 +1,12 @@
+export interface DatadogConfig {
+    apiKey: string;
+    appKey: string;
+    site: string;
+}
+export interface McpToolResponse {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}

package/build/common/types.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=types.js.map

package/build/common/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/common/types.ts"],"names":[],"mappings":""}

package/build/common/utils.d.ts

@@ -0,0 +1,26 @@
+import { McpToolResponse } from "./types";
+/**
+ * Recursively removes specified keys from an object.
+ */
+export declare function stripDatadogMetadata(obj: unknown, keys?: string[]): unknown;
+/**
+ * Simplifies dashboard widgets by removing complex visual definitions
+ * and keeping only title, type, and query information.
+ */
+export declare function stripDashboardWidgets(dashboard: unknown): unknown;
+/**
+ * Truncates metric series data points to MAX_DATAPOINTS and adds summary stats.
+ */
+export declare function truncateMetricSeries(data: unknown): unknown;
+/**
+ * Composes all Datadog-specific transformations for LLM optimization.
+ */
+export declare function transformDatadogResponse(data: unknown, resourceType?: string): unknown;
+/**
+ * Transforms Datadog data and wraps it in the MCP tool response format.
+ */
+export declare function formatMcpResponse(data: unknown, resourceType?: string): McpToolResponse;
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+export declare function formatMcpError(error: unknown): McpToolResponse;

package/build/common/utils.js

@@ -0,0 +1,175 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stripDatadogMetadata = stripDatadogMetadata;
+exports.stripDashboardWidgets = stripDashboardWidgets;
+exports.truncateMetricSeries = truncateMetricSeries;
+exports.transformDatadogResponse = transformDatadogResponse;
+exports.formatMcpResponse = formatMcpResponse;
+exports.formatMcpError = formatMcpError;
+const DATADOG_STRIP_KEYS = [
+    "creator",
+    "matching_downtimes",
+    "restricted_roles",
+    "org_id",
+    "deleted",
+    "modified",
+];
+const DASHBOARD_WIDGET_STRIP_KEYS = [
+    "style",
+    "yaxis",
+    "markers",
+    "events",
+    "layout",
+    "conditional_formats",
+    "autoscale",
+    "custom_unit",
+    "precision",
+    "text_align",
+    "legend_size",
+    "show_legend",
+    "legend_layout",
+    "legend_columns",
+    "right_yaxis",
+    "has_search_bar",
+];
+const MAX_DATAPOINTS = 50;
+/**
+ * Recursively removes specified keys from an object.
+ */
+function stripDatadogMetadata(obj, keys = DATADOG_STRIP_KEYS) {
+    if (obj === null || obj === undefined)
+        return obj;
+    if (Array.isArray(obj))
+        return obj.map((item) => stripDatadogMetadata(item, keys));
+    if (typeof obj !== "object")
+        return obj;
+    const result = {};
+    for (const [key, value] of Object.entries(obj)) {
+        if (keys.includes(key))
+            continue;
+        result[key] = stripDatadogMetadata(value, keys);
+    }
+    return result;
+}
+/**
+ * Simplifies dashboard widgets by removing complex visual definitions
+ * and keeping only title, type, and query information.
+ */
+function stripDashboardWidgets(dashboard) {
+    if (dashboard === null || dashboard === undefined || typeof dashboard !== "object") {
+        return dashboard;
+    }
+    const record = dashboard;
+    if (!record.widgets || !Array.isArray(record.widgets))
+        return dashboard;
+    const simplifiedWidgets = record.widgets.map(simplifyWidget);
+    return {
+        ...record,
+        widgets: simplifiedWidgets,
+        _widgetCount: simplifiedWidgets.length,
+    };
+}
+function simplifyWidget(widget) {
+    if (widget === null || widget === undefined || typeof widget !== "object")
+        return widget;
+    const w = widget;
+    const definition = w.definition;
+    if (!definition)
+        return { id: w.id };
+    const simplified = {
+        id: w.id,
+        type: definition.type,
+    };
+    if (definition.title)
+        simplified.title = definition.title;
+    // Extract queries from requests
+    if (definition.requests && Array.isArray(definition.requests)) {
+        simplified.queries = definition.requests
+            .map((req) => req.q ?? req.query)
+            .filter(Boolean);
+    }
+    // Recurse into group widgets
+    if (definition.widgets && Array.isArray(definition.widgets)) {
+        simplified.widgets = definition.widgets.map(simplifyWidget);
+    }
+    // Strip visual-only keys from remaining definition
+    for (const key of DASHBOARD_WIDGET_STRIP_KEYS) {
+        delete definition[key];
+    }
+    return simplified;
+}
+/**
+ * Truncates metric series data points to MAX_DATAPOINTS and adds summary stats.
+ */
+function truncateMetricSeries(data) {
+    if (data === null || data === undefined || typeof data !== "object")
+        return data;
+    const record = data;
+    if (!record.series || !Array.isArray(record.series))
+        return data;
+    const simplifiedSeries = record.series.map((series) => {
+        if (series === null || series === undefined || typeof series !== "object")
+            return series;
+        const s = series;
+        const pointlist = s.pointlist;
+        if (!pointlist || !Array.isArray(pointlist) || pointlist.length === 0)
+            return series;
+        const values = pointlist.map((point) => point[1]).filter((v) => v !== null && v !== undefined);
+        const summary = {
+            min: values.length > 0 ? Math.min(...values) : null,
+            max: values.length > 0 ? Math.max(...values) : null,
+            avg: values.length > 0 ? values.reduce((a, b) => a + b, 0) / values.length : null,
+            count: pointlist.length,
+            start: pointlist[0]?.[0] ?? null,
+            end: pointlist[pointlist.length - 1]?.[0] ?? null,
+        };
+        if (pointlist.length <= MAX_DATAPOINTS) {
+            return { ...s, _summary: summary };
+        }
+        // Downsample by picking evenly spaced points
+        const step = (pointlist.length - 1) / (MAX_DATAPOINTS - 1);
+        const downsampled = [];
+        for (let i = 0; i < MAX_DATAPOINTS; i++) {
+            const index = Math.round(i * step);
+            downsampled.push(pointlist[index]);
+        }
+        return {
+            ...s,
+            pointlist: downsampled,
+            _summary: summary,
+            _truncated: { kept: MAX_DATAPOINTS, total: pointlist.length },
+        };
+    });
+    return { ...record, series: simplifiedSeries };
+}
+/**
+ * Composes all Datadog-specific transformations for LLM optimization.
+ */
+function transformDatadogResponse(data, resourceType) {
+    let result = stripDatadogMetadata(data);
+    if (resourceType === "dashboard")
+        result = stripDashboardWidgets(result);
+    if (resourceType === "metrics")
+        result = truncateMetricSeries(result);
+    return result;
+}
+/**
+ * Transforms Datadog data and wraps it in the MCP tool response format.
+ */
+function formatMcpResponse(data, resourceType) {
+    const transformed = transformDatadogResponse(data, resourceType);
+    return {
+        content: [{ type: "text", text: JSON.stringify(transformed, null, 2) }],
+    };
+}
+/**
+ * Wraps an error in the MCP tool error response format.
+ */
+function formatMcpError(error) {
+    const message = error instanceof Error ? error.message : String(error);
+    return {
+        content: [{ type: "text", text: `Error: ${message}` }],
+        isError: true,
+    };
+}
+//# sourceMappingURL=utils.js.map

package/build/common/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/common/utils.ts"],"names":[],"mappings":"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"}

package/build/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/build/index.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const index_js_1 = require("@modelcontextprotocol/sdk/server/index.js");
+const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
+const types_js_1 = require("@modelcontextprotocol/sdk/types.js");
+const zod_1 = require("zod");
+const datadog_service_1 = require("./services/datadog.service");
+const monitor_tools_1 = require("./tools/monitor.tools");
+const metric_tools_1 = require("./tools/metric.tools");
+const event_tools_1 = require("./tools/event.tools");
+// Validate required config
+const DD_API_KEY = process.env.DD_API_KEY;
+const DD_APP_KEY = process.env.DD_APP_KEY;
+const DD_SITE = process.env.DD_SITE ?? "datadoghq.com";
+if (!DD_API_KEY) {
+    console.error("DD_API_KEY environment variable is required.");
+    process.exit(1);
+}
+if (!DD_APP_KEY) {
+    console.error("DD_APP_KEY environment variable is required.");
+    process.exit(1);
+}
+// Warn on unknown site values
+const KNOWN_SITES = [
+    "datadoghq.com",
+    "datadoghq.eu",
+    "us3.datadoghq.com",
+    "us5.datadoghq.com",
+    "ap1.datadoghq.com",
+    "ddog-gov.com",
+];
+if (!KNOWN_SITES.includes(DD_SITE)) {
+    console.error(`Warning: DD_SITE="${DD_SITE}" is not a recognized Datadog site. Known sites: ${KNOWN_SITES.join(", ")}. Proceeding anyway.`);
+}
+const datadogService = new datadog_service_1.DatadogService({
+    apiKey: DD_API_KEY,
+    appKey: DD_APP_KEY,
+    site: DD_SITE,
+});
+// Initialize tool classes
+const tools = {
+    monitors: new monitor_tools_1.MonitorTools(datadogService),
+    metrics: new metric_tools_1.MetricTools(datadogService),
+    events: new event_tools_1.EventTools(datadogService),
+};
+// Combine all schemas
+const AllToolSchemas = {
+    ...monitor_tools_1.MonitorToolSchemas,
+    ...metric_tools_1.MetricToolSchemas,
+    ...event_tools_1.EventToolSchemas,
+};
+// eslint-disable-next-line @typescript-eslint/no-require-imports
+const { version } = require("../package.json");
+const server = new index_js_1.Server({
+    name: "datadog-mcp",
+    version,
+}, {
+    capabilities: {
+        tools: {},
+    },
+});
+/**
+ * Handler for listing available tools.
+ */
+server.setRequestHandler(types_js_1.ListToolsRequestSchema, async () => {
+    return {
+        tools: Object.entries(AllToolSchemas).map(([name, config]) => ({
+            name,
+            description: config.description,
+            inputSchema: zod_1.z.toJSONSchema(config.schema),
+        })),
+    };
+});
+const toolRegistry = {};
+for (const name of Object.keys(monitor_tools_1.MonitorToolSchemas)) {
+    toolRegistry[name] = (args) => tools.monitors[name](args);
+}
+for (const name of Object.keys(metric_tools_1.MetricToolSchemas)) {
+    toolRegistry[name] = (args) => tools.metrics[name](args);
+}
+for (const name of Object.keys(event_tools_1.EventToolSchemas)) {
+    toolRegistry[name] = (args) => tools.events[name](args);
+}
+server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
+    try {
+        const { name, arguments: args } = request.params;
+        const handler = toolRegistry[name];
+        if (!handler) {
+            throw new types_js_1.McpError(types_js_1.ErrorCode.MethodNotFound, `Tool not found: ${name}`);
+        }
+        return await handler(args ?? {});
+    }
+    catch (error) {
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: "text", text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+});
+/**
+ * Start the server using Stdio transport.
+ */
+async function main() {
+    const transport = new stdio_js_1.StdioServerTransport();
+    await server.connect(transport);
+    console.error("Datadog MCP Server running on stdio");
+}
+main().catch((error) => {
+    console.error("Server error:", error);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/build/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/build/services/datadog.service.d.ts

@@ -0,0 +1,14 @@
+import { DatadogConfig } from "../common/types";
+export declare class DatadogService {
+    private baseUrl;
+    private apiKey;
+    private appKey;
+    constructor(config: DatadogConfig);
+    private request;
+    listMonitors(query?: string, limit?: number): Promise<unknown[]>;
+    getMonitor(monitorId: number): Promise<unknown>;
+    searchMonitors(query: string, limit?: number): Promise<unknown>;
+    queryMetrics(query: string, from: number, to: number): Promise<unknown>;
+    listEvents(start: number, end: number, limit?: number): Promise<unknown>;
+    getEvent(eventId: number): Promise<unknown>;
+}

package/build/services/datadog.service.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DatadogService = void 0;
+class DatadogService {
+    baseUrl;
+    apiKey;
+    appKey;
+    constructor(config) {
+        // Construct site-aware base URL: https://api.${DD_SITE}
+        const site = config.site.replace(/\/+$/, "");
+        this.baseUrl = `https://api.${site}`;
+        this.apiKey = config.apiKey;
+        this.appKey = config.appKey;
+    }
+    async request(version, path, params) {
+        const url = new URL(`${this.baseUrl}/api/${version}${path}`);
+        if (params) {
+            for (const [key, value] of Object.entries(params)) {
+                if (value !== undefined && value !== null && value !== "") {
+                    url.searchParams.set(key, String(value));
+                }
+            }
+        }
+        const response = await fetch(url.toString(), {
+            headers: {
+                "DD-API-KEY": this.apiKey,
+                "DD-APPLICATION-KEY": this.appKey,
+                "Content-Type": "application/json",
+            },
+        });
+        if (!response.ok) {
+            const errorBody = await response.text().catch(() => "");
+            switch (response.status) {
+                case 401:
+                    throw new Error("Authentication failed. Check your DD_API_KEY. If using a non-US1 site, ensure DD_SITE matches where your keys were created.");
+                case 403:
+                    throw new Error("Access denied. Check your DD_APP_KEY permissions. Ensure the application key has read access to the requested resource.");
+                case 404:
+                    throw new Error("Not found. Check the ID and ensure the resource exists in your DD_SITE region.");
+                case 429: {
+                    const resetHeader = response.headers.get("X-RateLimit-Reset") ?? "unknown";
+                    throw new Error(`Rate limited by Datadog. Retry after ${resetHeader} seconds.`);
+                }
+                default:
+                    throw new Error(`Datadog API error (${response.status}): ${errorBody || response.statusText}`);
+            }
+        }
+        return response.json();
+    }
+    // ===========================================================================
+    // Monitors
+    // ===========================================================================
+    async listMonitors(query, limit = 25) {
+        const params = { page_size: limit };
+        if (query)
+            params.query = query;
+        return this.request("v1", "/monitor", params);
+    }
+    async getMonitor(monitorId) {
+        return this.request("v1", `/monitor/${monitorId}`);
+    }
+    async searchMonitors(query, limit = 25) {
+        return this.request("v1", "/monitor/search", {
+            query,
+            per_page: limit,
+        });
+    }
+    // ===========================================================================
+    // Metrics
+    // ===========================================================================
+    async queryMetrics(query, from, to) {
+        return this.request("v1", "/query", {
+            query,
+            from,
+            to,
+        });
+    }
+    // ===========================================================================
+    // Events
+    // ===========================================================================
+    async listEvents(start, end, limit = 25) {
+        return this.request("v2", "/events", {
+            "filter[from]": start,
+            "filter[to]": end,
+            "page[limit]": limit,
+        });
+    }
+    async getEvent(eventId) {
+        return this.request("v2", `/events/${eventId}`);
+    }
+}
+exports.DatadogService = DatadogService;
+//# sourceMappingURL=datadog.service.js.map

package/build/services/datadog.service.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"datadog.service.js","sourceRoot":"","sources":["../../src/services/datadog.service.ts"],"names":[],"mappings":"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"}

package/build/tools/event.tools.d.ts

@@ -0,0 +1,24 @@
+import { z } from "zod";
+import { DatadogService } from "../services/datadog.service";
+export declare const EventToolSchemas: {
+    list_events: {
+        description: string;
+        schema: z.ZodObject<{
+            start: z.ZodNumber;
+            end: z.ZodNumber;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+    get_event: {
+        description: string;
+        schema: z.ZodObject<{
+            event_id: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+};
+export declare class EventTools {
+    private datadogService;
+    constructor(datadogService: DatadogService);
+    list_events(args: z.infer<typeof EventToolSchemas.list_events.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_event(args: z.infer<typeof EventToolSchemas.get_event.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/event.tools.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.EventTools = exports.EventToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.EventToolSchemas = {
+    list_events: {
+        description: "Lists Datadog events within a time range. Events include deployments, alerts, comments, and other activity. Use UNIX epoch seconds for start and end.",
+        schema: zod_1.z.object({
+            start: zod_1.z.number().describe("Start time as UNIX epoch seconds."),
+            end: zod_1.z.number().describe("End time as UNIX epoch seconds."),
+            limit: zod_1.z
+                .number()
+                .optional()
+                .default(25)
+                .describe("Maximum number of events to return (default 25, max 100)."),
+        }),
+    },
+    get_event: {
+        description: "Retrieves a specific Datadog event including title, text, tags, and related resources.",
+        schema: zod_1.z.object({
+            event_id: zod_1.z.number().describe("The Datadog event ID."),
+        }),
+    },
+};
+class EventTools {
+    datadogService;
+    constructor(datadogService) {
+        this.datadogService = datadogService;
+    }
+    async list_events(args) {
+        const events = await this.datadogService.listEvents(args.start, args.end, args.limit);
+        return (0, utils_1.formatMcpResponse)(events);
+    }
+    async get_event(args) {
+        const event = await this.datadogService.getEvent(args.event_id);
+        return (0, utils_1.formatMcpResponse)(event);
+    }
+}
+exports.EventTools = EventTools;
+//# sourceMappingURL=event.tools.js.map

package/build/tools/event.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"event.tools.js","sourceRoot":"","sources":["../../src/tools/event.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,gBAAgB,GAAG;IAC9B,WAAW,EAAE;QACX,WAAW,EACT,uJAAuJ;QACzJ,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC/D,GAAG,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;YAC3D,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,2DAA2D,CAAC;SACzE,CAAC;KACH;IACD,SAAS,EAAE;QACT,WAAW,EACT,wFAAwF;QAC1F,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,QAAQ,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,uBAAuB,CAAC;SACvD,CAAC;KACH;CACF,CAAC;AAEF,MAAa,UAAU;IACD;IAApB,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,WAAW,CAAC,IAAyD;QACzE,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QACtF,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;IAED,KAAK,CAAC,SAAS,CAAC,IAAuD;QACrE,MAAM,KAAK,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAChE,OAAO,IAAA,yBAAiB,EAAC,KAAK,CAAC,CAAC;IAClC,CAAC;CACF;AAZD,gCAYC"}

package/build/tools/metric.tools.d.ts

@@ -0,0 +1,17 @@
+import { z } from "zod";
+import { DatadogService } from "../services/datadog.service";
+export declare const MetricToolSchemas: {
+    query_metrics: {
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodString;
+            from: z.ZodNumber;
+            to: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+};
+export declare class MetricTools {
+    private datadogService;
+    constructor(datadogService: DatadogService);
+    query_metrics(args: z.infer<typeof MetricToolSchemas.query_metrics.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/metric.tools.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetricTools = exports.MetricToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.MetricToolSchemas = {
+    query_metrics: {
+        description: "Queries timeseries metric data from Datadog using the metric query syntax. Returns data points and summary statistics. Example queries: 'avg:system.cpu.user{host:web-01}', 'sum:trace.servlet.request.hits{service:web-app}.as_count()'.",
+        schema: zod_1.z.object({
+            query: zod_1.z
+                .string()
+                .describe("Datadog metric query string (e.g., 'avg:system.cpu.user{host:web-01}')."),
+            from: zod_1.z.number().describe("Start time as UNIX epoch seconds."),
+            to: zod_1.z.number().describe("End time as UNIX epoch seconds."),
+        }),
+    },
+};
+class MetricTools {
+    datadogService;
+    constructor(datadogService) {
+        this.datadogService = datadogService;
+    }
+    async query_metrics(args) {
+        const metrics = await this.datadogService.queryMetrics(args.query, args.from, args.to);
+        return (0, utils_1.formatMcpResponse)(metrics, "metrics");
+    }
+}
+exports.MetricTools = MetricTools;
+//# sourceMappingURL=metric.tools.js.map

package/build/tools/metric.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"metric.tools.js","sourceRoot":"","sources":["../../src/tools/metric.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,iBAAiB,GAAG;IAC/B,aAAa,EAAE;QACb,WAAW,EACT,2OAA2O;QAC7O,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CAAC,yEAAyE,CAAC;YACtF,IAAI,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;YAC9D,EAAE,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;SAC3D,CAAC;KACH;CACF,CAAC;AAEF,MAAa,WAAW;IACF;IAApB,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,aAAa,CAAC,IAA4D;QAC9E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC,EAAE,CAAC,CAAC;QACvF,OAAO,IAAA,yBAAiB,EAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/C,CAAC;CACF;AAPD,kCAOC"}

package/build/tools/monitor.tools.d.ts

@@ -0,0 +1,31 @@
+import { z } from "zod";
+import { DatadogService } from "../services/datadog.service";
+export declare const MonitorToolSchemas: {
+    list_monitors: {
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodOptional<z.ZodString>;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+    get_monitor: {
+        description: string;
+        schema: z.ZodObject<{
+            monitor_id: z.ZodNumber;
+        }, z.core.$strip>;
+    };
+    search_monitors: {
+        description: string;
+        schema: z.ZodObject<{
+            query: z.ZodString;
+            limit: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+        }, z.core.$strip>;
+    };
+};
+export declare class MonitorTools {
+    private datadogService;
+    constructor(datadogService: DatadogService);
+    list_monitors(args: z.infer<typeof MonitorToolSchemas.list_monitors.schema>): Promise<import("../common/types").McpToolResponse>;
+    get_monitor(args: z.infer<typeof MonitorToolSchemas.get_monitor.schema>): Promise<import("../common/types").McpToolResponse>;
+    search_monitors(args: z.infer<typeof MonitorToolSchemas.search_monitors.schema>): Promise<import("../common/types").McpToolResponse>;
+}

package/build/tools/monitor.tools.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MonitorTools = exports.MonitorToolSchemas = void 0;
+const zod_1 = require("zod");
+const utils_1 = require("../common/utils");
+exports.MonitorToolSchemas = {
+    list_monitors: {
+        description: "Lists Datadog monitors. Optionally filter by query string (e.g., 'type:metric status:alert tag:service:web'). Returns monitor name, status, query, tags, and thresholds.",
+        schema: zod_1.z.object({
+            query: zod_1.z
+                .string()
+                .optional()
+                .describe("Filter query using Datadog monitor search syntax (e.g., 'status:alert', 'tag:env:prod')."),
+            limit: zod_1.z
+                .number()
+                .optional()
+                .default(25)
+                .describe("Maximum number of monitors to return (default 25, max 100)."),
+        }),
+    },
+    get_monitor: {
+        description: "Retrieves full details for a specific Datadog monitor including status, query, thresholds, tags, and notification targets.",
+        schema: zod_1.z.object({
+            monitor_id: zod_1.z.number().describe("The Datadog monitor ID."),
+        }),
+    },
+    search_monitors: {
+        description: "Searches Datadog monitors using monitor search syntax. Returns matching monitors with metadata. Example queries: 'type:metric status:alert', 'tag:service:web', 'notification:@pagerduty'.",
+        schema: zod_1.z.object({
+            query: zod_1.z
+                .string()
+                .describe("Datadog monitor search query (e.g., 'type:metric status:alert tag:service:web')."),
+            limit: zod_1.z
+                .number()
+                .optional()
+                .default(25)
+                .describe("Maximum number of results to return (default 25, max 100)."),
+        }),
+    },
+};
+class MonitorTools {
+    datadogService;
+    constructor(datadogService) {
+        this.datadogService = datadogService;
+    }
+    async list_monitors(args) {
+        const monitors = await this.datadogService.listMonitors(args.query, args.limit);
+        return (0, utils_1.formatMcpResponse)(monitors);
+    }
+    async get_monitor(args) {
+        const monitor = await this.datadogService.getMonitor(args.monitor_id);
+        return (0, utils_1.formatMcpResponse)(monitor);
+    }
+    async search_monitors(args) {
+        const result = await this.datadogService.searchMonitors(args.query, args.limit);
+        return (0, utils_1.formatMcpResponse)(result);
+    }
+}
+exports.MonitorTools = MonitorTools;
+//# sourceMappingURL=monitor.tools.js.map

package/build/tools/monitor.tools.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"monitor.tools.js","sourceRoot":"","sources":["../../src/tools/monitor.tools.ts"],"names":[],"mappings":";;;AAAA,6BAAwB;AAExB,2CAAoD;AAEvC,QAAA,kBAAkB,GAAG;IAChC,aAAa,EAAE;QACb,WAAW,EACT,0KAA0K;QAC5K,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,QAAQ,CACP,0FAA0F,CAC3F;YACH,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,6DAA6D,CAAC;SAC3E,CAAC;KACH;IACD,WAAW,EAAE;QACX,WAAW,EACT,4HAA4H;QAC9H,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,UAAU,EAAE,OAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,yBAAyB,CAAC;SAC3D,CAAC;KACH;IACD,eAAe,EAAE;QACf,WAAW,EACT,4LAA4L;QAC9L,MAAM,EAAE,OAAC,CAAC,MAAM,CAAC;YACf,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,CACP,kFAAkF,CACnF;YACH,KAAK,EAAE,OAAC;iBACL,MAAM,EAAE;iBACR,QAAQ,EAAE;iBACV,OAAO,CAAC,EAAE,CAAC;iBACX,QAAQ,CAAC,4DAA4D,CAAC;SAC1E,CAAC;KACH;CACF,CAAC;AAEF,MAAa,YAAY;IACH;IAApB,YAAoB,cAA8B;QAA9B,mBAAc,GAAd,cAAc,CAAgB;IAAG,CAAC;IAEtD,KAAK,CAAC,aAAa,CAAC,IAA6D;QAC/E,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,YAAY,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAChF,OAAO,IAAA,yBAAiB,EAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED,KAAK,CAAC,WAAW,CAAC,IAA2D;QAC3E,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;QACtE,OAAO,IAAA,yBAAiB,EAAC,OAAO,CAAC,CAAC;IACpC,CAAC;IAED,KAAK,CAAC,eAAe,CAAC,IAA+D;QACnF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,cAAc,CAAC,IAAI,CAAC,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC;QAChF,OAAO,IAAA,yBAAiB,EAAC,MAAM,CAAC,CAAC;IACnC,CAAC;CACF;AAjBD,oCAiBC"}

package/package.json

@@ -0,0 +1,47 @@
+{
+  "name": "@vineethnkrishnan/datadog-mcp",
+  "version": "0.1.1",
+  "description": "A read-only MCP server for Datadog API, enabling AI assistants to query monitors, metrics, and events. Supports all Datadog regions.",
+  "main": "build/index.js",
+  "bin": {
+    "datadog-mcp": "build/index.js"
+  },
+  "files": [
+    "build/"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node build/index.js",
+    "test": "jest --coverage"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "keywords": [
+    "mcp",
+    "datadog",
+    "ai",
+    "model-context-protocol",
+    "monitoring",
+    "observability",
+    "metrics",
+    "multi-site"
+  ],
+  "author": "Vineeth Krishnan",
+  "license": "MIT",
+  "type": "commonjs",
+  "engines": {
+    "node": ">=20"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "jest": "^30.3.0",
+    "ts-jest": "^29.4.6",
+    "typescript": "^5.7.0"
+  }
+}