MakingChatbots/genesys-cloud-mcp-server
If you are the rightful owner of genesys-cloud-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
A Model Context Protocol (MCP) server for Genesys Cloud's Platform API.
Genesys Cloud MCP Server
A Model Context Protocol (MCP) server for Genesys Cloud's Platform API.
Features
| Tool | Description |
|---|---|
| Searches for queues by their name (supports wildcards) | |
| Retrieves conversation volumes and member count by Queue IDs | |
| Retrieves a representative sample of Conversation IDs for a Queue ID | |
| Retrieves voice call quality metrics for one or more conversations by ID | |
| Retrieves the sentiment for one or more conversations by ID | |
| Retrieves the topics for a conversation by ID | |
| Searches voice conversations by optional criteria | |
| Retrieves conversation transcript |
Usage with Claude Desktop
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>"
}
}
}
}
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
.mcpbfile from the latest release - In Claude Desktop navigate to Settings > Extensions.
- Browse to, or drag in the .mcpb file downloaded
- Click "Install"
- Configure the Region and OAuth Client for the extension
The extension will now be available in your conversations.
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_REGIONGENESYSCLOUD_OAUTHCLIENT_IDGENESYSCLOUD_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.
