Getting StartedAI in WebexSupport
Log inSign up
Home
AI in Webex
  • AI in Webex Overview
  • What's New
  • Beta Program Overview

AI in Webex

Contact Center Operation MCP Server

anchorWhat is Contact Center Operation MCP Server?

anchor

The Webex Contact Center Operation MCP Server brings Webex Contact Center operational data and configuration into AI assistants, so teams can investigate live operations using natural language instead of manually stitching together reports, configuration screens, flow exports, recordings, and AI Agent data.

It is designed for contact center teams that need faster, evidence-based answers to operational questions:

  • Why did a customer reach a specific queue?
  • Which queues are driving transfers, consults, or conferences?
  • What happened before a call reached an agent?
  • Which flows, queues, skills, or agents are involved in a routing issue?
  • How are AI Agents and Virtual Agents performing?
  • Which contacts have summaries, transcripts, recordings, or AI insights?

The value is not just access to data. The value is context. The MCP server gives the assistant structured access to Webex Contact Center for reporting, agent activity, configuration, routing, flow definitions, contact journeys, recordings, and AI data so it can reason from tenant-grounded evidence rather than guess.

This helps supervisors, administrators, analysts, support teams, and solution engineers reduce investigation time, validate routing behavior, understand customer journeys, and explain contact center outcomes more clearly.

Prerequisites: This MCP server must be enabled by your organization's admin in Webex Control Hub before it can be used.

Server URL: Log in to view the server URL.

anchorTools

anchor

25 tools covering reporting, configuration, flows, routing, contact journey, recordings, and AI Agent and Virtual Agent data:

Reporting & Search (5)
ToolDescription
wxcc-operations-describe-metricsDiscovers supported Agent Report metrics and Contact Report measures, dimensions, filters, formulas, enums, and limits.
wxcc-operations-generate-reportGenerates historical contact, queue, and leg analytics from Contact Session Record and Contact Leg Record data.
wxcc-operations-generate-agent-reportGenerates historical agent reporting from Agent Session Record and Agent Activity Record data.
wxcc-operations-run-search-queryRuns a raw GraphQL query against the Webex Contact Center Search API and returns rows or aggregations.
wxcc-operations-validate-schemaValidates the reporting catalog against the tenant's live Search API schema.
Configuration (4)
ToolDescription
wxcc-operations-describe-orgDescribes tenant-level Contact Center configuration using authoritative totals and bounded samples.
wxcc-operations-list-configLists supported configuration resources with authoritative totals, bounded rows, and explicit coverage.
wxcc-operations-get-config-objectRetrieves a supported configuration object by ID with bounded, status-aware enrichment.
wxcc-operations-get-configuration-referencesLists bounded incoming references to a supported configuration object.
Flows (2)
ToolDescription
wxcc-operations-list-flowsLists configured Flow Designer flows and the entry points bound to each flow.
wxcc-operations-export-flowExports a read-only flow definition for inspecting activities, integrations, variables, and routing logic.
Routing & Staffing (3)
ToolDescription
wxcc-operations-explain-queue-routingExplains a queue's routing model, skill requirements and sources, agent coverage, and routing dependencies.
wxcc-operations-get-agent-activityRetrieves one agent's state history or latest per-channel state within a bounded window.
wxcc-operations-get-agents-by-skillFinds agents configured with a skill through their assigned skill profiles.
Contacts & Recordings (3)
ToolDescription
wxcc-operations-get-contact-timelineReconstructs one contact's lifecycle or recorded flow milestones from its Contact Activity Record.
wxcc-operations-get-contact-summariesRetrieves Cisco AI Assistant-generated contact summaries where available.
wxcc-operations-list-recordingsLists call, screen recording, and transcript metadata for contacts without retrieving media.
AI & Virtual Agents (8)
ToolDescription
wxcc-operations-get-ai-featuresShows the tenant's Cisco AI Assistant feature configuration and scope.
wxcc-operations-list-ai-agentsCounts, lists, searches, or summarizes AI Agents configured in AI Agent Studio.
wxcc-operations-audit-ai-agentRuns a bounded configuration, exact-session, or recent-sample audit of one AI Agent.
wxcc-operations-list-ai-agent-sessionsCounts, lists, or summarizes a bounded session population for one AI Agent.
wxcc-operations-get-ai-agent-sessionRetrieves metadata for exactly one AI Agent session.
wxcc-operations-get-ai-agent-session-messagesCounts or retrieves bounded messages and observed tool activity for one AI Agent session.
wxcc-operations-get-va-summaryRetrieves the AI-generated Virtual Agent handoff or reconnect summary for one contact.
wxcc-operations-get-va-transcriptRetrieves the Virtual Agent transcript for one contact. Requires appropriate scope and entitlement because it can expose conversation content.

anchorConnect to your MCP Client

anchor

Select your AI client to get connection instructions:

  • Amazon Quick
  • Claude Code
  • Claude Desktop
  • Codex
  • Copilot Studio
  • Cursor
  • Gemini CLI
  • VS Code

anchorAuthentication

anchor

Auth Type: OAuth 2.0 Bearer Token

Issuer: https://idbroker.webex.com

Flow: The MCP client obtains a Webex OAuth token and passes it via the Authorization: Bearer <token> header. The server validates organization access and forwards the token to Webex Contact Center APIs on behalf of the authenticated user.

anchorScopes

anchor

4 OAuth scopes required:

ScopeDescription
spark:mcpRequired to connect through the Webex MCP server platform.
cjp:config_readRead access to Webex Contact Center configuration and reporting-related APIs.
spark:people_readRead access to Webex identity information used for organization and agent resolution.
cjp:userRequired for selected Virtual Agent insight APIs, including VA transcript and VA summary access.

Full scope string:

spark:mcp cjp:config_read spark:people_read cjp:user
In This Article
  • What is Contact Center Operation MCP Server?
  • Tools
  • Connect to your MCP Client
  • Authentication
  • Scopes

Connect

Support

Developer Community

Developer Events

Contact Sales

Handy Links

Webex Ambassadors

Webex App Hub

Resources

Open Source Bot Starter Kits

Download Webex

DevNet Learning Labs

Terms of Service

Privacy Policy

Cookie Policy

Trademarks

© 2026 Cisco and/or its affiliates. All rights reserved.