@makingchatbots/genesys-cloud-mcp-server
Version:
A Model Context Protocol (MCP) server exposing Genesys Cloud tools for LLMs, including sentiment analysis, conversation search, topic detection and more.
71 lines (53 loc) • 3.56 kB
Markdown
# Genesys Cloud MCP Server
[](https://www.npmjs.com/package/@makingchatbots/genesys-cloud-mcp-server)
[](https://www.linkedin.com/in/lucas-woodward-the-dev/)
A Model Context Protocol (MCP) server for Genesys Cloud's Platform API.
## Features
| Tool | Description |
| ----------------------------------------------------------------------------- | ------------------------------------------------------------------------ |
| [Search Queues](/docs/tools.md#search-queues) | Searches for queues by their name (supports wildcards) |
| [Query Queue Volumes](/docs/tools.md#query-queue-volumes) | Retrieves conversation volumes and member count by Queue IDs |
| [Sample Conversations By Queue](/docs/tools.md#sample-conversations-by-queue) | Retrieves a representative sample of Conversation IDs for a Queue ID |
| [Voice Call Quality](/docs/tools.md#voice-call-quality) | Retrieves voice call quality metrics for one or more conversations by ID |
| [Conversation Sentiment](/docs/tools.md#conversation-sentiment) | Retrieves the sentiment for one or more conversations by ID |
| [Conversation Topics](/docs/tools.md#conversation-topics) | Retrieves the topics for a conversation by ID |
| [Search Voice Conversation](/docs/tools.md#search-voice-conversations) | Searches voice conversations by optional criteria |
| [Conversation Transcript](/docs/tools.md#conversation-transcript) | Retrieves conversation transcript |
## Usage with Claude Desktop
Add this to your `claude_desktop_config.json`:
### NPX
```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>"
}
}
}
}
```
## 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
```bash
nvm use
npm install
npm run dev
```
## Under active development
This is part of [personal project](https://www.linkedin.com/posts/lucas-woodward-the-dev_genesys-genesyscloud-vertexai-activity-7321306518908280833-cWt8?utm_source=share&utm_medium=member_desktop&rcm=ACoAABsbo2wBcmnNqxYJ5UO9BrsfURZcVEtgLOU)
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](https://makingchatbots.com/).