Skip to content
2 changes: 1 addition & 1 deletion content/en/mcp_server/setup.md
Original file line number Diff line number Diff line change
Expand Up @@ -682,6 +682,7 @@ These toolsets are generally available. See [Datadog MCP Server Tools][49] for a
- `product-analytics`: Tools for interacting with [Product Analytics][41] queries
- `profiling`: Tools for discovering, exploring, and analyzing [Continuous Profiler][58] data
- `reference-tables`: Tools for managing [Reference Tables][48], including listing tables, reading rows, appending rows, and creating tables from cloud storage
- `rum`: Tools for [Real User Monitoring][57], including resolving applications, summarizing performance, surfacing aggregated insights, exploring metrics, managing retention filters, and managing custom RUM metrics
- `security`: Tools for code security scanning and searching [security signals][39] and [security findings][40]
- `software-delivery`: Tools for interacting with Software Delivery ([CI Visibility][30] and [Test Optimization][31])
- `synthetics`: Tools for interacting with Datadog [Synthetic tests][29]
Expand All @@ -694,7 +695,6 @@ These toolsets are in Preview. Sign up for a toolset by completing the Product P
- `apm`: ([Sign up][45]) Tools for in-depth [APM][34] trace analysis, span search, Watchdog insights, and performance investigation
- `code-exec`: ([Sign up][60]) A single tool that runs agent-authored TypeScript in a Datadog-managed sandbox with direct access to Datadog APIs, for multi-signal investigation and ad-hoc data exploration in one call
- `remote-actions`: ([Sign up][62]) Tools for on-host diagnostics, including reading files, listing directories, and running safe read-only shell commands directly on instrumented hosts through the Agent
- `rum`: Tools for [Real User Monitoring][57], including summarizing application performance, inspecting application configuration, and running performance investigations

## Supported clients

Expand Down
63 changes: 59 additions & 4 deletions content/en/mcp_server/tools.md
Original file line number Diff line number Diff line change
Expand Up @@ -196,14 +196,23 @@ Searches logs with filters (time, query, service, host, storage tier, and so on)
- Get all 500 status code logs from production.

### `search_datadog_rum_events`
*Toolset: **core***\
*Toolset: **core**, **rum***\
*Permissions Required: `RUM Apps Read`*\
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.

### `aggregate_rum_events`
*Toolset: **core**, **rum***\
*Permissions Required: `RUM Apps Read`*\
Aggregates RUM events to compute counts, sums, averages, min, max, cardinality, and percentiles, with grouping support. Use this for statistical analysis and trend data, not for inspecting individual events.

- Count JavaScript errors by page in the last 24 hours.
- Show me the p95 loading time grouped by country for my main RUM application.
- How many sessions had a Core Web Vitals failure this week?

### `create_datadog_notebook`
*Toolset: **core***\
*Permissions Required: `Notebooks Read` and `Notebooks Write`*\
Expand Down Expand Up @@ -1210,9 +1219,7 @@ Runs a read-only shell command on a specified host. Supported commands include:

## RUM

Tools for [Real User Monitoring][58], including resolving applications, summarizing performance, surfacing aggregated insights for views, exploring metrics, and inspecting application configuration.

<div class="alert alert-info">The <code>rum</code> toolset is in Preview. Contact <a href="/help">Datadog support</a> to request access.</div>
Tools for [Real User Monitoring][58], including resolving applications, summarizing performance, surfacing aggregated insights for views, exploring metrics, inspecting application configuration, managing retention filters, and managing custom RUM metrics.

### `search_rum_applications`
*Toolset: **rum***\
Expand Down Expand Up @@ -1246,6 +1253,22 @@ Explores RUM metrics for an application, including out-of-the-box metrics and cu
- List the custom RUM metrics defined on the "checkout-web" application.
- Show me available RUM metrics related to page load time on my main app.

### `upsert_rum_metric`
*Toolset: **rum***\
*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\
Creates or updates a custom RUM metric. Checks immutable fields before updating an existing metric. This operation is idempotent.

- Create a distribution metric `rum.view.lcp_by_country` that tracks p95 LCP for view events, grouped by country.
- Update the filter on `rum.error.checkout_errors` to exclude synthetic test traffic.

### `delete_rum_metric`
*Toolset: **rum***\
*Permissions Required: `RUM Apps Read` and `RUM Generate Metrics`*\
Permanently deletes a custom RUM metric by ID. This operation is idempotent.

- Delete the custom RUM metric `rum.view.my_custom_metric`.
- Remove the `rum.view.legacy_page_views` RUM metric from my organization.

### `search_rum_retention_filters`
*Toolset: **rum***\
*Permissions Required: `RUM Retention Filters Read`*\
Expand All @@ -1254,6 +1277,38 @@ Lists retention filters configured on a RUM application. Read-only; available fo
- List the retention filters configured on the "checkout-web" application.
- What retention filters do I have on my main RUM app?

### `append_new_rum_retention_filter`
*Toolset: **rum***\
*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\
Creates a RUM retention filter, appended to the end of the evaluation order. Retention filters control which RUM events are indexed and retained, which affects billing. Confirm the change before applying.

- Create a retention filter on "checkout-web" that retains 100% of error events.
- Add a filter to my main RUM app that keeps all sessions matching `@view.url_path:/checkout`.

### `update_rum_retention_filter`
*Toolset: **rum***\
*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\
Updates an existing RUM retention filter's attributes in place, such as its name, event type, query, sample rate, or enabled state. Confirm the change before applying.

- Increase the sample rate on the "checkout errors" retention filter to 100%.
- Disable the "long tasks" retention filter on my main RUM app.

### `reorder_rum_retention_filters`
*Toolset: **rum***\
*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\
Sets the full evaluation order of a RUM application's retention filters. Filters are evaluated top-down and each event stops at the first match, so order determines which sample rate applies. Confirm the new order before applying.

- Move the "checkout errors" retention filter above the catch-all filter on "checkout-web".
- Reorder my retention filters so the specific filters are evaluated before the broad ones.

### `delete_rum_retention_filter`
*Toolset: **rum***\
*Permissions Required: `RUM Retention Filters Write` or `Product Analytics Apps Write`*\
Permanently deletes a RUM retention filter by ID. Confirm the deletion before applying. This operation is idempotent.

- Delete the "legacy sessions" retention filter from "checkout-web".
- Remove the retention filter with ID `abc-123-def` from my main RUM app.

## Security

Tools for code security scanning, analyzing, searching and triaging [security signals][53], managing [detection rules][60] and [suppressions][61], and analyzing [security findings][54].
Expand Down
Loading