How to integrate Dynatrace MCP with Atomic Agent

Connect Atomic Agent to Dynatrace MCP. List active problems in your dynatrace environment, show host health metrics for yesterday, and more using natural language, with authentication handled for you.

Dynatrace logoDynatrace
Oauth2

Dynatrace is an observability platform for monitoring applications, infrastructure, and user experience. It helps teams detect issues, understand system health, and automate operations.

159 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,500+ apps through Composio, including Dynatrace.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Dynatrace account. See the Atomic Agent documentation for installation instructions.

Also integrate Dynatrace with

How Atomic Agent connects to Dynatrace

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Dynatrace to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Dynatrace. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Dynatrace account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Dynatrace MCP server, and what's possible with it?

The Dynatrace MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Dynatrace account. It provides structured and secure access to observability, analytics, automation, settings, documents, and telemetry capabilities, so your agent can run Grail queries, manage problems, create and control workflows, and organize shared documents on your behalf.

  • Grail query analysis: Instruct your agent to run Dynatrace DQL queries, request query completions, and cancel queries that are still running.
  • Problem response: Have your agent add comments to Dynatrace problems, close resolved problems with a closing comment, or remove an existing problem comment.
  • Workflow automation: Let the agent create, duplicate, export, or cancel Dynatrace workflow executions, and manage scheduling rules and business calendars.
  • Document collaboration: Direct your agent to create, download, share, lock, restore, or delete Dynatrace documents, including managing direct and environment-wide sharing.
  • Settings and metric management: Instruct your agent to grant or remove settings permissions, delete settings objects, generate schema defaults, or delete metrics selected by metric and age.

Use Dynatrace from Atomic Agent

With your account connected, ask Atomic Agent to work with Dynatrace in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Dynatrace action and event your agent gets out of the box.

Acquire Lock

Acquire or extend the current user's lock on a document.

Add Direct Share Recipients

Add users or groups to an accessible Dynatrace direct share.

Add Settings Object Accessor Permissions

Grant read or write permissions on a settings object to one accessor.

Autocomplete Grail Query

Return structured Dynatrace Grail DQL completion suggestions at an optional cursor position.

Bulk Delete Document

Move up to 100 documents to trash in one request and return the outcome for each document.

Cancel Execution

Request cancellation of an active workflow execution.

Cancel Grail Query

Cancel a Grail query identified by its request token.

Cancel Task Execution

Request cancellation of an active task execution.

Claim Environment Share

Claim another user's environment share and gain its granted access to the shared document.

Close Problem

Close an open Dynatrace problem and add the supplied closing comment.

Create Business Calendar

Create a Dynatrace Automation business calendar.

Create Direct Share

Create a read or read-write direct share for a Dynatrace document.

Create Document

Create a Dynatrace document from metadata and up to 50 MB of binary content.

Create Environment Share

Create an environment-wide share link for a document owned by or reshareable by the connected user.

Create Problem Comment

Add a new visible comment to an existing Dynatrace problem.

Create Scheduling Rule

Create a Dynatrace scheduling rule from the official SDK rule contract.

Create Workflow

Create a Dynatrace workflow from its task and trigger definition.

Delete Business Calendar

Delete a Dynatrace Automation business calendar.

Delete Direct Share

Delete a direct share without deleting its Dynatrace document.

Delete Document

Move a document to the trash.

Delete Environment Share

Delete an environment share and revoke the document access granted through that share from all claimers.

Delete Metric

Irreversibly trigger deletion of one metric ingested through Metrics v2.

Delete Metrics

Irreversibly trigger bulk deletion of Metrics v2-ingested metrics selected by metric_selector and age.

Delete Problem Comment

Permanently delete one identified comment from an identified Dynatrace problem.

Delete Scheduling Rule

Permanently delete one scheduling rule by UUID.

Delete Settings Object

Delete a Dynatrace settings object using optimistic locking.

Delete Settings Object Accessor Permissions

