A Model Context Protocol server that provides access to Datadog monitoring capabilities, including dashboards, metrics, logs, events, incidents, and monitors through direct API integration.

Installation

NPM Global

npm install -g datadog-mcp-server

From Source Code

# Clone this repository
npm install
npm run build

Configuration

Claude Desktop Basic Setup

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_DD_SITE>(e.g us5.datadoghq.com)"
      ]
    }
  }
}

Claude Desktop Advanced Setup

{
  "mcpServers": {
    "datadog": {
      "command": "npx",
      "args": [
        "datadog-mcp-server",
        "--apiKey",
        "<YOUR_API_KEY>",
        "--appKey",
        "<YOUR_APP_KEY>",
        "--site",
        "<YOUR_DD_SITE>",
        "--logsSite",
        "<YOUR_LOGS_SITE>",
        "--metricsSite",
        "<YOUR_METRICS_SITE>"
      ]
    }
  }
}

Available Tools

Tool	Description
get-monitors	Retrieve monitors with optional filtering
get-monitor	Get details of a specific monitor by ID
get-dashboards	List all dashboards
get-dashboard	Get a specific dashboard by ID
get-metrics	List available metrics
get-metric-metadata	Get metadata for a specific metric
get-events	Retrieve events within a specified time range
get-incidents	List incidents with optional filtering
search-logs	Search logs with advanced query filtering
aggregate-logs	Perform log data analytics and aggregation

Features

• Access monitor data and configurations
• Retrieve and view dashboard definitions
• Query available metrics and their metadata
• Search and retrieve events within time ranges
• Search logs with advanced filtering and sorting options
• Access incident management data
• Direct integration with Datadog v1 and v2 APIs
• Comprehensive error handling with clear error messages
• Support for service-specific endpoints for logs and metrics

Environment Variables

Required

• DD_API_KEY - Datadog API key from Organization Settings > API Keys
• DD_APP_KEY - Datadog Application key from Organization Settings > Application Keys

Optional

• DD_SITE - Datadog site endpoint (e.g., datadoghq.com, datadoghq.eu)
• DD_LOGS_SITE - Specific endpoint for logs service (optional, defaults to DD_SITE)
• DD_METRICS_SITE - Specific endpoint for metrics service (optional, defaults to DD_SITE)

Usage Examples

Get monitors in alert or warning state

Get the configuration of a specific dashboard by its ID

Find web-app service errors in logs from the last 15 minutes

Get log count aggregation grouped by status for the last hour

List active incidents with pagination

Notes

Requires Node.js version 16 or higher. Supports multiple Datadog regions (US, EU, US3 GovCloud, US5, AP1). Configuration can be performed via environment variables or command-line arguments. Can be used with the MCP Inspector tool for testing.