# dynatrace-oss/dynatrace-managed-mcp architecture

> Architecture diagram of the GitHub repository dynatrace-oss/dynatrace-managed-mcp, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/dynatrace-oss/dynatrace-managed-mcp
- Repository: https://github.com/dynatrace-oss/dynatrace-managed-mcp

## Overview

Dynatrace Managed MCP Server exposes observability tools to AI assistants, querying one or more Managed environments and returning formatted results. The main path is assistant request → MCP server tool registration/dispatch → domain tool → capability API client → authenticated Dynatrace API. Configuration and authentication support environment selection and connection validation; local stdio and remote HTTP/SSE are documented modes. The source index and excerpts establish most module relationships; unsampled implementation details are omitted where call paths cannot be verified.

Main entry points: [`src/authentication/managed-auth-client.ts`](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/authentication/managed-auth-client.ts) (Managed auth), [`src/tools/index.ts`](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/index.ts) (Tool registration), [`src/tools/context.ts`](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/context.ts) (Tool context), [`src/tools/limits.ts`](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/limits.ts) (Tool limits)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_entry["MCP entry"]
  node_server["MCP server<br/>[index.ts]"]
  node_registration["Tool registration<br/>[index.ts]"]
  node_context["Tool context<br/>[context.ts]"]
  node_server_instructions["Server guidance"]
end

subgraph group_tools["Tool domains"]
  node_environment_tools["Environment tools"]
  node_metrics_tools["Metrics tools<br/>[metrics-tools.ts]"]
  node_logs_tools["Logs tools<br/>[logs-tools.ts]"]
  node_events_tools["Events tools<br/>[events-tools.ts]"]
  node_entities_tools["Entities tools<br/>[entities-tools.ts]"]
  node_problems_tools["Problems tools<br/>[problems-tools.ts]"]
  node_security_tools["Security tools<br/>[security-tools.ts]"]
  node_slo_tools["SLO tools<br/>[slo-tools.ts]"]
end

subgraph group_capabilities["Dynatrace capabilities"]
  node_metrics_api["Metrics API<br/>[metrics-api.ts]"]
  node_logs_api["Logs API<br/>[logs-api.ts]"]
  node_events_api["Events API<br/>[events-api.ts]"]
  node_entities_api["Entities API<br/>[entities-api.ts]"]
  node_problems_api["Problems API<br/>[problems-api.ts]"]
  node_security_api["Security API<br/>[security-api.ts]"]
  node_slo_api["SLO API<br/>[slo-api.ts]"]
end

subgraph group_runtime["Configuration and auth"]
  node_environment_config["Environment config<br/>[environment.ts]"]
  node_config_loader["Config file loader<br/>[config-loader.ts]"]
  node_auth["Managed auth"]
  node_api_scopes["API scopes"]
end

subgraph group_support["Shared utilities"]
  node_limits["Tool limits<br/>[limits.ts]"]
  node_logger["Logging<br/>[logger.ts]"]
  node_date_formatter["Date formatting<br/>[date-formatter.ts]"]
end

node_assistant(("AI assistant"))
node_managed["Managed environments"]

node_assistant -->|"sends MCP requests"| node_server
node_server -->|"registers tools"| node_registration
node_registration -->|"registers"| node_environment_tools
node_registration -->|"registers"| node_metrics_tools
node_registration -->|"registers"| node_logs_tools
node_registration -->|"registers"| node_events_tools
node_registration -->|"registers"| node_entities_tools
node_registration -->|"registers"| node_problems_tools
node_registration -->|"registers"| node_security_tools
node_registration -->|"registers"| node_slo_tools
node_metrics_tools -->|"calls"| node_metrics_api
node_logs_tools -->|"calls"| node_logs_api
node_events_tools -->|"calls"| node_events_api
node_entities_tools -->|"calls"| node_entities_api
node_problems_tools -->|"calls"| node_problems_api
node_security_tools -->|"calls"| node_security_api
node_slo_tools -->|"calls"| node_slo_api
node_environment_tools -->|"uses"| node_auth
node_metrics_api -->|"requests through"| node_auth
node_logs_api -->|"requests through"| node_auth
node_events_api -->|"requests through"| node_auth
node_entities_api -->|"requests through"| node_auth
node_problems_api -->|"requests through"| node_auth
node_security_api -->|"requests through"| node_auth
node_slo_api -->|"requests through"| node_auth
node_auth -->|"calls APIs"| node_managed
node_server -->|"loads settings"| node_environment_config
node_environment_config -->|"loads file config"| node_config_loader
node_auth -->|"uses scopes"| node_api_scopes
node_auth -->|"uses environment config"| node_environment_config
node_context -->|"provides dependency"| node_auth
node_context -->|"provides dependency"| node_metrics_api
node_context -->|"provides dependency"| node_logs_api
node_context -->|"provides dependency"| node_events_api
node_context -->|"provides dependency"| node_entities_api
node_context -->|"provides dependency"| node_problems_api
node_context -->|"provides dependency"| node_security_api
node_context -->|"provides dependency"| node_slo_api
node_metrics_tools -->|"validates limits"| node_limits
node_logs_tools -->|"validates limits"| node_limits
node_entities_tools -->|"validates limits"| node_limits
node_events_tools -->|"validates limits"| node_limits
node_problems_tools -->|"validates limits"| node_limits
node_security_tools -->|"validates limits"| node_limits
node_slo_tools -->|"validates limits"| node_limits
node_server -->|"uses guidance"| node_server_instructions

