genesys-cloud

This MCP server provides a set of Genesys Cloud related tools that expose Genesys Cloud Platform API data through MCP-compatible endpoints. The server offers utilities such as searching queues, querying queue volumes, sampling conversations by queue, and retrieving metrics like voice call quality and sentiment for conversations. It also includes capabilities to fetch conversation topics, transcripts, OAuth clients and their usage. These tools enable large language models or automation workflows to query Genesys Cloud data in a structured MCP format and receive consistent responses.

To use the server, run it with the appropriate environment variables for your Genesys Cloud region and OAuth client credentials. Once running, you can invoke the available tools via MCP protocol clients (e.g., Claude Desktop via an MCP bundle or Gemini CLI). The NPX example shown in the README demonstrates launching the server inline with your package name, which avoids a separate installation step. Be sure to supply REGION, OAUTHCLIENT_ID, and OAUTHCLIENT_SECRET so the server can authenticate with Genesys Cloud and fetch data for your configured region.

Prerequisites:

• Node.js and npm installed on your machine
• Access to Genesys Cloud and a configured OAuth client with the required permissions for the desired tools

Install and run using NPX (no permanent install required):

# Ensure you have Node.js/npm installed
npx -y @makingchatbots/genesys-cloud-mcp-server

If you prefer a permanent install, you can install the package locally or globally and then run the server via npm script or node command:

# Local project installation
mkdir my-mcp && cd my-mcp
npm init -y
npm install @makingchatbots/genesys-cloud-mcp-server

# Example run (adjust path if needed)
npx --yes @makingchatbots/genesys-cloud-mcp-server

Configure environment variables either in your shell or in your MCP client config as shown in the README (GENESYSCLOUD_REGION, GENESYSCLOUD_OAUTHCLIENT_ID, GENESYSCLOUD_OAUTHCLIENT_SECRET).

Notes: This server currently supports a stdio-based MCP setup. Ensure your OAuth client in Genesys Cloud has permissions for the tools you intend to use. When embedding in Claude Desktop or Gemini CLI, provide the necessary environment variables in your MCP configuration. If you encounter authentication errors, double-check that the OAuth client is active for the region you specified and that the credentials have not expired. You can customize the server behavior by adjusting the environment variables in your MCP config and by using the available tools as documented in the project's docs.