Available MCP Server Tools

Review the MCP server tools available for reading cluster information, troubleshooting issues, managing certificates, applying licenses, and configuring the Virtual Appliance.

This topic lists the supported AI-assisted tools and their actions for the Virtual Appliance.

Read Kubernetes Cluster Information

Tool Action Access Permission
appdynamics_va_get_cluster_overview Obtain a customizable overview of the Kubernetes cluster such as nodes, pods, services, and deployments. Read-Only
appdynamics_va_get_k8s_nodes Obtain all nodes in the Kubernetes cluster. Read-Only
appdynamics_va_get_k8s_namespaces Obtain all namespaces with status, age, and labels. Read-Only
appdynamics_va_get_k8s_pods Group the pods by namespace, labels, or fields. Read-Only
appdynamics_va_get_k8s_services Obtain services with filter options. Read-Only
appdynamics_va_get_k8s_deployments Obtain deployments with filter options. Read-Only
appdynamics_va_get_k8s_statefulsets Obtain statefulsets with filter options. Read-Only
appdynamics_va_get_k8s_daemonsets Obtain daemonsets with filter options. Read-Only

Diagnose and Troubleshoot Issues

Tool Action Access Permissions
appdynamics_va_get_k8s_pod_logs Read the logs from a pod. Read-Only
appdynamics_va_get_k8s_events Read the cluster events. Read-Only
appdynamics_va_get_k8s_pod_events Read events from the given pod. Read-Only
appdynamics_va_get_k8s_problematic_pods Scan the cluster and detect pods having issues. It checks for crashes, restarts, and image pull errors. Read-Only
appdynamics_va_get_k8s_node_resources Obtain the node CPU, memory, and pod capacity/usage. Read-Only
appdynamics_va_get_k8s_pod_metrics Check the real-time CPU or memory usage of the pods. Read-Only

Check Virtual Appliance infrastructure and Application Services

Tool Action Access Permissions
appdynamics_va_infra_service_health Check the health of VA infrastructure services. Read-Only
appdynamics_va_application_service_health Check the health of VA application services Read-Only

Configure and Set up the Virtual Appliance

Tool Action Access Permissions
appdynamics_va_get_raw_config Obtain the raw content of globals.yaml.gotmpl Read-Only
appdynamics_va_update_hybrid_config Update the hybrid configuration programmatically. Read-Write
appdynamics_va_get_images Obtain all container images in the VA. Read-Only

Apply Licenses

Tool Action Access Permissions
appdynamics_va_apply_controller_license Apply a Controller license to the Virtual Appliance. Read-Write
appdynamics_va_apply_eum_license Apply an EUM license to the Virtual Appliance. Read-Write

Manage Certificates

Tool Action Access Permissions
appdynamics_va_list_user_certificates List self-signed SSL/TLS certificates with expiry details. Read-Only
appdynamics_va_list_k8s_certificates List certificates managed by a certificate manager cert-manager. Read-Only
appdynamics_va_apply_ingress_certificates Apply CA-signed ingress certificates. Read-Write

Test Network Connection

Tool Action Access Permissions
appdynamics_va_test_connectivity Test network connectivity from VA to external nodes (HTTP/HTTPS/TCP) Read-Only

Run the Bootstrap Job

Tool Action Access Permissions
appdynamics_va_run_bootstrap Run bootstrap job for the Standard and Hybrid deployments. Read-Write

MCP server tools

Review the tools available for application, end-user, analytics, infrastructure, cluster, and database monitoring.

The AppDynamics MCP Server provides read-oriented tools for querying AppDynamics monitoring data across the supported domains. Tool names and descriptions are listed below. Use the schemas returned by tools/list for the exact arguments and response contracts supported by the running server.

This page lists the supported AI-assisted tools and their actions on AppDynamics Application Performance Monitoring.

Application Monitoring Tools

