A Model Context Protocol (MCP) server for Genesys Cloud's Platform API.
Below are the tools this MPC server makes available. Alongside each tool are the Genesys Cloud endpoints used and the permissions your OAuth Client needs to use them.
| Tool | Permissions | APIs used |
|---|---|---|
| Search Queues | routing:queue:view |
GET /api/v2/routing/queues |
| Query Queue Volumes | analytics:conversationDetail:view |
POST /api/v2/analytics/conversations/details/jobsGET /api/v2/analytics/conversations/details/jobs/{jobId}GET /api/v2/analytics/conversations/details/jobs/{jobId}/results |
| Sample Conversations By Queue | analytics:conversationDetail:view |
POST /api/v2/analytics/conversations/details/jobsGET /api/v2/analytics/conversations/details/jobs/{jobId}GET /api/v2/analytics/conversations/details/jobs/{jobId}/results |
This currently only a supports 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
nvm use
npm install
npm run devThis is part of personal project to create a conversational Business Insights tool. It is a practical way for my 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.