datadog-mcp — Claude Code MCP server: features and setup
Connect an AI agent to Datadog to search logs and inspect metrics, traces, and monitors. Useful when investigating observability data from a chat.
claude mcp add --env DD_API_KEY=<DD_API_KEY> --env DD_APP_KEY=<DD_APP_KEY> --env DD_SITE=<DD_SITE> --transport stdio datadog-mcp -- npx -y datadog-mcpWhat datadog-mcp does
datadog-mcp gives an agent MCP access to Datadog data. It can search logs with grep-like queries, filter APM traces by duration, status, or errors, and correlate logs, traces, and metrics. Sampling modes help control how much data is returned to the agent.
Run it over stdio for a local client or http for remote use, including Kubernetes deployments. The server needs DD_API_KEY and DD_APP_KEY; set DD_SITE to choose a Datadog site. With --read-only, write operations are blocked, so this is the setting to use when the agent should inspect data without changing it.
What it helps with
- search Datadog logs for matching entries
- filter APM traces by duration or error status
- correlate logs with traces and metrics
- find monitors that match a query
Example prompts for the agent
- Search Datadog logs for payment errors and show matching entries.
- Filter APM traces for errors and long durations, then compare them with metrics.
- Find Datadog monitors that match this query.
How to install datadog-mcp
Platform CLI
claude mcp add --env DD_API_KEY=<DD_API_KEY> --env DD_APP_KEY=<DD_APP_KEY> --env DD_SITE=<DD_SITE> --transport stdio datadog-mcp -- npx -y datadog-mcpReplace <…> with your own values
Platform CLI
codex mcp add datadog-mcp --env DD_API_KEY=<DD_API_KEY> --env DD_APP_KEY=<DD_APP_KEY> --env DD_SITE=<DD_SITE> -- npx -y datadog-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"datadog-mcp": {
"command": "npx",
"args": [
"-y",
"datadog-mcp"
],
"env": {
"DD_API_KEY": "<DD_API_KEY>",
"DD_APP_KEY": "<DD_APP_KEY>",
"DD_SITE": "<DD_SITE>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"datadog-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"datadog-mcp"
],
"env": {
"DD_API_KEY": "<DD_API_KEY>",
"DD_APP_KEY": "<DD_APP_KEY>",
"DD_SITE": "<DD_SITE>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e DD_API_KEY=<DD_API_KEY> -e DD_APP_KEY=<DD_APP_KEY> -e DD_SITE=<DD_SITE> datadog-mcp npx -y datadog-mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about datadog-mcp
How do I install datadog-mcp in Claude Code?
Run claude mcp add datadog-mcp -e DD_API_KEY=<DD_API_KEY> -e DD_APP_KEY=<DD_APP_KEY> -- npx -y datadog-mcp. Replace the placeholders with your Datadog keys.
What does datadog-mcp do?
It connects an agent to Datadog data for log searches, APM trace filtering, and comparisons across logs, traces, and metrics.
Which credentials does datadog-mcp need?
Set DD_API_KEY and DD_APP_KEY. You can also provide DD_SITE to select the Datadog site.
