cloud-infrastructureanalytics-data

Genesys Cloud▌

by makingchatbots

Genesys Cloud connects call center analytics and routing data for advanced contact center analytics, offering deep busin

Provides a bridge between contact center analytics and routing data in Genesys Cloud, enabling conversational business intelligence through queue searches, conversation volume queries, call sampling, and voice quality metrics analysis.

github stars

★ 21

GitHub Website npm

8+ specialized contact center toolsVoice quality and sentiment analysisConversation sampling and search

best for

/ Contact center managers analyzing performance
/ Quality assurance teams reviewing calls
/ Business analysts studying customer interactions
/ Operations teams monitoring queue volumes

capabilities

/ Search contact center queues by name
/ Query conversation volumes and queue metrics
/ Sample conversation IDs from specific queues
/ Analyze voice call quality metrics
/ Extract conversation sentiment and topics
/ Retrieve conversation transcripts

what it does

Connects to Genesys Cloud contact center platform to query analytics data, conversation metrics, and call quality information through conversational AI.

about

Genesys Cloud is a community-built MCP server published by makingchatbots that provides AI assistants with tools and capabilities via the Model Context Protocol. Genesys Cloud connects call center analytics and routing data for advanced contact center analytics, offering deep busin It is categorized under cloud infrastructure, analytics data.

how to install

You can install Genesys Cloud in your AI client of choice. Use the install panel on this page to get one-click setup for Cursor, Claude Desktop, VS Code, and other MCP-compatible clients. This server runs locally on your machine via the stdio transport.

license

MIT

Genesys Cloud is released under the MIT license. This is a permissive open-source license, meaning you can freely use, modify, and distribute the software.

readme

Genesys Cloud MCP Server

A Model Context Protocol (MCP) server for Genesys Cloud's Platform API.

Features

Tool	Description
Search Queues	Searches for queues by their name (supports wildcards)
Query Queue Volumes	Retrieves conversation volumes and member count by Queue IDs
Sample Conversations By Queue	Retrieves a representative sample of Conversation IDs for a Queue ID
Voice Call Quality	Retrieves voice call quality metrics for one or more conversations by ID
Conversation Sentiment	Retrieves the sentiment for one or more conversations by ID
Conversation Topics	Retrieves the topics for a conversation by ID
Search Voice Conversation	Searches voice conversations by optional criteria
Conversation Transcript	Retrieves conversation transcript
OAuth Clients	Retrieves a list of all the OAuth clients
OAuth Client Usage	Retrieves OAuth client usage for given period

Usage with Claude Desktop

MCP Bundle

This MCP Server provides an MCP Bundle (.mcpb file) along with each release, which is a single-click installable package for Claude Desktop. To use it:

Download the .mcpb file from the latest release
In Claude Desktop navigate to Settings > Extensions.
Open the .mcpb file with Claude
Configure the Region and OAuth Client for the extension

The extension will now be available in your conversations.

NPX

Add this to your claude_desktop_config.json:

{
  "mcpServers": {
    "genesys-cloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "<PUT REGION HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "<PUT OAUTHCLIENT ID HERE>",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "<PUT OAUTHCLIENT SECRET HERE>"
      }
    }
  }
}

Usage with Gemini CLI

Add below to your .gemini/settings.json file. You can read more about the setup from the official guide.

{
  "mcpServers": {
    "genesysCloud": {
      "command": "npx",
      "args": ["-y", "@makingchatbots/genesys-cloud-mcp-server"],
      "env": {
        "GENESYSCLOUD_REGION": "${GENESYSCLOUD_REGION}",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "${GENESYSCLOUD_OAUTHCLIENT_ID}",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "${GENESYSCLOUD_OAUTHCLIENT_SECRET}"
      }
    }
  }
}

Authentication

This currently only supports a stdio server. To configure authentication you'll need to:

Create an OAuth Client in Genesys Cloud
Assign the permissions to it for the tools you want to be used
Provide the following environment variables when referencing the server:
- GENESYSCLOUD_REGION
- GENESYSCLOUD_OAUTHCLIENT_ID
- GENESYSCLOUD_OAUTHCLIENT_SECRET

Development

Getting Started

nvm use
npm install
npm run dev

Under active development

This is part of personal project to create a conversational Business Insights tool. It is a practical way for me to learn MCP servers, and how best to represent Genesys Cloud's Platform APIs in a way that can be easily consumed by LLMs.

There will be a lot of changes, and I will be sure to share my learnings in my newsletter.