Tool What it does
list_all_domain_applications Lists monitored application records across selected APM, EUM, Mobile, and DBMon domains.
list_apm_applications Lists APM applications or ranks them by traffic, error impact/rate, latency, or health for a window.
check_apm_application_exists Checks whether an exact APM application name exists.
get_apm_application_record Gets details for one APM application.
list_apm_tiers Lists tiers, IDs, agent types, and node counts.
list_apm_nodes Lists nodes for one application.
list_apm_business_transactions Lists business transactions for one application.
get_apm_application_performance_metrics Gets application traffic, latency, error, and slowness metrics for a window.
list_apm_metric_tree_children Returns one complete immediate metric-tree generation; accepts application_name and optional exact metric_path.
search_apm_metric_leaves Searches rolled-up metric-data leaves below one exact folder across depth 1-5.
query_apm_metric_series Queries up to 16 exact metric leaves in one aligned window.
get_apm_application_flowmap Builds a bounded metric-derived application topology.
list_apm_business_transaction_performance_summaries Returns compact fixed-metric aggregates for BT error/slowness ranking.
get_apm_business_transaction_flowmap Builds a bounded metric-derived path for one business transaction.
list_apm_business_transaction_detection_rules Returns the complete detection-rule configuration and rule_count for one application.
list_controller_custom_dashboards Lists custom dashboards.
get_controller_custom_dashboard_export Exports one custom-dashboard configuration by name.
list_controller_health_rule_definitions Lists health-rule definitions for an APM, EUM, DBMon, or SIM scope.
get_controller_health_rule_definition Gets one health-rule definition.
list_controller_health_rule_violations Lists health-rule violations for a supported scope.
get_controller_health_rule_violation Gets one health-rule violation and its evaluation history.
analyze_apm_transaction_snapshots Returns bounded sampled snapshots plus top-level request_guids and exact time_range.
analyze_apm_snapshot_hotspots Ranks method and literal-safe SQL hotspots from selected snapshots.
get_apm_snapshot_call_graph Returns a bounded compact call graph, or bounded raw diagnostic content for one segment.

End User Monitoring tools

Tool What it does
list_eum_applications Lists EUM applications, Controller IDs, and app keys.
list_eum_page_list Returns a local page of Browser RUM or Synthetic pages and their metrics.
list_mrum_applications Discovers Mobile container apps and platform-specific children.
classify_eum_web_rum_synthetic_degradation Classifies Browser RUM and Synthetic movement against aligned reference windows.
get_eum_page_apm_correlations Maps one Browser page to observed APM applications, tiers, and business transactions.
get_eum_web_page_metrics Gets metrics for one identified Browser RUM or Synthetic page.
get_eum_web_rum_synthetic_primary_metric_series Gets comparable Browser RUM versus Synthetic metric series.
list_eum_browser_journey_nodes Lists Browser journey nodes with parent relationships and drilldown hints.
list_eum_network_synced_domain_mappings Lists network-synced domains for an EUM app key.
query_eum_metrics Browses, queries, compares, or ranks Browser and Mobile metric paths.
query_eum_browser_record_geo_counts Gets Browser record counts by country, region, or city.
list_eum_synthetic_api_application_summaries Lists application-level Synthetic API availability, count, and duration summaries.
get_eum_synthetic_api_job_summary Gets availability, performance, and run/location evidence for Synthetic API jobs.
get_eum_synthetic_billable_usage Gets bounded account and per-job Synthetic billable usage.
get_eum_synthetic_locations Resolves Synthetic location codes and agent type.
get_eum_synthetic_web_job_metrics Gets Synthetic Web job trends and aggregate metrics.
get_eum_synthetic_api_session_summary Gets one Synthetic API session summary.
get_eum_synthetic_web_session_summary Gets one Synthetic Web run summary.
list_eum_synthetic_api_applications Returns a local page of Synthetic API applications.
list_eum_synthetic_api_jobs Returns a local page of Synthetic API schedules with configuration and full script content when present.
list_eum_synthetic_web_jobs Returns a local page of Synthetic Web jobs with configured URLs, navigation details, and full script content when present.
get_mrum_app_scorecard Gets a Mobile RUM platform-app health scorecard.
get_mrum_crash_groups Lists grouped Mobile crash signatures and affected dimensions.
get_mrum_crash_rate_breakdowns Breaks down Mobile crash rates by version or device.
get_mrum_dimension_performance Compares Mobile metrics across device, OS, app version, carrier, or connection type.
get_mrum_metric_trends Gets Mobile request, error, app-start, or network-time trends.
get_mrum_network_request_details Gets one Mobile request's timing/error and bounded APM ownership evidence.
list_mrum_user_journey_nodes Lists path-based Mobile journey nodes.
list_mrum_network_requests Returns the complete Controller Mobile request set and count for one application and window.

Analytics Events tools

