datadog mcp

Instructions

Implementation Reference

• src/tools/getMonitor.ts:27-43 (handler)

  The core handler function that performs the API call to retrieve details of a specific Datadog monitor by its ID using the Datadog API client.

  execute: async (params: GetMonitorParams) => {
    try {
      const { monitorId } = params;
  
      const apiInstance = new v1.MonitorsApi(configuration);
  
      const apiParams: v1.MonitorsApiGetMonitorRequest = {
        monitorId: monitorId
      };
  
      const response = await apiInstance.getMonitor(apiParams);
      return response;
    } catch (error) {
      console.error(`Error fetching monitor ${params.monitorId}:`, error);
      throw error;
    }
  }

• src/index.ts:105-117 (registration)

  Registers the 'get-monitor' tool with the MCP server, defining its name, description, input schema, and handler that delegates to getMonitor.execute.

  server.tool(
    "get-monitor",
    "Get detailed information about a specific Datadog monitor by its ID. Use this to retrieve the complete configuration, status, and other details of a single monitor.",
    {
      monitorId: z.number()
    },
    async (args) => {
      const result = await getMonitor.execute(args);
      return {
        content: [{ type: "text", text: JSON.stringify(result) }]
      };
    }
  );

• src/index.ts:108-110 (schema)

  Zod input schema for the 'get-monitor' tool, validating the monitorId parameter as a number.

  {
    monitorId: z.number()
  },

• src/tools/getMonitor.ts:3-5 (schema)

  TypeScript type definition for the input parameters of the getMonitor tool.

  type GetMonitorParams = {
    monitorId: number;
  };

• src/tools/getMonitor.ts:10-25 (helper)

  Initialization function that sets up the Datadog API client configuration with API keys and site variables.

  initialize: () => {
    const configOpts = {
      authMethods: {
        apiKeyAuth: process.env.DD_API_KEY,
        appKeyAuth: process.env.DD_APP_KEY
      }
    };
  
    configuration = client.createConfiguration(configOpts);
  
    if (process.env.DD_METRICS_SITE) {
      configuration.setServerVariables({
        site: process.env.DD_METRICS_SITE
      });
    }
  },