Datadog MCP Server

A Model Context Protocol (MCP) server for interacting with the Datadog API.

Features

• Monitoring: Access monitor data and configurations
• Dashboards: Retrieve and view dashboard definitions
• Metrics: Query available metrics and their metadata
• Events: Search and retrieve events within timeframes
• Logs: Search logs with advanced filtering and sorting options
• Incidents: Access incident management data
• API Integration: Direct integration with Datadog's v1 and v2 APIs
• Comprehensive Error Handling: Clear error messages for API and authentication issues
• Service-Specific Endpoints: Support for different endpoints for logs and metrics

Prerequisites

1. Node.js (version 16 or higher)
2. Datadog account with:

• API key
• Application key

Installation# Via npm (recommended)

npm install -g datadog-mcp-server
```\n\n### From Source
1. Clone this repository
2. Install dependencies:
```bash
npm install

3. Build the project:

npm run build

Configuration

You can configure the Datadog MCP server using either environment variables or command-line arguments.\n\n### Environment Variables Create a .env file with your Datadog credentials:

DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com
DD_LOGS_SITE=datadoghq.com
DD_METRICS_SITE=datadoghq.com
```\n\n### Command-line Arguments
Basic usage with global site setting:
```bash
datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu

Usage with Claude Desktop

Add this to your claude_desktop_config.json:

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

Available Tools

The server provides these MCP tools:

• get-monitors: Fetch 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: Fetch events within a time range
• get-incidents: List incidents with optional filtering
• search-logs: Search logs with advanced query filtering
• aggregate-logs: Perform analytics and aggregations on log data

License

MIT