Genesys Cloud MCP Server
@MakingChatbots
About Genesys Cloud MCP Server
Model Context Protocol (MCP) server for Genesys Cloud’s Platform API
Config
Add this server to your MCP-compatible client using the configuration below.
{
"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>"
}
}
}
}Tools
10Searches for routing queues based on their name, allowing for wildcard searches. Returns a paginated list of matching queues, including their Name, ID, Description (if available), and Member Count (if available). Also provides pagination details like current page, page size, total results found, and total pages available. Useful for finding specific queue IDs, checking queue configurations, or listing available queues.
Retrieves conversation analytics for a specific queue between two dates, returning a representative sample of conversation IDs. Useful for reporting, investigation, or summarisation.
Returns a breakdown of how many conversations occurred in each specified queue between two dates. Useful for comparing workload across queues. MAX 300 queue IDs.
Retrieves voice call quality metrics for one or more conversations by ID. This tool specifically focuses on voice interactions and returns the minimum Mean Opinion Score (MOS) observed in each conversation as structured JSON. MOS is a measure of perceived audio quality based on factors such as jitter, latency, packet loss, and codec. Use the following legend to interpret MOS values: • Poor: MOS < 3.5 • Acceptable: 3.5 ≤ MOS < 4.3 • Excellent: MOS ≥ 4.3
Retrieves sentiment analysis scores for one or more conversations. Sentiment is evaluated based on customer phrases, categorized as positive, neutral, or negative. The result includes both a numeric sentiment score (-100 to 100) and an interpreted sentiment label.
Retrieves Speech and Text Analytics topics detected for a specific conversation. Topics represent business-level intents (e.g. cancellation, billing enquiry) inferred from recognised phrases in the customer-agent interaction.
Searches for voice conversations within a specified time window, optionally filtering by phone number. Returns a paginated list of conversation IDs and call duration for use in further analysis or tool calls.
Retrieves a structured transcript of the conversation, including speaker labels, utterance timestamps, and sentiment annotations where available. The transcript is formatted as a time-aligned list of utterances attributed to each participant (e.g., customer or agent)
Retrieves a list of all OAuth clients, including their associated roles and divisions. This tool is useful for auditing and managing OAuth clients in the Genesys Cloud organization.
Retrieves the usage of an OAuth Client for a given period. It returns the total number of requests and a breakdown of Platform API endpoints used by the client.
Overview
What is Genesys Cloud MCP Server?
An MCP server that exposes Genesys Cloud Platform API tools to AI assistants like Claude Desktop and Gemini CLI. It is a personal project under active development for conversational Business Insights.
How to use Genesys Cloud MCP Server?
Install via the provided MCP bundle (.mcpb file) or via NPX by configuring GENESYSCLOUD_REGION, GENESYSCLOUD_OAUTHCLIENT_ID, and GENESYSCLOUD_OAUTHCLIENT_SECRET environment variables. The server runs over stdio.
Key features of Genesys Cloud MCP Server
- Search queues by name with wildcard support
- Query conversation volumes and member counts
- Sample conversation IDs for a queue
- Retrieve voice call quality metrics
- Get conversation sentiment scores
- Fetch conversation transcripts
Use cases of Genesys Cloud MCP Server
- Analyze voice call quality across conversations
- Monitor queue volumes and member counts
- Retrieve conversation transcripts for review
- Assess sentiment and topics in customer interactions
- Manage and audit OAuth client usage
FAQ from Genesys Cloud MCP Server
What authentication does the server require?
You must create an OAuth Client in Genesys Cloud, assign needed permissions, and provide its ID, secret, and region as environment variables.
How do I install the server?
Download the .mcpb file from the latest release and open it with Claude Desktop, or add the NPX command to your claude_desktop_config.json or Gemini settings.json.
What transport does it support?
Currently only stdio transport is supported.
Is this server production-ready?
No, it is a personal project under active development and may change frequently.
What runtime environment is needed?
Node.js is required to run via NPX; no additional dependencies are noted.
Frequently asked questions
What authentication does the server require?
You must create an OAuth Client in Genesys Cloud, assign needed permissions, and provide its ID, secret, and region as environment variables.
How do I install the server?
Download the `.mcpb` file from the latest release and open it with Claude Desktop, or add the NPX command to your `claude_desktop_config.json` or Gemini `settings.json`.
What transport does it support?
Currently only stdio transport is supported.
Is this server production-ready?
No, it is a personal project under active development and may change frequently.
What runtime environment is needed?
Node.js is required to run via NPX; no additional dependencies are noted.
Basic information
More Other MCP servers
AutoBrowser MCP
autobrowser-aiBrowser MCP is a Model Context Provider (MCP) server that allows AI applications to control your browser

DeepMark
DeepMark helps teachers deliver rapid, consistent marking with meaningful feedback for every student — in a fraction of the time. What once took a week, now takes one free period.
Reactive Resume
amruthpillaiA one-of-a-kind resume builder that keeps your privacy in mind. Completely secure, customizable, portable, open-source and free forever. Try it out today!
FastMCP v2 🚀
jlowin🚀 The fast, Pythonic way to build MCP servers and clients.

YOUB
Connect your AI assistant to your own YOUB endurance training account. Read recorded activities with full analysis, planned sessions, race goals, wellness (HRV, sleep, resting HR) and your athletic profile. Create or mov
Comments