Remove every permission a user, group, or all-users accessor has on a settings object.

Delete Snapshot

Irrevocably delete a snapshot without changing the document's current state.

Delete Trashed Document

Irreversibly destroy a trashed Dynatrace document owned by the connected user.

Delete Trashed Workflow

Permanently delete a workflow that is already in trash.

Delete Webhook Handler

Delete a webhook handler using an installed Dynatrace app as its context.

Download Document Content

Download the binary content of the latest document version or a specific snapshot, preserving the provider's filename and MIME type.

Duplicate Business Calendar

Create a copy of a Dynatrace Automation business calendar.

Duplicate Scheduling Rule

Duplicate a Dynatrace scheduling rule, optionally assigning a new title.

Duplicate Workflow

Create a new workflow by copying an existing Dynatrace workflow.

Execute Grail Query

Start an asynchronous Grail DQL query and return either its result or a request token for polling.

Export Workflow

Export a workflow as the provider's JSON WorkflowExport definition.

Export Workflow History Record as JSON

Export one historical workflow version as a transferable JSON workflow definition, including its tasks and configuration.

Export Workflow Template

Export the current workflow, or a historical version when version is supplied, as the provider's reusable YAML template envelope.

Generate Schema Default Value

Generate the default settings value for a Dynatrace schema and optional scope.

Get Action Execution

Return one Dynatrace Automation action execution.

Get Action Execution Log

Return the plain-text log for a Dynatrace Automation action execution.

Get Business Calendar

Return one Dynatrace Automation business calendar.

Get Business Calendar History Record

Return one historical version of a Dynatrace Automation business calendar.

Get Direct Share

Return an accessible Dynatrace direct share by its ID.

Get Document

Retrieve a document's metadata and binary content, optionally from a snapshot.

Get Document Metadata

Return metadata for the latest version or a specific snapshot of a document.

Get Entity

Return one monitored entity by its Dynatrace entity identifier.

Get Entity Type

Return the schema and relationship metadata for one Dynatrace entity type.

Get Environment Share

Retrieve an accessible Dynatrace environment share by its ID.

Get Event

Return one Dynatrace event by its event ID; the connected environment must expose the Events v2 REST endpoint.

Get Event Property

Return details of one event property supported by the Dynatrace environment.

Get Event Type

Return details of one event type supported by the Dynatrace environment.

Get Execution

Return a workflow execution and its current asynchronous state.

Get Execution Log

Return the plain-text log for one workflow execution.

Get Holiday Calendar

Return a country's holidays, optionally bounded by an inclusive date range.

Get Metric Descriptor

Return the descriptor of one metric by its metric key.

Get Problem

Return details of one Dynatrace problem by its problem ID.

Get Problem Comment

Return one identified comment from a Dynatrace problem.

Get Scheduling Rule

Return one scheduling rule by UUID.

Get Scheduling Rule History Record

Return one historical version of a Dynatrace scheduling rule.

Get Schema Definition

Retrieve the complete definition of a Dynatrace settings schema.

Get Settings Object

Return a Dynatrace settings object by ID; secret properties remain irreversibly masked outside trusted app functions.

Get Settings Object Accessor Permissions

Return a user, group, or all-users accessor's permissions on one Dynatrace settings object.

Get Settings Object Permissions

Return every accessor and permission configured on a settings object.

Get Snapshot Metadata

Return metadata about a specific snapshot, not the snapshotted document content.

Get Task Execution

Return one task execution, including its asynchronous state and result.

Get Task Execution Input

Return the merged JSON inputs from all action executions belonging to a task execution.

Get Task Execution Log

Return the raw standard-output log for a task execution; the log can be large.

Get Task Execution Result

Return the merged JSON results from all action executions belonging to a task execution.

Get Transitions

Return workflow task transitions keyed by transition name for an execution.

Get Webhook Handler

Return one webhook handler for an installed Dynatrace app context.

Get Workflow

