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.
Genesys Cloud MCP Server
@MakingChatbots
Basic information
About Genesys Cloud MCP Server
Model Context Protocol (MCP) server for Genesys Cloud’s Platform API
#genesys-cloud#mcp-server
Genesys Cloud MCP Server 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>"
}
}
}
}Genesys Cloud MCP Server 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
Frequently asked questions
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.
More Other MCP servers
Health by Dr Brad
Dr Brad StanfieldHealth by Dr Brad works out a health plan from your own results: which screening is due at your age, and evidence-based suggestions, each with the reason and the published guideline or study behind it. Your record is one
The Living Bread
The Living BreadA free remote MCP server for The Living Bread. Bible passages read word for word from a stored public domain text with an evidence label, keyword search and cross references, real churches, gatherings and prayer groups w
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
Screenpipe
screenpipeYC (S26) | Open Computer History | Continuously record your company computer work, map your workflows, help you find work worth automating, and power your agents' context
22.0K
ICSS
chokcoco不止于 CSS
20.7K
Comments