138 lines
3.4 KiB
Markdown
138 lines
3.4 KiB
Markdown
# 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
|