# Datadog MCP Server

MCP server for Datadog monitoring, observability, and security platform.

## Features

- **Monitor Management**: Create, list, mute, and manage alerts
- **Metrics**: Query timeseries data and list metrics
- **Logs**: Search and analyze log data
- **Dashboards**: List and retrieve dashboard configurations
- **Synthetic Tests**: Create and manage API/browser tests
- **Downtimes**: Schedule maintenance windows
- **Hosts**: List infrastructure and manage host tags
- **SLOs**: Track service level objectives
- **Events**: Create and query events
- **Incidents**: Manage incident responses

## Environment Variables

| Variable | Required | Description | Example |
|----------|----------|-------------|---------|
| `DD_API_KEY` | ✅ | Datadog API key | `abc123...` |
| `DD_APP_KEY` | ✅ | Datadog application key | `xyz789...` |

## Getting Your API Keys

1. Log in to [Datadog](https://app.datadoghq.com/)
2. Go to **Organization Settings** > **API Keys**
3. Create or copy **API Key**
4. Go to **Application Keys** tab
5. Create or copy **Application Key**
6. Set environment variables:
   ```bash
   export DD_API_KEY="your-api-key"
   export DD_APP_KEY="your-app-key"
   ```

## Required API Scopes

Application keys can be scoped to specific permissions:
- **Monitoring**: Monitors, dashboards, metrics, logs
- **Synthetics**: API and browser tests
- **Incident Management**: Incidents and SLOs
- **Infrastructure**: Hosts and tags

## Installation

```bash
npm install
npm run build
```

## Usage

### Stdio Mode
```bash
node dist/main.js
```

### With Claude Desktop
```json
{
  "mcpServers": {
    "datadog": {
      "command": "node",
      "args": ["/path/to/datadog/dist/main.js"],
      "env": {
        "DD_API_KEY": "your-api-key",
        "DD_APP_KEY": "your-app-key"
      }
    }
  }
}
```

## Tools Overview (19+ tools)

### Monitors (4)
- `datadog_list_monitors` - List monitors with filters
- `datadog_get_monitor` - Get monitor by ID
- `datadog_create_monitor` - Create new monitor
- `datadog_mute_monitor` - Mute monitor alerts

### Metrics (2)
- `datadog_list_metrics` - List available metrics
- `datadog_get_metric_timeseries` - Query timeseries data

### Logs (2)
- `datadog_list_logs` - List log entries
- `datadog_search_logs` - Advanced log search

### Synthetics (2)
- `datadog_list_synthetics` - List synthetic tests
- `datadog_create_synthetic` - Create API/browser test

### Downtimes (2)
- `datadog_list_downtimes` - List scheduled downtimes
- `datadog_schedule_downtime` - Schedule maintenance

### Hosts (2)
- `datadog_list_hosts` - List monitored hosts
- `datadog_get_host_tags` - Get host tags

### SLOs (1)
- `datadog_list_service_level_objectives` - List SLOs

### Dashboards (2)
- `datadog_list_dashboards` - List dashboards
- `datadog_get_dashboards` - Get dashboard

### Events (2)
- `datadog_list_events` - List events
- `datadog_get_event` - Get event

### Incidents (2)
- `datadog_list_incidents` - List incidents
- `datadog_get_incidents` - Get incident

## Coverage Manifest

**Total Datadog API endpoints**: ~300  
**Tools implemented**: 21  
**Intentionally skipped**: 279 (APM traces, security monitoring, RUM, integrations)  
**Coverage**: 21/300 = 7%

### Skipped Endpoints
- APM/Tracing (complex distributed tracing)
- Security Monitoring & SIEM
- Real User Monitoring (RUM)
- Network Performance Monitoring
- Cloud Cost Management
- Integration configurations
- User management & RBAC

## License

MIT