click node_server "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/index.ts"
click node_registration "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/index.ts"
click node_context "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/context.ts"
click node_environment_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/environment-tools.ts"
click node_metrics_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/metrics-tools.ts"
click node_logs_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/logs-tools.ts"
click node_events_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/events-tools.ts"
click node_entities_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/entities-tools.ts"
click node_problems_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/problems-tools.ts"
click node_security_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/security-tools.ts"
click node_slo_tools "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/slo-tools.ts"
click node_metrics_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/metrics-api.ts"
click node_logs_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/logs-api.ts"
click node_events_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/events-api.ts"
click node_entities_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/entities-api.ts"
click node_problems_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/problems-api.ts"
click node_security_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/security-api.ts"
click node_slo_api "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/slo-api.ts"
click node_environment_config "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/environment.ts"
click node_config_loader "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/config-loader.ts"
click node_auth "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/authentication/managed-auth-client.ts"
click node_api_scopes "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/authentication/managed-api-scopes.ts"
click node_limits "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/limits.ts"
click node_logger "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/logger.ts"
click node_date_formatter "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/date-formatter.ts"
click node_server_instructions "https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/server-instructions.ts"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_server,node_registration,node_context,node_server_instructions toneBlue
class node_environment_tools,node_metrics_tools,node_logs_tools,node_events_tools,node_entities_tools,node_problems_tools,node_security_tools,node_slo_tools toneAmber
class node_metrics_api,node_logs_api,node_events_api,node_entities_api,node_problems_api,node_security_api,node_slo_api toneMint
class node_environment_config,node_config_loader,node_auth,node_api_scopes toneRose
class node_limits,node_logger,node_date_formatter,node_assistant,node_managed toneIndigo
```

## Components

### MCP entry

- [MCP server](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/index.ts): `src/index.ts`
- [Tool registration](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/index.ts): `src/tools/index.ts`
- [Tool context](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/context.ts): `src/tools/context.ts`
- [Server guidance](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/server-instructions.ts): `src/server-instructions.ts`

### Tool domains

- [Environment tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/environment-tools.ts): `src/tools/environment-tools.ts`
- [Metrics tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/metrics-tools.ts): `src/tools/metrics-tools.ts`
- [Logs tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/logs-tools.ts): `src/tools/logs-tools.ts`
- [Events tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/events-tools.ts): `src/tools/events-tools.ts`
- [Entities tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/entities-tools.ts): `src/tools/entities-tools.ts`
- [Problems tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/problems-tools.ts): `src/tools/problems-tools.ts`
- [Security tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/security-tools.ts): `src/tools/security-tools.ts`
- [SLO tools](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/slo-tools.ts): `src/tools/slo-tools.ts`

### Dynatrace capabilities

- [Metrics API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/metrics-api.ts): `src/capabilities/metrics-api.ts`
- [Logs API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/logs-api.ts): `src/capabilities/logs-api.ts`
- [Events API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/events-api.ts): `src/capabilities/events-api.ts`
- [Entities API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/entities-api.ts): `src/capabilities/entities-api.ts`
- [Problems API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/problems-api.ts): `src/capabilities/problems-api.ts`
- [Security API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/security-api.ts): `src/capabilities/security-api.ts`
- [SLO API](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/capabilities/slo-api.ts): `src/capabilities/slo-api.ts`

### Configuration and auth

- [Environment config](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/environment.ts): `src/utils/environment.ts`
- [Config file loader](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/config-loader.ts): `src/utils/config-loader.ts`
- [Managed auth](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/authentication/managed-auth-client.ts): `src/authentication/managed-auth-client.ts`
- [API scopes](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/authentication/managed-api-scopes.ts): `src/authentication/managed-api-scopes.ts`

### Shared utilities

- [Tool limits](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/tools/limits.ts): `src/tools/limits.ts`
- [Logging](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/logger.ts): `src/utils/logger.ts`
- [Date formatting](https://github.com/dynatrace-oss/dynatrace-managed-mcp/blob/main/src/utils/date-formatter.ts): `src/utils/date-formatter.ts`

### Other components

- **AI assistant**
- **Managed environments**

## Connections

- AI assistant → MCP server: sends MCP requests (evidence: `README.md`)
- MCP server → Tool registration: registers tools (evidence: `src/index.ts`)
- Tool registration → Environment tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → Metrics tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → Logs tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → Events tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → Entities tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → Problems tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → Security tools: registers (evidence: `src/tools/index.ts`)
- Tool registration → SLO tools: registers (evidence: `src/tools/index.ts`)
- Metrics tools → Metrics API: calls (evidence: `src/tools/metrics-tools.ts`)
- Logs tools → Logs API: calls (evidence: `src/tools/logs-tools.ts`)
- Events tools → Events API: calls (evidence: `src/tools/events-tools.ts`)
- Entities tools → Entities API: calls (evidence: `src/tools/entities-tools.ts`)
- Problems tools → Problems API: calls (evidence: `src/tools/problems-tools.ts`)
- Security tools → Security API: calls (evidence: `src/tools/security-tools.ts`)
- SLO tools → SLO API: calls (evidence: `src/tools/slo-tools.ts`)
- Environment tools → Managed auth: uses (evidence: `src/tools/environment-tools.ts`)
- Metrics API → Managed auth: requests through (evidence: `src/capabilities/metrics-api.ts`)
- Logs API → Managed auth: requests through (evidence: `src/capabilities/logs-api.ts`)
- Events API → Managed auth: requests through (evidence: `src/capabilities/events-api.ts`)
- Entities API → Managed auth: requests through (evidence: `src/capabilities/entities-api.ts`)
- Problems API → Managed auth: requests through (evidence: `src/capabilities/problems-api.ts`)
- Security API → Managed auth: requests through (evidence: `src/capabilities/security-api.ts`)
- SLO API → Managed auth: requests through (evidence: `src/capabilities/slo-api.ts`)
- Managed auth → Managed environments: calls APIs (evidence: `src/authentication/managed-auth-client.ts`)
- MCP server → Environment config: loads settings (evidence: `src/index.ts`)
- Environment config → Config file loader: loads file config (evidence: `src/utils/environment.ts`)
- Managed auth → API scopes: uses scopes (evidence: `src/authentication/managed-auth-client.ts`)
- Managed auth → Environment config: uses environment config (evidence: `src/authentication/managed-auth-client.ts`)
- Tool context → Managed auth: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → Metrics API: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → Logs API: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → Events API: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → Entities API: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → Problems API: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → Security API: provides dependency (evidence: `src/tools/context.ts`)
- Tool context → SLO API: provides dependency (evidence: `src/tools/context.ts`)
- Metrics tools → Tool limits: validates limits (evidence: `src/tools/metrics-tools.ts`)
- Logs tools → Tool limits: validates limits (evidence: `src/tools/logs-tools.ts`)
- Entities tools → Tool limits: validates limits (evidence: `src/tools/entities-tools.ts`)
- Events tools → Tool limits: validates limits (evidence: `src/tools/events-tools.ts`)
- Problems tools → Tool limits: validates limits (evidence: `src/tools/problems-tools.ts`)
- Security tools → Tool limits: validates limits (evidence: `src/tools/security-tools.ts`)
- SLO tools → Tool limits: validates limits (evidence: `src/tools/slo-tools.ts`)
- MCP server → Server guidance: uses guidance (evidence: `src/index.ts`)
