Datadog MCP server

OfficialDatadogConfig last verified Jun 1, 2026

Datadog's official remote MCP server lets agents search logs, query metrics, pull APM traces, inspect monitors, and investigate incidents.

The Datadog MCP Server is the official remote server from Datadog that connects an AI agent to your observability data so it can investigate problems the way an on-call engineer would. The default core toolset covers the signals you reach for first: searching and analyzing logs, querying metrics and their metadata, pulling full APM traces and spans, listing hosts and services with their dependencies, searching RUM events, browsing dashboards and notebooks, and reading and triaging monitors and incidents. Beyond core, the server is organized into opt-in toolsets you enable with a toolsets query parameter, spanning alerting and SLOs, APM and Watchdog, dashboards and widgets, database monitoring, DDSQL, error tracking, feature flags, Kubernetes, networks, cases, security signals and findings, software delivery and CI, synthetics, workflows, and guided onboarding.

The canonical deployment is the hosted remote endpoint, which for the US1 site is https://mcp.datadoghq.com/api/unstable/mcp-server/mcp (swap the domain for your region, e.g. mcp.datadoghq.eu). It authenticates with OAuth 2.0 in interactive clients, and falls back to a scoped DD_API_KEY plus DD_APPLICATION_KEY pair sent as HTTP headers for headless agents. Datadog recommends a service-account key scoped to only the permissions an agent needs, since this server can read across your entire telemetry estate.

Quick install

Copy-paste configs are provided for all 8 supported clients. Pick your client below.

Add to ~/.claude.json

~/.claude.json
json
{
  "mcpServers": {
    "datadog": {
      "type": "http",
      "url": "https://mcp.datadoghq.com/api/unstable/mcp-server/mcp"
    }
  }
}
Or via CLI
bash
claude mcp add --transport http datadog https://mcp.datadoghq.com/api/unstable/mcp-server/mcp

Heads up

  • First tool call opens a browser to authorize.

Available tools