Return a workflow by UUID.

Inspect Workflow History Record

Retrieve one saved workflow history version for inspection, including its runtime and modification metadata.

Get Workflow Task

Return one task definition from a Dynatrace workflow.

Ingest Event

Ingest one event into the connected Dynatrace environment.

Ingest Metric Data Points

Ingest newline-separated Dynatrace metric line protocol as raw text.

Inspect Lock

Inspect a document lock, including its owner and document version.

Inspect Trashed Document

Return metadata and deletion audit information for a trashed Dynatrace document owned by the connected user.

List All Event Logs

Return all structured event log entries for a workflow execution.

List Business Calendar History Records

Return the change history for a Dynatrace Automation business calendar.

List Business Calendars

Return one page of Dynatrace Automation business calendars.

List Direct Share Recipients

Return one page of users and groups assigned to a direct share.

List Direct Shares

Return one page of direct shares accessible to the connected user.

List Documents

Return one page of documents accessible to the connected user.

List Effective Settings Values

Return one page of effective values, including schema defaults.

List Entities

Return one page of monitored entities matching an entity selector.

List Entity Types

Return one page of entity types from the connected Dynatrace environment.

List Environment Share Claimers

Return one page of users who claimed an accessible environment share.

List Environment Shares

Return one page of environment shares accessible to the connected user.

List Event Properties

Return one page of event properties supported by the Dynatrace environment.

List Events

Return one page of events; the connected environment must expose the Environment API v2 endpoint.

List Event Types

Return one page of event types supported by the Dynatrace environment.

List Execution Actions

Return action identifiers assigned to tasks in a workflow execution.

List Executions

Return one filtered page of workflow executions and the offset for the next page.

List Holiday Calendar Countries

Return countries that can be used to retrieve a holiday calendar.

List Labels

Return one alphabetically sorted page of labels accessible to the connected user, optionally filtered by substring and document type.

List Metric Descriptors

Return one page of metric descriptors; the connected environment must expose the Environment API v2 endpoint.

List Problem Comments

Return one page of comments attached to a Dynatrace problem.

List Problems

Return one filtered page of Dynatrace problems and a continuation cursor.

List Schedule Timezones

Return timezone names accepted by Dynatrace schedules.

List Scheduling Rule History Records

Return the version history records for a Dynatrace scheduling rule.

List Scheduling Rules

Return one page of scheduling rules matching optional search and ordering criteria.

List Schema Definitions

List all settings schemas available to the connected Dynatrace user.

List Settings History

Return one page of revision history for Dynatrace settings objects.

List Settings Objects

Return one page of persisted settings objects for one schema and scope.

List Snapshots

Return one page of a document's snapshots in descending version order.

List Task Executions

Return the task executions keyed by task name for a workflow execution.

List Trashed Documents

Return one page of documents owned by the connected user that currently reside in Dynatrace trash.

List Trashed Workflows

Return one page of workflows that have been moved to trash.

List Webhook Handlers

Return webhook handlers for an installed Dynatrace app context.

List Workflow Actions

Return action identifiers assigned to tasks in a workflow.

List Workflow History Records

Return the version history records for a Dynatrace workflow.

List Workflows

Return one page of workflows matching optional filters.

List Workflow Tasks

Return the workflow's task map keyed by task name, preserving each task definition.

Parse Grail Query

Parse a Dynatrace Grail DQL query into its recursive syntax tree without executing it.

Patch Business Calendar

Modify selected fields on a Dynatrace Automation business calendar.

Patch Scheduling Rule

Partially update one scheduling rule.

Patch Workflow

Patch selected fields on an existing Dynatrace workflow.

Pause Execution

Pause an active workflow execution.

Permanently Delete Workflow

Permanently delete an active workflow without moving it to trash.

Poll Grail Query

Return the current state and available result for an asynchronous Grail DQL request token.

Query Metric Data Points

Return metric data points; the connected environment must expose the Environment API v2 endpoint.

