Tools and prompts

Review how to discover MCP tool schemas, use guided prompts, and access domain guides.

Tool argument schemas, and response schemas where declared, are published through tools/list. Use the schema shown by the running server rather than guessing identifiers or arguments.

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.

Domain guides

Domain guides are available at the following URIs.

Domain Resource URI
APM appd://guide/apm
EUM appd://guide/eum
Analytics Events appd://guide/events
General appd://guide/general
SIM appd://guide/sim
Cluster appd://guide/cluster
DBMon appd://guide/dbmon