Note: Provide your Events credentials to use the Analytics Events tools. Without these credentials, Analytics Events tools cannot function. See Analytics Events Settings.
Tool What it does
get_analytics_event_type_catalog Returns the static, non-exhaustive advisory catalog of candidate event types.
describe_analytics_event_fields Runs one bounded one-row query, discards field values, and returns inferred field names, types, and exact ADQL paths.
query_analytics_events Runs one caller-authored, read-only ADQL SELECT through the external Events Service.

General tools

Tool What it does
get_appdynamics_domain_guide Reads selected canonical guide topics without a Controller call.
search_controller_apm_entities Searches permission-visible APM applications, tiers, nodes, and business transactions by name.
query_controller_activity_events Queries bounded Controller activity events for selected entities.
get_controller_event Gets one Controller activity event.
list_anomaly_violations Lists bounded built-in anomaly occurrences.
get_anomaly_violation Gets one anomaly occurrence.
get_controller_anomaly_rca_evidence Gets bounded Controller RCA evidence for an eligible anomaly.
list_tag_management_tags Lists bounded Tag Management definitions and counts.
list_entities_for_tag Resolves one numeric Tag Management tag to bounded entities.
list_infrastructure_tag_values Discovers bounded SIM infrastructure-tag keys and values.
query_apm_metrics_by_infrastructure_tag Queries one APM tier KPI grouped by exact SIM infrastructure tags.
report_alerting_policies Reports current read-only Alert & Respond policy configuration.

Machine Agent tools

Tool What it does
list_sim_machines Lists bounded SIM hosts or containers; Kubernetes pods are excluded and use the Cluster workflow.
get_sim_machine Gets one machine or container record.
list_sim_machine_processes Lists CPU- or memory-ranked process classes.
resolve_sim_machine_by_host Resolves a host name or ID to one SIM machine.
list_sim_machine_apm_ownership_mappings Resolves one SIM entity to explicit APM ownership tuples.
list_sim_health_rule_violations Lists SIM health-rule incidents in one window.
query_sim_machines_health Summarizes health evaluation-state counts for selected machines.
query_sim_dynamic_metrics Discovers or queries dynamic SIM metrics; detail is limited to 8 series, 2,880 points, and 30 days.
query_sim_machine_metrics Queries curated built-in SIM metrics and comparisons; detail is limited to 8 series, 2,880 points, and 30 days.
assess_sim_hosts_for_apm_application Resolves bounded SIM hosts under one APM scope with aligned health/metrics and fallback coverage.
triage_sim_machine Gathers one bounded machine detail/health/metric/ownership bundle.

Cluster tools

Tool What it does
get_sim_kubernetes_cluster Gets one Kubernetes cluster by cluster-agent machine ID.
list_sim_kubernetes_cluster_containers Lists monitored containers for one cluster agent.
list_sim_kubernetes_cluster_pods Discovers bounded pods for one cluster ID.
get_sim_kubernetes_pod Gets one pod, its containers, cluster identity, and physical node.
list_sim_kubernetes_pod_cached_events Returns bounded cached Kubernetes events for one pod.
list_sim_kubernetes_pod_log_capture_metadata Returns log-capture metadata only, not log content.
assess_sim_kubernetes_cluster Gathers bounded cluster readiness/capacity, health, and problem-pod evidence.
triage_sim_kubernetes_pod Gathers bounded pod detail/event/metric/ownership/container/host evidence.

Database Visibility tools

Tool What it does
list_db_servers Lists or ranks DBMon databases; standalone rows emit server IDs while cluster aggregates emit configuration IDs.
get_db_server Gets one database-server identity and mapping record.
list_db_collectors Lists collector configuration and collection status.
get_db_collector Gets one safe collector configuration summary.
get_db_server_overview Gets headline KPIs, state, optional host metrics, and comparisons for one server.
get_db_cluster_overview Gets clustered DB KPIs, waits, topology, members, and optional baseline comparisons.
query_db_metrics Discovers or queries exact DBMon metric leaves, including Schema-family paths and comparisons.
get_db_wait_analysis Ranks cumulative waits and optional query/timeline evidence.
get_db_blocking_analysis Gets blocker sessions and bounded blocked children.
get_db_top_queries Ranks bounded top queries by elapsed time or executions.
get_db_query_details Gets bounded cross-engine detail for one query hash.
get_db_bt_activity Lists APM applications and business transactions driving one DB server.
get_db_queries_by_bt Resolves one APM business transaction to observed DB servers and query hashes.
get_db_servers_for_apm_application Resolves APM database backends to DBMon servers/configurations.
assess_db_query_participation_for_apm_application Builds a bounded application-wide DB query-participation overview.
list_db_query_apm_participation_correlations Resolves one DB query hash to window-scoped APM participation evidence.
get_db_mapped_sim_machine Maps one DB server to its SIM machine and permission state.
list_db_mapped_servers_for_sim Reverse-maps one SIM machine to DBMon servers.

