home / mcp / datadog mcp server

Datadog MCP Server

Provides MCP access to Datadog monitors, dashboards, metrics, events, logs, and incidents via Datadog APIs.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "datadog-official-datadog-mcp": {
      "command": "datadog-mcp-server",
      "args": [
        "--apiKey=YOUR_API_KEY",
        "--appKey=YOUR_APP_KEY",
        "--site=YOUR_DD_SITE"
      ],
      "env": {
        "DD_SITE": "datadoghq.com",
        "DD_API_KEY": "YOUR_API_KEY",
        "DD_APP_KEY": "YOUR_APP_KEY"
      }
    }
  }
}

You can run a Datadog MCP Server to securely fetch monitors, dashboards, metrics, events, logs, and incidents from Datadog using a standardized MCP interface. This server lets you query data from Datadog’s v1 and v2 APIs through simple MCP tools, giving you a consistent way to integrate Datadog data into your workflows and applications.

How to use

You interact with the Datadog MCP Server through an MCP client. Start the server with your Datadog credentials, then use the available MCP tools to retrieve data such as monitors, dashboards, metrics, events, and logs. Use the data in dashboards, automation, or integrations by calling the corresponding MCP tool endpoints (for example, to fetch all dashboards or to search logs within a time range). The server handles authentication and API communication, returning structured results and clear error messages when something goes wrong.

How to install

Prerequisites you need before installing:

- Node.js version 16 or higher

- A Datadog account with an API key and an Application key

Step-by-step installation

npm install -g datadog-mcp-server

From source

If you prefer to build from source, follow these steps to install dependencies and build the project.

git clone https://example.com/datadog-mcp-server.git
cd datadog-mcp-server
npm install
npm run build

Run the server via command line

datadog-mcp-server --apiKey=your_api_key --appKey=your_app_key --site=datadoghq.eu

Usage with environment variables

# Create a .env file with your credentials
DD_API_KEY=your_api_key_here
DD_APP_KEY=your_app_key_here
DD_SITE=datadoghq.com

Usage with Claude Desktop

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

Usage with Cursor

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

Available tools

get-monitors

Fetch monitors with optional filtering to see current configurations and statuses.

get-monitor

Retrieve details for a specific monitor by its ID.

get-dashboards

List all dashboards available in your Datadog account.

get-dashboard

Get a specific dashboard by its ID.

get-metrics

List available metrics to understand what data you can query.

get-metric-metadata

Fetch metadata for a particular metric to understand units and semantics.

get-events

Fetch events within a specified time range.

get-incidents

List incidents with optional filtering for status or timeframe.

search-logs

Search logs with advanced query filters to refine results.

aggregate-logs

Run analytics on log data to produce aggregates.