GC-MCP-Claude

JonathanNolanDC/GC-MCP-Claude

3.1

If you are the rightful owner of GC-MCP-Claude and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.

The Genesys Cloud MCP Server is a Model Context Protocol server designed to interface with Genesys Cloud's Platform API, providing tools and features for enhanced conversational insights.

Tools
8
Resources
0
Prompts
0

Genesys Cloud MCP Server

npm Follow me on LinkedIn for updates

A Model Context Protocol (MCP) server for Genesys Cloud's Platform API.

Features

ToolDescription
Searches for queues by their name (supports wildcards)
Retrieves conversation volumes and member count by Queue IDs
Retrieves a representative sample of Conversation IDs for a Queue ID
Retrieves voice call quality metrics for one or more conversations by ID
Retrieves the sentiment for one or more conversations by ID
Retrieves the topics for a conversation by ID
Searches voice conversations by optional criteria
Retrieves conversation transcript

Usage with Claude Desktop

Desktop Extension

This MCP Server provides a Desktop Extension (.dxt file) along with each release, which is a single-click installable packages for Claude Desktop. To use it:

  1. Download the .dxt file from the latest release
  2. In Claude Desktop navigate to Settings > Extensions.
  3. Browse or drag in the .dxt file downloaded
  4. Click "Install"
  5. Configure the Region and OAuth Client for the extension

The extension will now be available in your conversations.

NPX

Add this to your claude_desktop_config.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

nvm use
npm install
npm run dev

Under active development

This is part of personal project 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.