Prompts and guides

Guided prompts

Prompts are instruction templates. Rendering a prompt does not call the Controller or Events service; later tool calls retain the boundaries in this guide.

Domain Prompts
APM apm_application_inventory, application_discovery, troubleshoot_slow_response, bt_onboarding_detection_analysis
EUM eum_triage_browser_slowness, eum_triage_synthetic_failure, eum_analyze_user_journey_coverage, eum_assess_network_contribution, eum_trace_page_to_apm
General events_assess_runtime_incident
SIM sim_triage_host_pressure, sim_trace_apm_to_infrastructure, sim_investigate_gpu_pressure
Cluster cluster_triage_workload_impact, cluster_trace_apm_to_kubernetes_runtime
DBMon dbmon_triage_database_impact, dbmon_explain_application_database_footprint, dbmon_trace_query_to_service_impact, dbmon_diagnose_lock_contention
Domain Prompt Description
APM apm_application_inventory Builds a detailed inventory of one APM application, including its configuration, dependencies, business transactions, health rules, dashboards, UI links, and key metrics.
APM application_discovery Discovers and classifies monitored applications across APM, Browser EUM, Mobile RUM, and Database Monitoring.
APM troubleshoot_slow_response Guides the diagnosis of slow responses through health violations, business transactions, flowmaps, snapshots, backends, nodes, and blast-radius analysis.
APM bt_onboarding_detection_analysis Assesses business-transaction detection, performance, topology, and health-rule coverage, and then recommends onboarding and naming improvements.
EUM eum_triage_browser_slowness Confirms a Browser RUM page slowdown, determines whether network, backend, or front-end behavior contributes to it, and routes backend cases to APM.
EUM eum_triage_synthetic_failure Identifies and classifies failing Web or API Synthetic monitors and examines the related job and session evidence.
EUM eum_analyze_user_journey_coverage Identifies Browser RUM journey drop-off and evaluates whether Synthetic Web coverage, cadence, agent type, and geography align with important user paths.
EUM eum_assess_network_contribution Assesses whether ThousandEyes-synced network degradation plausibly contributed to an application-wide Browser RUM slowdown.
EUM eum_trace_page_to_apm Traces a Browser RUM page to its observed APM application, business transaction, and tier, and then recommends an APM investigation based on the evidence.
General events_assess_runtime_incident Builds a bounded incident timeline across APM, EUM, Database Monitoring, SIM, and Kubernetes while distinguishing correlation from proven causation.
SIM sim_triage_host_pressure Resolves one host, compares its health and resource metrics, and inspects processes or APM ownership when relevant.
SIM sim_trace_apm_to_infrastructure Maps an APM application, tier, or node to its SIM hosts and examines the corresponding infrastructure health and resource metrics.
SIM sim_investigate_gpu_pressure Investigates GPU or AI-host pressure by using built-in and discovered GPU metrics, interval comparisons, and APM ownership correlation.
Kubernetes cluster_triage_workload_impact Triages a Kubernetes pod or workload by using lifecycle events, pod, container, and host metrics, verified APM ownership, and optional APM snapshots.
Kubernetes cluster_trace_apm_to_kubernetes_runtime Maps an APM application or tier to its bounded Kubernetes runtime footprint, including clusters, pods, containers, and physical hosts.
Database Monitoring dbmon_triage_database_impact Triages database impact from a database, APM application, or business transaction by using KPIs, baselines, waits, queries, and corresponding application evidence.
Database Monitoring dbmon_explain_application_database_footprint Maps an APM application to its database servers or clusters, active business transactions, important queries, and selected database health evidence.
Database Monitoring dbmon_trace_query_to_service_impact Traces a database query to snapshot-correlated APM applications, business transactions, tiers, and nodes, and then examines the corresponding service impact.
Database Monitoring dbmon_diagnose_lock_contention Diagnoses database lock contention by using wait evidence, blocker trees, query details, and direct query-level APM correlation.

For multi-step work, read appd://guide/<domain> first; if a client cannot read MCP resources, use get_appdynamics_domain_guide.