Skip to content

Add MCP tool for CI Visibility #32993

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
wants to merge 2 commits into
base: master
Choose a base branch
from
Open

Add MCP tool for CI Visibility #32993

Changes from all commits
Commits
Show all changes
2 commits
Select commit Hold shift + click to select a range
f7e8c58
Add MCP tool for CI Visibility
gturbat Nov 21, 2025
e086f20
Apply suggestions from code review
gturbat Nov 21, 2025
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
20 changes: 15 additions & 5 deletions content/en/bits_ai/mcp_server/setup/_index.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -56,7 +56,7 @@
| [VS Code][11] | Microsoft | Datadog [Cursor & VS Code extension](#connect-in-cursor-and-vs-code) recommended. |
| [Goose][9] | Block | |
| [Q CLI][10] | Amazon | For remote authentication, add `"oauthScopes": []` to the server [configuration](?tab=remoteauthentication#example-configurations). |
| [Kiro][22] | Amazon | |
| [Kiro][23] | Amazon | |
| [Cline][18] | Cline Bot | Limited support for remote authentication. Use [local binary authentication](?tab=localbinaryauthentication#connect-in-supported-ai-clients) as needed. |

## Requirements
Expand Down Expand Up @@ -215,7 +215,7 @@
}
{{< /code-block >}}

For security, use a scoped API key and application key from a [service account][23] that has only the required permissions.
For security, use a scoped API key and application key from a [service account][24] that has only the required permissions.

### Test access to the MCP Server

Expand All @@ -235,12 +235,13 @@

- `core`: The default toolset
- `synthetics`: Tools for interacting with Datadog [Synthetic tests][21]
- `software-delivery`: Tools for interacting with Software Delivery [CI Visibility][22]

To use a toolset, include the `toolsets` query parameter in the endpoint URL when connecting to the MCP Server ([remote authentication](?tab=remote-authentication#connect-in-supported-ai-clients) 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` retrieves both core and Synthetic Testing 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

Expand Down Expand Up @@ -391,6 +392,14 @@
- 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`.

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

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns 

Avoid first-person pronouns such as 'my'.

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

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns 

Avoid first-person pronouns such as 'me'.
- Show me the latest pipeline failure in branch `my-branch`.

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

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns 

Avoid first-person pronouns such as 'me'.
- Propose a fix for the job `integration-test` that fails every time on my branch `my-branch`.

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

View workflow job for this annotation

GitHub Actions / vale

Datadog.pronouns 

Avoid first-person pronouns such as 'my'.

## 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 @@ -431,5 +440,6 @@
[19]: /account_management/rbac/permissions/#case-and-incident-management
[20]: https://docs.google.com/forms/d/e/1FAIpQLSeorvIrML3F4v74Zm5IIaQ_DyCMGqquIp7hXcycnCafx4htcg/viewform
[21]: /synthetics/
[22]: https://kiro.dev/
[23]: /account_management/org_settings/service_accounts/
[22]: /continuous_integration/
[23]: https://kiro.dev/
[24]: /account_management/org_settings/service_accounts/
Loading