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.