About Genesys Cloud MCP Server
Genesys Cloud MCP Server is an MCP server in the Cloud category: solutif's Model Context Protocol server for Genesys Cloud.
Recent commit activity is the strongest signal that reported issues will get attention.
Install
claude mcp add genesys-cloud-mcp-server -- npx -y @solutif/genesys-cloud-mcp-servernpx -y @solutif/genesys-cloud-mcp-serverThis server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.
Ask AI
Ask AI about Genesys Cloud MCP Server
Powered by Claude · Grounded in docs
Security checks
- ✓README presentThe repository ships documentation.
5 checks have not been run yet.
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
.mcpbfile 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_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.
README copy captured when this server was indexed; it may lag the repository. The original is authoritative.