Apdex MCP Server ¶
Introduction ¶
The Apdex MCP Server exposes the capabilities of Apdex to any MCP-compatible AI host. Through this server, AI assistants can query incidents and changes, run impact assessments, drill into IA/RCA analysis, look up site and organization metadata, and answer Apdex knowledge questions — all using natural language.
Apdex is the experience-monitoring platform that measures user-perceived performance of core features across services, components, shards, and data centers, and correlates degradations with incidents and changes.
What You Can Do with Apdex MCP ¶
| Capability | Example Prompt |
|---|---|
| Query incidents | "List Apdex incidents between last Monday and today" |
| Query changes | "Show changes for the Webex Meetings NGAPP component this week" |
| Run impact assessment | "Assess the impact on core feature Access Webex URL in the last hour" |
| Get IA/RCA summary | "Summarize the RCA for MEETINGS NGAPP ACCESS-WEBEX-URL on shard KS" |
| Get detailed IA/RCA data | "Show the detailed IA RCA data for frustrated users on shard KS" |
| Look up site info | "What are the details for site IDs 9612082 and 303790?" |
| Look up org display names | "Resolve the display names for these org IDs" |
| Ask Apdex definitions | "What's the Apdex definition of JMS-MAC?" |
| Ask Apdex knowledge | "What is Apdex and how do I create one?" |
| Check Apdex alerts / dips | "Any abnormal core feature Apdex dips right now?" |
| Inspect release radar toggles | "Show feature toggle changes in the last hour" |
Installation ¶
Add the Apdex MCP endpoint to your client using the standard AIOE URL pattern:
https://aiops-mcp.webex.com/apdex/mcp/
See the MCP overview for full client configuration examples (VS Code, Windsurf, Codex).
Available Tools ¶
Once installed, the following tools are exposed to the AI host:
Incident & Change Tools ¶
| Tool name | Description |
|---|---|
query_incidents_info | Query incidents from Apdex by time range, search key, sort order, and pagination |
query_changes_info | Query changes from Apdex by time range, search key, service, component, feature, data center, shard, and pagination |
Impact Assessment Tools ¶
| Tool name | Description |
|---|---|
query_impact_assessment | Query Apdex impact assessment for core features over a time range, optionally filtered by data center and shard |
IA / RCA Tools ¶
| Tool name | Description |
|---|---|
query_ia_rca_summary | Query the Apdex IA/RCA summary for a service, component, feature, and shard over a time range |
query_ia_rca | Query detailed Apdex IA/RCA data for a service, component, feature, and shard over a time range |
Lookup Tools ¶
| Tool name | Description |
|---|---|
query_site_infos | Query site information by a list of site IDs |
query_org_display_names | Query organization display names by a list of org IDs |
Apdex Knowledge Tools ¶
| Tool name | Description |
|---|---|
apdex_definition_tool | Get the Apdex definition/criteria for a given feature |
apdex_knowledge_tool | Answer basic Apdex knowledge questions (what/how/where) |
apdex_alert_tool | Get Apdex alert/abnormal/unusual/dip information, in particular for core features |
Release Radar Tools ¶
| Tool name | Description |
|---|---|
radar_toggle_tool | Get feature toggle change history from Release Radar over a time range |
Authorization ¶
Apdex MCP authenticates through the AIOE MCP gateway using standard MCP OAuth discovery. Request access via the appropriate MyID group as described in the MCP overview.
Troubleshooting ¶
401 Unauthorized — Confirm you have completed the MCP OAuth sign-in and belong to the required MyID access group.
Connection refused — Confirm https://aiops-mcp.webex.com/apdex/mcp/ is reachable from your machine. Check VPN or firewall rules.
No tools available in VS Code — Ensure the MCP extension is enabled and the server entry in mcp.json has no JSON syntax errors.