The Datadog MCP Server acts as a bridge between your observability data in Datadog and any AI agents that support the Model Context Protocol (MCP). Providing structured access to relevant Datadog contexts, features, and tools, the MCP Server lets you query and retrieve observability insights directly from AI-powered clients such as Cursor, OpenAI Codex, Claude Code, or your own AI agent.

Ready to get started? See Set Up the Datadog MCP Server for connection instructions.

This demo shows the Datadog MCP Server being used in Cursor and Claude Code (unmute for audio):

Disclaimers

• The Datadog MCP Server is not supported for production use during the Preview.
• Only Datadog organizations that have been specifically allowlisted can use the Datadog MCP Server. It is not available to the general public.
• The Datadog MCP Server is HIPAA-eligible. You are responsible for ensuring that the AI tools you connect to the Datadog MCP Server meet your compliance requirements, such as HIPAA.
• Datadog collects certain information about your usage of the Remote Datadog MCP Server, including how you interact with it, whether errors occurred while using it, what caused those errors, and user identifiers in accordance with the Datadog Privacy Policy and Datadog’s EULA. This data is used to help improve the server’s performance and features, including transitions to and from the server and the applicable Datadog login page for accessing the Services, and context (for example, user prompts) leading to the use of MCP tools. The data is stored for 120 days.

Requirements

Datadog users must have the Incidents Read permission to use the MCP Server.

For setup instructions, see Set Up the Datadog MCP Server.

Toolsets

The Datadog MCP Server supports toolsets, which allow you to use only the tools you need, saving valuable context window space. These toolsets are available:

• core: The default toolset
• synthetics: Tools for interacting with Datadog Synthetic tests
• software-delivery: Tools for interacting with Software Delivery (CI Visibility and Test Optimization)
• error-tracking: Tools for interacting with Datadog Error Tracking
• dbm: Tools for interacting with Database Monitoring

To use a toolset, include the toolsets query parameter in the endpoint URL when connecting to the MCP Server (remote authentication only). For example:

• https://mcp.datadoghq.com/api/unstable/mcp-server/mcp retrieves only the core tools (this is the default if toolsets is not specified).
• https://mcp.datadoghq.com/api/unstable/mcp-server/mcp?toolsets=synthetics retrieves only Synthetic Testing-related tools.
• https://mcp.datadoghq.com/api/unstable/mcp-server/mcp?toolsets=core,synthetics,software-delivery retrieves core, Synthetic Testing, and Software Delivery tools.

Available tools

This section lists the tools available in the Datadog MCP Server and provides example prompts for using them.

search_datadog_events

Toolset: core
Searches events like monitor alerts, deployment notifications, infrastructure changes, security findings, and service status changes.

• Show me all deployment events from the last 24 hours.
• Find events related to our production environment with error status.
• Get events tagged with service:api from the past hour.

Note: See the Event Management API for more details.

get_datadog_incident

Toolset: core
Retrieves detailed information about an incident.

• Get details for incident ABC123.
• What’s the status of incident ABC123?
• Retrieve full information about the Redis incident from yesterday.

Note: The tool is operational, but does not include incident timeline data.

get_datadog_metric

Toolset: core
Queries and analyzes historical or real-time metric data, supporting custom queries and aggregations.

• Show me CPU utilization metrics for all hosts in the last 4 hours.
• Get Redis latency metrics for the production environment.
• Display memory usage trends for our database servers.

get_datadog_metric_context

Toolset: core
Retrieves detailed information about a metric including metadata, available tags, and tag values for filtering and grouping.

• What tags are available for the system.cpu.user metric?
• Show me all possible values for the env tag on redis.info.latency_ms.
• Get metadata and dimensions for the requests.count metric.

search_datadog_monitors

Toolset: core
Retrieves information about Datadog monitors, including their statuses, thresholds, and alert conditions.

• List all monitors that are currently alerting.
• Show me monitors related to our payment service.
• Find monitors tagged with team:infrastructure.

get_datadog_trace

Toolset: core
Fetches a complete trace from Datadog APM using a trace ID.

• Get the complete trace for ID 7d5d747be160e280504c099d984bcfe0.
• Show me all spans for trace abc123 with timing information.
• Retrieve trace details including database queries for ID xyz789.

Note: Large traces with thousands of spans may be truncated (and indicated as such) without a way to retrieve all spans.

