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
Add this to your claude_desktop_config.json:
NPX
{
"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>"
}
}
}
}
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.