ToolDescription
search_datadog_logsSearches logs with time, service, and query-string filters.
analyze_datadog_logsPerforms statistical analysis over logs using SQL-style queries.
get_datadog_metricQueries historical and real-time metric data.
get_datadog_metric_contextRetrieves metric metadata, tags, and available tag values.
search_datadog_metricsLists available metrics with filtering.
get_datadog_traceFetches a complete APM trace by trace ID.
search_datadog_spansRetrieves APM spans with filters.
search_datadog_hostsLists monitored hosts with filtering options.
search_datadog_servicesLists services in the Service Catalog.
search_datadog_service_dependenciesShows upstream and downstream service relationships.
search_datadog_rum_eventsSearches Real User Monitoring events with advanced query syntax.
search_datadog_monitorsFinds monitors by status, threshold, and alert conditions.
search_datadog_incidentsRetrieves incidents filtered by state, severity, and metadata.
get_datadog_incidentRetrieves detailed information about a single incident.
search_datadog_eventsSearches monitor alerts, deployments, infrastructure changes, and service status events.
search_datadog_dashboardsLists available dashboards with key details.
get_datadog_notebookRetrieves a notebook by ID.
search_datadog_notebooksSearches notebooks by author, tags, and content.
create_datadog_notebookCreates a new notebook.
edit_datadog_notebookEdits the contents of an existing notebook.
validate_datadog_monitorValidates a monitor definition before creation (alerting toolset).
get_datadog_monitor_templatesRetrieves available monitor templates (alerting toolset).
search_datadog_monitor_groupsSearches monitor groups by name or criteria (alerting toolset).
search_datadog_slosFinds SLOs by name, tags, or service (alerting toolset).
create_datadog_monitorCreates a monitor in draft mode (alerting toolset).
get_monitor_coverageIdentifies monitoring gaps for services and hosts (alerting toolset).
apm_search_spansSearches spans using APM query syntax (APM toolset).
apm_query_traceFilters and aggregates spans within traces (APM toolset).
apm_discover_span_tagsDiscovers available span tag keys (APM toolset).
apm_get_primary_tag_keysRetrieves the organization's primary tag keys (APM toolset).
apm_search_watchdog_storiesFinds Watchdog anomaly stories for services (APM toolset).
apm_get_watchdog_storyRetrieves details of a specific Watchdog story (APM toolset).
apm_latency_bottleneck_summaryAnalyzes latency bottlenecks across traces (APM toolset).
get_change_storiesRetrieves deployment and change events for APM services (APM toolset).
semantic_search_change_storiesFinds related change events using natural language (APM toolset).
apm_search_recommendationsSearches for APM optimization recommendations (APM toolset).
apm_get_recommendationRetrieves the full details of a specific APM recommendation (APM toolset).
search_datadog_casesSearches cases by status, priority, and project (cases toolset).
get_datadog_caseRetrieves case details including its timeline (cases toolset).
create_datadog_caseCreates a new case with a title and project (cases toolset).
update_datadog_caseUpdates case fields such as status and priority (cases toolset).
add_comment_to_datadog_caseAdds a markdown-formatted comment to a case (cases toolset).
link_jira_issue_to_datadog_caseLinks a Jira issue to a case (cases toolset).
list_datadog_case_projectsLists available case projects (cases toolset).
get_datadog_case_projectRetrieves details for a specific case project (cases toolset).
search_datadog_usersSearches users by email, name, or handle (cases toolset).
execute_codeRuns agent-authored TypeScript in a sandbox with the dd.* namespace for multi-signal investigations (code execution toolset).
get_datadog_dashboardRetrieves a dashboard by ID with its widgets (dashboards toolset).
upsert_datadog_dashboardCreates or updates a dashboard (dashboards toolset).
delete_datadog_dashboardPermanently deletes a dashboard (dashboards toolset).
get_widget_referenceReturns widget schemas and building instructions (dashboards toolset).
validate_dashboard_widgetValidates a widget definition (dashboards toolset).
ask_widget_expertAnswers questions about widget configuration (dashboards toolset).
find_datadog_database_instancesDiscovers and ranks database instances (database monitoring toolset).
get_datadog_database_calling_servicesIdentifies services that call a database's queries (database monitoring toolset).
get_datadog_database_explain_plansRetrieves PostgreSQL execution plans (database monitoring toolset).
get_datadog_database_health_signalsRuns health checks for potential database issues (database monitoring toolset).
get_datadog_database_query_performanceAnalyzes query performance metrics (database monitoring toolset).
get_datadog_database_query_statementRetrieves the SQL statement text for a query (database monitoring toolset).
get_datadog_database_recommendationsSurfaces live database recommendations (database monitoring toolset).
get_datadog_database_schemasFetches database schema definitions (database monitoring toolset).
optimize_datadog_database_queryAnalyzes a query for optimization opportunities (database monitoring toolset).
search_datadog_database_plansSearches query execution plans (database monitoring toolset).
search_datadog_database_samplesSearches individual query executions (database monitoring toolset).
ddsql_get_specReturns DDSQL capability specifications (DDSQL toolset).
ddsql_schema_search_tablesSearches available datasets and tables (DDSQL toolset).
ddsql_schema_get_table_columnsGets column definitions for a table (DDSQL toolset).
ddsql_schema_search_unstructured_fieldsSearches fields in logs, RUM, and spans (DDSQL toolset).
ddsql_run_queryExecutes a DDSQL query (DDSQL toolset).
ddsql_create_linkGenerates a DDSQL Editor link (DDSQL toolset).
search_datadog_error_tracking_issuesSearches issues across RUM, logs, and traces (error tracking toolset).
get_datadog_error_tracking_issueRetrieves issue details and impact (error tracking toolset).
update_datadog_error_tracking_issueUpdates an issue's state or assignee (error tracking toolset).
list_datadog_feature_flagsLists feature flags with pagination (feature flags toolset).
get_datadog_feature_flagRetrieves feature flag details (feature flags toolset).
create_datadog_feature_flagCreates a new feature flag (feature flags toolset).
list_datadog_feature_flag_environmentsLists available feature flag environments (feature flags toolset).
list_datadog_feature_flag_allocationsLists allocation rules for a flag (feature flags toolset).
update_datadog_feature_flag_environmentUpdates a flag's environment configuration (feature flags toolset).
check_datadog_flag_implementationVerifies a flag's code implementation (feature flags toolset).
sync_datadog_feature_flag_allocationsSyncs feature flag allocations (feature flags toolset).
search_datadog_k8s_resourcesSearches Kubernetes resources across clusters (Kubernetes toolset).
describe_datadog_k8s_resourceGets detailed information about a Kubernetes resource (Kubernetes toolset).
get_datadog_k8s_manifestRetrieves the YAML manifest for a Kubernetes resource (Kubernetes toolset).
analyze_cloud_network_monitoringAnalyzes network flow data (networks toolset).
search_ndm_devicesSearches monitored network devices (networks toolset).
get_ndm_deviceRetrieves details for a network device (networks toolset).
search_ndm_interfacesLists interfaces on network devices (networks toolset).
browser_onboardingGuides Browser RUM setup (onboarding toolset).
devices_onboardingGuides device monitoring setup (onboarding toolset).
kubernetes_onboardingGuides Kubernetes cluster onboarding (onboarding toolset).
llm_observability_onboardingGuides LLM observability setup (onboarding toolset).
test_optimization_onboardingGuides test optimization setup (onboarding toolset).
serverless_onboardingGuides AWS Lambda and GCP Cloud Run setup (onboarding toolset).
source_map_uploadsGuides source map uploading for RUM (onboarding toolset).
list_reference_tablesLists and searches reference tables (reference tables toolset).
get_reference_table_rowsRetrieves reference table rows by primary key (reference tables toolset).
append_reference_table_rowsAdds rows to a reference table (reference tables toolset).
create_reference_tableCreates a reference table from cloud storage (reference tables toolset).
search_rum_applicationsLists RUM applications and resolves application IDs (RUM toolset).
get_rum_summaryReturns RUM vital metrics with period comparisons (RUM toolset).
get_rum_insightReturns aggregated RUM view insights (RUM toolset).
search_rum_metricsExplores available RUM metrics (RUM toolset).
search_rum_retention_filtersLists RUM retention filters (RUM toolset).
datadog_secrets_scanScans for hardcoded secrets and credentials (security toolset).
search_datadog_security_signalsSearches Cloud SIEM and App & API Protection signals (security toolset).
analyze_datadog_security_signalsAnalyzes security signals using SQL aggregations (security toolset).
get_datadog_security_signalRetrieves details for a single security signal (security toolset).
security_findings_schemaReturns the available security finding fields (security toolset).
analyze_security_findingsQueries security findings with SQL (security toolset).
search_security_findingsRetrieves complete security finding objects (security toolset).
search_datadog_ci_pipeline_eventsSearches CI pipeline events with filtering (software delivery toolset).
aggregate_datadog_ci_pipeline_eventsAggregates CI pipeline statistics (software delivery toolset).
get_datadog_flaky_testsSearches flaky tests with triage details (software delivery toolset).
update_datadog_flaky_test_statesSets the state of flaky tests (software delivery toolset).
aggregate_datadog_test_eventsAggregates test reliability trends (software delivery toolset).
search_datadog_test_eventsSearches test events by branch or commit (software delivery toolset).
get_datadog_code_coverage_branch_summaryFetches branch code-coverage metrics (software delivery toolset).
get_datadog_code_coverage_commit_summaryFetches commit code-coverage metrics (software delivery toolset).
get_datadog_test_optimization_settingsRetrieves enabled test optimization features (software delivery toolset).
get_datadog_flaky_tests_management_policiesRetrieves auto-quarantine rules for flaky tests (software delivery toolset).
search_dora_deploymentsSearches deployment events for DORA metrics (software delivery toolset).
aggregate_dora_deploymentsAggregates DORA deployment metrics (software delivery toolset).
get_synthetics_testsSearches HTTP API synthetic tests (synthetics toolset).
edit_synthetics_testsEdits synthetic test assertions and configuration (synthetics toolset).
synthetics_test_wizardCreates HTTP API synthetic tests (synthetics toolset).
list_datadog_workflowsLists and searches workflows (workflows toolset).
get_datadog_workflowRetrieves workflow details and triggers (workflows toolset).
execute_datadog_workflowRuns a published workflow (workflows toolset).
get_datadog_workflow_instanceRetrieves the status of a workflow execution (workflows toolset).
update_datadog_workflow_with_agent_triggerAdds an agent trigger capability to a workflow (workflows toolset).

