Solutif Genesys Cloud MCP Server

Solutif's MCP server for Genesys Cloud Platform API operations and analytics.

Tools

| Tool | Description | |---|---| | create_queue | Creates a queue after checking for a duplicate name | | search_queues | Searches queues by name | | query_queue_volumes | Retrieves queue conversation volumes | | sample_conversations_by_queue | Samples conversations from a queue | | voice_call_quality | Retrieves voice quality metrics | | conversation_sentiment | Retrieves conversation sentiment | | conversation_topics | Retrieves conversation topics | | search_voice_conversations | Searches voice conversations | | conversation_transcript | Retrieves a conversation transcript | | oauth_clients | Lists OAuth clients | | oauth_client_usage | Retrieves OAuth client usage |

Local setup

npm install
npm run build

Configure your MCP client to run the local build:

{
  "mcpServers": {
    "solutif-genesys-cloud": {
      "command": "node",
      "args": ["/absolute/path/to/genesys-cloud-mcp-server/dist/index.js"],
      "env": {
        "GENESYSCLOUD_REGION": "<REGION>",
        "GENESYSCLOUD_OAUTHCLIENT_ID": "<OAUTH_CLIENT_ID>",
        "GENESYSCLOUD_OAUTHCLIENT_SECRET": "<OAUTH_CLIENT_SECRET>"
      }
    }
  }
}

The server is read-only by default. To expose create_queue, add:

"GENESYSCLOUD_ENABLE_QUEUE_CREATION": "true"

The OAuth client then needs routing:queue:add and routing:queue:view. Keep create_queue out of the MCP client's auto-approved tools so every write requires user approval.

MCP Bundle

npm run package:mcpb

Install the generated genesys-cloud-mcp-server.mcpb in Claude Desktop. Queue creation is disabled by default and can be enabled in the extension settings.

Development

npm run lint:check
npm run build
npm test -- --run

Based on the MIT-licensed MakingChatbots Genesys Cloud MCP Server.