search_datadog_dashboards

Toolset: core
Lists available Datadog dashboards and key details.

• Show me all available dashboards in our account.
• List dashboards related to infrastructure monitoring.
• Find shared dashboards for the engineering team.

Note: This tool lists relevant dashboards but provides limited detail about their contents.

get_datadog_notebook

Toolset: core
Retrieves detailed information about a specific notebook by ID, including name, status, and author.

• Get details for notebook abc-123-def.
• Show me the contents of the debugging notebook from yesterday.

search_datadog_notebooks

Toolset: core
Lists and searches Datadog notebooks with filtering by author, tags, and content.

• Show me all notebooks created by the platform team.
• Find notebooks related to performance investigation.
• List notebooks tagged with incident-response.

search_datadog_hosts

Toolset: core
Lists and provides information about monitored hosts, supporting filtering and searching.

• Show me all hosts in our production environment.
• List unhealthy hosts that haven’t reported in the last hour.
• Get all hosts tagged with role:database.

search_datadog_incidents

Toolset: core
Retrieves a list of Datadog incidents, including their state, severity, and metadata.

• Show me all active incidents by severity.
• List resolved incidents from the past week.
• Find incidents that are customer-impacting.

search_datadog_metrics

Toolset: core
Lists available metrics, with options for filtering and metadata.

• Show me all available Redis metrics.
• List CPU-related metrics for our infrastructure.
• Find metrics tagged with service:api.

search_datadog_services

Toolset: core
Lists services in Datadog’s Software Catalog with details and team information.

• Show me all services in our microservices architecture.
• List services owned by the platform team.
• Find services related to payment processing.

search_datadog_service_dependencies

Toolset: core
Retrieves service dependencies (upstream/downstream) and services owned by a team.

• Show me all upstream services that call the checkout service.
• What downstream services does the payment API depend on?
• List all services owned by the platform team.

search_datadog_spans

Toolset: core
Retrieves spans from APM traces with filters such as service, time, resource, and so on.

• Show me spans with errors from the checkout service.
• Find slow database queries in the last 30 minutes.
• Get spans for failed API requests to our payment service.

analyze_datadog_logs

Toolset: core
Analyze Datadog logs using SQL queries for counting, aggregations, and numerical analysis. Use this for statistical analysis.

• Count error logs by service in the last hour.
• Show me the top 10 HTTP status codes with their counts.
• Which services were logging the most during that time period?

search_datadog_logs

Toolset: core
Searches logs with filters (time, query, service, host, storage tier, and so on) and returns log details. Renamed from get_logs.

• Show me error logs from the nginx service in the last hour.
• Find logs containing ‘connection timeout’ from our API service.
• Get all 500 status code logs from production.

search_datadog_rum_events

Toolset: core
Search Datadog RUM events using advanced query syntax.

• Show JavaScript errors and console warnings in RUM.
• Find pages that are loading slowly (more than 3 seconds).
• Show recent user interactions on product detail pages.

get_synthetics_tests

Toolset: synthetics
Searches Datadog Synthetic tests.

• Help me understand why the Synthetic test on endpoint /v1/my/tested/endpoint is failing.
• There is an outage; find all the failing Synthetic tests on the domain api.mycompany.com.
• Are Synthetic tests on my website api.mycompany.com still working in the past hour?

edit_synthetics_tests

Toolset: synthetics
Edits Datadog Synthetic HTTP API tests.

• Improve the assertions of the Synthetic test defined on my endpoint /v1/my/tested/endpoint.
• Pause the test aaa-bbb-ccc and set the locations to only European locations.
• Add my team tag to the test aaa-bbb-ccc.

synthetics_test_wizard

Toolset: synthetics
Preview and create Datadog Synthetics HTTP API Tests.

• Create Synthetics tests on every endpoint defined in this code file.
• Create a Synthetics test on /path/to/endpoint.
• Create a Synthetics test that checks if my domain mycompany.com stays up.

search_datadog_ci_pipeline_events

Toolset: software-delivery
Searches CI events with filters and returns details on them.

• Show me all the pipelines for my commit 58b1488.
• Show me the latest pipeline failure in branch my-branch.
• Propose a fix for the job integration-test that fails every time on my branch my-branch.

aggregate_datadog_ci_pipeline_events

