Skip to content
Merged
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
45 changes: 44 additions & 1 deletion content/en/bits_ai/mcp_server/_index.md
Original file line number Diff line number Diff line change
Expand Up @@ -80,6 +80,7 @@
- `security`: Tools for code security scanning and searching [security signals][33] and [security findings][34]
- `software-delivery`: Tools for interacting with Software Delivery ([CI Visibility][21] and [Test Optimization][24])
- `synthetics`: Tools for interacting with Datadog [Synthetic tests][20]
- `workflows`: Tools for [Workflow Automation][39], including listing, inspecting, executing, and configuring workflows for agent use

To use a toolset, include the `toolsets` query parameter in the endpoint URL when connecting to the MCP Server ([remote authentication][27] only).

Expand Down Expand Up @@ -733,6 +734,47 @@
- Create a Synthetics test on `/path/to/endpoint`.
- Create a Synthetics test that checks if my domain `mycompany.com` stays up.

### `list_datadog_workflows`
*Toolset: **workflows***\
Lists and searches [Workflow Automation][39] workflows. Supports filtering by name, tags, owner, handle, and trigger type (such as `monitor`, `schedule`, `api`, or `incident`). Results can be sorted by fields like `name` or `updatedAt`.

- Show me all published workflows tagged with `team:platform`.

Check warning on line 741 in content/en/bits_ai/mcp_server/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'me'.
- List workflows that have an agent trigger configured.
- Find all workflows related to incident response owned by Alice Smith.

### `get_datadog_workflow`
*Toolset: **workflows***\
Retrieves detailed information about a specific workflow, including its triggers, steps, connections, and input schema.

- Get the full details for workflow `00000000-0000-0000-0000-000000000000`.
- Show me the input parameters and steps for the deployment rollback workflow.

Check warning on line 750 in content/en/bits_ai/mcp_server/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'me'.
- What triggers are configured for this workflow?

### `execute_datadog_workflow`
*Toolset: **workflows***\
Executes a published workflow that has an agent trigger, with optional input parameters matching the workflow's input schema.

- Run the incident escalation workflow for service `checkout-api` with severity `high`.
- Execute the deployment rollback workflow for the payments service.
- Trigger the On-Call notification workflow with the context from this investigation.

**Note**: The workflow must be published and have an agent trigger configured. Use `update_datadog_workflow_with_agent_trigger` to add one if needed.

### `get_datadog_workflow_instance`
*Toolset: **workflows***\
Retrieves the status and details of a workflow execution instance, including step results and outputs.

- What's the status of the workflow execution I triggered?

Check warning on line 767 in content/en/bits_ai/mcp_server/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'I'.
- Did the incident escalation workflow complete successfully?
- Show me the detailed outputs from workflow instance `00000000-0000-0000-0000-000000000000`.

Check warning on line 769 in content/en/bits_ai/mcp_server/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'me'.

### `update_datadog_workflow_with_agent_trigger`
*Toolset: **workflows***\
Adds an agent trigger to a workflow and publishes it, enabling the workflow to be executed by AI agents.

- Add an agent trigger to the deployment rollback workflow so I can run it from here.

Check warning on line 775 in content/en/bits_ai/mcp_server/_index.md

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns

Avoid first-person pronouns such as 'I'.
- Configure the incident response workflow to be triggerable by an agent.

## 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:
Expand Down Expand Up @@ -774,4 +816,5 @@
[36]: /getting_started/site/#navigate-the-datadog-documentation-by-site
[37]: https://help.datadoghq.com/hc/en-us/requests/new
[38]: /service_management/case_management/
[39]: /bits_ai/mcp_server/setup#local-binary-authentication
[39]: /actions/workflows/
[40]: /bits_ai/mcp_server/setup#local-binary-authentication
Loading