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