Toolset: software-delivery
Aggregates CI pipeline events to produce statistics, metrics, and grouped analytics.

• What’s the average job duration for the last 7 days?
• How many failed pipelines have there been in the last 2 weeks?
• Show me the 95th percentile of pipeline duration grouped by pipeline name.

get_datadog_flaky_tests

Toolset: software-delivery
Searches Datadog Test Optimization for flaky tests and returns triage details (failure rate, category, owners, history, CI impact), with pagination and sorting.

• Find active flaky tests for the checkout service owned by @team-abc, sorted by failure rate.
• Show flaky tests on branch main for repo github.com/org/repo, most recent first.
• List flaky tests in the timeout category with high failure rate (50%+) so I can prioritize fixes.

aggregate_datadog_test_events

Toolset: software-delivery
Aggregates Datadog Test Optimization events to quantify reliability and performance trends with aggregation functions, optional metrics, group-by facets, and configurable test levels.

• Count the number of failed tests over the last week, grouped by branch.
• Show me the 95th-percentile duration for each test suite to identify the slowest ones.
• Count all passing and failing tests, grouped by code owners.

search_datadog_test_events

Toolset: software-delivery
Searches Test Optimization test events with filters and returns details on them.

• Show me failed tests on branch main from the last 24 hours.
• Get test executions for commit abc123 to see what passed and failed.
• Show me all flaky test runs for the checkout service.
• Find tests owned by @team-name that are failing.

search_datadog_error_tracking_issues

Toolset: error-tracking
Searches Error Tracking Issues across data sources (RUM, Logs, Traces).

• Show me all Error Tracking Issues in the checkout service from the last 24 hours.
• What are the most common errors in my application over the past week?
• Find Error Tracking Issues in the production environment with service:api.

get_datadog_error_tracking_issue

Toolset: error-tracking
Retrieves detailed information about a specific Error Tracking Issue from Datadog.

• Help me solve Error Tracking Issue 550e8400-e29b-41d4-a716-446655440000.
• What is the impact of Error Tracking Issue a3c8f5d2-1b4e-4c9a-8f7d-2e6b9a1c3d5f?
• Create a test case to reproduce Error Tracking Issue 7b2d4f6e-9c1a-4e3b-8d5f-1a7c9e2b4d6f.

search_datadog_dbm_plans

Toolset: dbm
Searches Database Monitoring query execution plans, which show how the database engine executes queries, including index usage, join strategies, and cost estimates. Use this to analyze query performance and identify optimization opportunities.

• Show me execution plans for slow queries on host:db-prod-1 from the last hour.
• Find query plans with @db.plan.type:explain_analyze for the production database.
• Get execution plans for queries by @db.user:app_user with duration greater than 1 second.

search_datadog_dbm_samples

Toolset: dbm
Searches Database Monitoring query samples, which represent individual query executions with performance metrics. Use this to analyze database activity patterns, identify slow queries, and investigate database performance issues.

• Show me query samples with @duration:>1000000000 (duration greater than 1 second) from db:mydb.
• Find slow queries on host:db-prod-1 filtered by @db.user:app_user.
• Get recent query samples for @db.query_signature:abc123def and analyze performance patterns.

Context efficiency

The Datadog MCP Server is optimized to provide responses in a way that AI agents get relevant context without being overloaded with unnecessary information. For example:

• Responses are truncated based on the estimated length of responses each tool provides. The tools respond to AI agents with instructions on how to request more information if the response was truncated.
• Most tools have a max_tokens parameter that enables AI agents to request less or more information.

Track tool calls in Audit Trail

You can view information about calls made by MCP Server tools in Datadog’s Audit Trail. Search or filter by the event name MCP Server.

Feedback

The Datadog MCP Server is under significant development. During the Preview, use this feedback form to share any feedback, use cases, or issues encountered with your prompts and queries.

Further reading

Documentation, liens et articles supplémentaires utiles:

Connect your AI agents to Datadog tools and context using the Datadog MCP ServerBLOG Datadog Extension for CursorDOCUMENTATION Set Up the Datadog MCP ServerDOCUMENTATION Bits AI OverviewDOCUMENTATION Debug live production issues with the Datadog Cursor extensionBLOG Datadog + OpenAI: Codex CLI integration for AI‑assisted DevOpsBLOG