Required configuration

  • DD_API_KEYOptional

    Datadog API key, sent as an HTTP header when OAuth is unavailable. Use a scoped service-account key.

  • DD_APPLICATION_KEYOptional

    Datadog application key, paired with the API key for header-based authentication.

What you can do with it

Investigate an incident end to end

The agent searches monitors and incidents, pulls the offending service's traces and logs, checks Watchdog stories, and correlates a recent deployment to find the root cause without you switching tabs.

Triage an alert from the editor

When a monitor fires, the agent queries the relevant metric, analyzes logs around the spike, and inspects upstream and downstream service dependencies to tell you what is actually broken.

FAQ

Is it free?
The MCP server itself is included with Datadog at no extra charge; you need a Datadog account and pay normal Datadog usage. Tools only expose data for products your plan already includes.
Does it support remote/OAuth?
Yes. It is a hosted remote server (US1: https://mcp.datadoghq.com/api/unstable/mcp-server/mcp, swap the domain for your region) that uses OAuth 2.0 in interactive clients and accepts a scoped DD_API_KEY plus DD_APPLICATION_KEY as HTTP headers for headless agents.
How do I control which tools are exposed?
Append a toolsets query parameter to the endpoint URL. The default is the core toolset; toolsets=all enables every generally available toolset, or you can list specific ones like apm, security, or synthetics.
← Browse all monitoring-observability servers