Genesys Cloud MCP Server

A Model Context Protocol (MCP) server that provides read-only access to Genesys Cloud contact center data. It enables AI agents to query agents, queues, conversations, analytics, evaluations, and IVR flows through a standardized tool interface.

Features

• 27 read-only MCP tools across 8 domains (users, routing, conversations, analytics, quality, organization, architect, workforce management)
• OAuth2 client credentials authentication
• Stateless HTTP streaming transport
• Multi-region support (17 Genesys Cloud regions)
• Docker and Kubernetes ready

Quick Start

Prerequisites

• Go 1.26.1+
• A Genesys Cloud OAuth2 client credential grant (client ID and secret)

Build

go mod download
CGO_ENABLED=0 go build -ldflags="-w -s" -o server ./cmd/server

Run

export GENESYS_CLIENT_ID=your_client_id
export GENESYS_CLIENT_SECRET=your_client_secret
export GENESYS_REGION=us-east-1
./server

The MCP endpoint is available at http://localhost:8080/mcp and a health check at http://localhost:8080/healthz.

Docker

docker build -t genesys-mcp-server .

docker run -e GENESYS_CLIENT_ID=<id> \
           -e GENESYS_CLIENT_SECRET=<secret> \
           -e GENESYS_REGION=us-east-1 \
           -p 8080:8080 \
           genesys-mcp-server

Configuration

Variable	Required	Default	Description
GENESYS_CLIENT_ID	Yes		OAuth2 client ID
GENESYS_CLIENT_SECRET	Yes		OAuth2 client secret
GENESYS_REGION	Yes		Deployment region (see below)
LISTEN_ADDR	No	:8080	HTTP listen address

Supported Regions

us-east-1, us-east-2, us-west-2, ca-central-1, sa-east-1, eu-central-1, eu-central-2, eu-west-1, eu-west-2, ap-south-1, ap-northeast-1, ap-northeast-2, ap-northeast-3, ap-southeast-1, ap-southeast-2, me-central-1, mx-central-1

Tools

Users

Tool	Description
get_user	Get a user by ID with optional expanded fields (presence, routing status, etc.)
list_users	List users with pagination and state filtering
search_users	Search users by name, email, department, or title
get_user_presence	Get current presence status of a user
get_user_queues	Get routing queues a user belongs to

Routing

Tool	Description
get_queue	Get a routing queue by ID
list_queues	List queues with optional name filter
get_queue_members	Get agents assigned to a queue
get_queue_estimated_wait_time	Get estimated wait time for a queue
list_wrapup_codes	List wrap-up codes

Conversations

Tool	Description
get_conversation	Get an active conversation by ID
get_conversations	List active conversations, optionally filtered by type
get_analytics_conversation_details	Get rich analytics for a conversation

Analytics

Tool	Description
query_conversation_aggregates	Aggregate conversation metrics over time intervals
query_user_aggregates	Aggregate user/agent metrics (routing status, presence)
query_conversation_details	Query historical conversation details with filters

Quality

Tool	Description
get_quality_agents_activity	Agent evaluation activity summary
list_evaluations	List quality evaluations with filters
get_conversation_evaluation	Get a specific evaluation for a conversation

Organization

Tool	Description
list_groups	List organizational groups
get_group_members	Get members of a group
list_presence_definitions	List presence definitions (available, busy, away, etc.)

Architect

Tool	Description
list_flows	List Architect flows (IVR, workflows, bots)
get_flow	Get a flow by ID
list_datatables	List Architect data tables

Workforce Manag

... View full README on GitHub