mcpField
G
Genesys Cloud MCP Server

Genesys Cloud MCP Server

Local
makingchatbots.comCommunication36Updated 30w ago
RepositoryVisit website

About Genesys Cloud MCP Server

The Genesys Cloud MCP Server exposes Genesys Cloud Platform API data to MCP clients over stdio. It targets users who want to analyse contact centre queues, conversations and voice call quality through natural language. The project is under active development and its tools may change.

Key features

  1. 01Search queues by name with wildcards
  2. 02Query conversation volumes and member counts per queue
  3. 03Retrieve voice call quality metrics
  4. 04Retrieve conversation sentiment and topics
  5. 05Retrieve conversation transcripts
  6. 06List OAuth clients and their usage

Use cases

  1. 01Reviewing queue conversation volumes in a chat session
  2. 02Analysing sentiment and topics across voice conversations
  3. 03Pulling transcripts to support contact centre quality review

MCP support

This project is an MCP server that exposes several tools over stdio, which call the Genesys Cloud Platform API on behalf of MCP clients.

#genesys-cloud#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "genesys-cloud": {
      "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>"
      }
    }
  }
}
Run commandnpx -y @makingchatbots/genesys-cloud-mcp-server
Environment variables to set
GENESYSCLOUD_REGION
GENESYSCLOUD_OAUTHCLIENT_IDSecret
GENESYSCLOUD_OAUTHCLIENT_SECRETSecret

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@makingchatbots/genesys-cloud-mcp-server

Tools

10

Saved tool list · updated 3w ago

ParameterTypeRequiredDescription
namestringYesThe name (or partial name) of the routing queue(s) to search for. Wildcards ('*') are supported for pattern matching (e.g., 'Support*', '*Emergency', '*Sales*'). Use '*' alone to retrieve all queues
pageNumberintegerNoThe page number of the results to retrieve, starting from 1. Defaults to 1 if not specified. Used with 'pageSize' for navigating large result sets
pageSizeintegerNoThe maximum number of queues to return per page. Defaults to 100 if not specified. Used with 'pageNumber' for pagination. The maximum value is 500

Details

From the project README

Genesys Cloud MCP Server

npm Follow me on LinkedIn for updates

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

Features

ToolDescription
Search QueuesSearches for queues by their name (supports wildcards)
Query Queue VolumesRetrieves conversation volumes and member count by Queue IDs
Sample Conversations By QueueRetrieves a representative sample of Conversation IDs for a Queue ID
Voice Call QualityRetrieves voice call quality metrics for one or more conversations by ID
Conversation SentimentRetrieves the sentiment for one or more conversations by ID
Conversation TopicsRetrieves the topics for a conversation by ID
Search Voice ConversationSearches voice conversations by optional criteria
Conversation TranscriptRetrieves conversation transcript
OAuth ClientsRetrieves a list of all the OAuth clients
OAuth Client UsageRetrieves 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:

  1. Download the .mcpb file from the latest release
  2. In Claude Desktop navigate to Settings > Extensions.
  3. Open the .mcpb file with Claude
  4. 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:

  1. Create an OAuth Client in Genesys Cloud
  2. Assign the permissions to it for the tools you want to be used
  3. 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.

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.