Release Lock

Release the current user's lock on a document.

Remove Direct Share Recipients

Remove users or groups from an accessible Dynatrace direct share.

Reorder Settings Objects

Reorder objects in an ordered multi-object Dynatrace settings schema.

Reset Workflow Throttles

Clear the current throttle state for a Dynatrace workflow.

Resolve Effective Permissions

Resolve the connected user's effective settings permissions.

Restore Business Calendar History Record

Restore a historical version of a Dynatrace Automation business calendar.

Restore Scheduling Rule History Record

Restore a Dynatrace scheduling rule to a historical version.

Restore Snapshot

Reset a document to a selected snapshot without changing ownership or sharing.

Restore Trashed Document

Restore a Dynatrace document owned by the connected user from trash.

Restore Trashed Workflow

Restore a trashed workflow to the active workflow list.

Restore Workflow History Record

Restore a workflow to a selected historical version and deploy that restored version.

Resume Execution

Resume a paused workflow execution.

Run Workflow

Create an execution for a Dynatrace workflow, with optional idempotency qualifier and monitoring.

Set Document Favorite

Set whether an accessible Dynatrace document is a personal favorite for the connected user.

Set Document Visibility

Set a Dynatrace document's environment-wide visibility to public or private.

Summarize Settings Value

Generate display and search summaries for a Dynatrace multi-object settings value.

Transfer Document Owner

Transfer a document to a new owner.

Transfer Settings Object Ownership

Transfer a Dynatrace settings object to a user, group, or all users.

Trash Workflow

Move a workflow to trash so it can be restored later.

Update Business Calendar

Replace fields on a Dynatrace Automation business calendar.

Update Document

Update document metadata and/or binary content using optimistic locking, optionally creating a snapshot before the change.

Update Document Content

Completely replace a document's binary content using optimistic locking.

Update Problem Comment

Replace the content of one identified comment on an identified Dynatrace problem.

Update Scheduling Rule

Replace the mutable fields of one scheduling rule.

Update Settings Object

Update an existing Dynatrace settings object using optimistic locking.

Update Settings Object Accessor Permissions

Replace a user, group, or all-users accessor's permissions on a Dynatrace settings object.

Update Workflow

Replace fields on an existing Dynatrace workflow.

Upsert Custom Device

Create a custom device or update the device with the supplied customDeviceId.

Upsert Settings Object

Create a settings object or update the object matching its external ID.

Upsert Webhook Handler

Create or replace a webhook handler using an installed Dynatrace app as its context.

Validate Settings Container

Validate a settings container with a Dynatrace schema custom validator.

Validate Settings Object Delete

Validate deleting a settings object without applying the deletion.

Validate Settings Object Update

Validate a settings object update without applying it.

Validate Settings Object Upsert

Validate creating or updating a settings object without applying it.

Validate Settings Property

Validate one typed property value with a Dynatrace schema custom validator.

Verify Grail Query

Validate a DQL query without executing it and return semantic notifications.

FAQ

Frequently asked questions

With a standalone Dynatrace MCP server, the agents and LLMs can only access a fixed set of Dynatrace tools tied to that server. However, with the Composio Tool Router, agents can dynamically load tools from Dynatrace and many other apps based on the task at hand, all through a single MCP endpoint.

Yes, you can. Atomic Agent fully supports MCP integration. You get structured tool calling, message history handling, and model orchestration while Tool Router takes care of discovering and serving the right Dynatrace tools.

Yes, absolutely. You can configure which Dynatrace scopes and actions are allowed when connecting your account to Composio. You can also bring your own OAuth credentials or API configuration so you keep full control over what the agent can do.

All sensitive data such as tokens, keys, and configuration is fully encrypted at rest and in transit. Composio is SOC 2 Type 2 compliant and follows strict security practices so your Dynatrace data and credentials are handled as safely as possible.

Start with Dynatrace.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Dynatrace tool your agent needs.Free to start.

Start building