How laggyzee/genesys-mcp works
genesys-mcp is a local, read-only stdio MCP server for exploring and analyzing a Genesys Cloud contact-centre tenant. The principal workflow is an MCP client request routed by the server to a registered domain tool; the tool queries Genesys through the authenticated client and returns operational results such as queue, agent, conversation, or workforce reports. Separate branches cover coaching, quality, sentiment, repeat contacts/FCR, and workforce management. The source excerpts establish server registration and several shared helpers; unsampled tool internals are represented by README capabilities and SOURCE INDEX references, so uncertain call paths are omitted.
Main entry points: server.py stdio server · repeat_contacts.py Repeat contacts and FCR · reports.py Operational reports · client.py OAuth API client
Components 29
MCP interface
- stdio server
src/genesys_mcp/server.py
Operations analytics
- Queue and agent analytics
src/genesys_mcp/tools/analytics.py - Operational reports
src/genesys_mcp/tools/reports.py - Agent utilization
src/genesys_mcp/tools/utilization.py - Sentiment analysis
src/genesys_mcp/tools/sentiment.py - Coaching pack
src/genesys_mcp/tools/coaching.py - Quality reviews
src/genesys_mcp/tools/quality.py
Conversation insights
- Conversation search
src/genesys_mcp/tools/conversations.py - Attribute search
src/genesys_mcp/tools/attribute_search.py - Repeat contacts and FCR
src/genesys_mcp/tools/repeat_contacts.py - Speech analytics
src/genesys_mcp/tools/speech_analytics.py - Routing diagnostics
src/genesys_mcp/tools/routing.py
Workforce operations
- Presence analysis
src/genesys_mcp/tools/presence.py - Schedules and adherence
src/genesys_mcp/tools/wfm.py - Workforce history
src/genesys_mcp/tools/workforce_history.py - Time off
src/genesys_mcp/tools/timeoff.py
Shared runtime
- OAuth API client
src/genesys_mcp/client.py - Aggregate helpers
src/genesys_mcp/_aggregates.py - Archive availability
src/genesys_mcp/_availability.py - Conversation details
src/genesys_mcp/_conversation_details.py - Time intervals
src/genesys_mcp/_intervals.py - Tenant configuration
src/genesys_mcp/tenant.py - Name resolution
src/genesys_mcp/naming.py - Contact identity links
src/genesys_mcp/conversation_links.py - Soft-fail envelopes
src/genesys_mcp/_envelopes.py - Repeat report config
src/genesys_mcp/_repeat_contact_config.py - Repeat-contact cache
src/genesys_mcp/tools/repeat_contacts.py
Other components
- MCP client
- Genesys Cloud
Connections 43
- MCP client → stdio server: sends MCP requests
- stdio server → OAuth API client: initializes API
src/genesys_mcp/server.py - stdio server → Queue and agent analytics: registers tools
src/genesys_mcp/server.py - stdio server → Operational reports: registers tools
src/genesys_mcp/server.py - stdio server → Agent utilization: registers tools
src/genesys_mcp/server.py - stdio server → Sentiment analysis: registers tools
src/genesys_mcp/server.py - stdio server → Coaching pack: registers tools
src/genesys_mcp/server.py - stdio server → Quality reviews: registers tools
src/genesys_mcp/server.py - stdio server → Conversation search: registers tools
src/genesys_mcp/server.py - stdio server → Attribute search: registers tools
src/genesys_mcp/server.py - stdio server → Repeat contacts and FCR: registers tools
src/genesys_mcp/server.py - stdio server → Speech analytics: registers tools
src/genesys_mcp/server.py - stdio server → Routing diagnostics: registers tools
src/genesys_mcp/server.py - stdio server → Presence analysis: registers tools
src/genesys_mcp/server.py - stdio server → Schedules and adherence: registers tools
src/genesys_mcp/server.py - stdio server → Workforce history: registers tools
src/genesys_mcp/server.py - stdio server → Time off: registers tools
src/genesys_mcp/server.py - OAuth API client → Genesys Cloud: authenticates API calls
src/genesys_mcp/client.py - Queue and agent analytics → OAuth API client: uses API client
src/genesys_mcp/server.py - Operational reports → Aggregate helpers: uses helpers
src/genesys_mcp/tools/reports.py - Operational reports → Conversation details: uses detail data
src/genesys_mcp/tools/reports.py - Operational reports → Time intervals: uses intervals
src/genesys_mcp/tools/reports.py - Agent utilization → Aggregate helpers: uses helpers
src/genesys_mcp/tools/utilization.py - Agent utilization → Time intervals: uses intervals
src/genesys_mcp/tools/utilization.py - Sentiment analysis → Aggregate helpers: uses helpers
src/genesys_mcp/tools/sentiment.py - Sentiment analysis → Tenant configuration: reads tenant settings
src/genesys_mcp/tools/sentiment.py - Coaching pack → Aggregate helpers: uses helpers
src/genesys_mcp/tools/coaching.py - Coaching pack → Quality reviews: uses quality tools
src/genesys_mcp/tools/coaching.py - Coaching pack → Operational reports: uses report tools
src/genesys_mcp/tools/coaching.py - Conversation search → OAuth API client: uses API client
- Attribute search → Time intervals: uses intervals
src/genesys_mcp/tools/attribute_search.py - Repeat contacts and FCR → Conversation details: fetches details
src/genesys_mcp/tools/repeat_contacts.py - Repeat contacts and FCR → Time intervals: uses intervals
src/genesys_mcp/tools/repeat_contacts.py - Repeat contacts and FCR → Repeat report config: loads configuration
src/genesys_mcp/tools/repeat_contacts.py - Repeat contacts and FCR → Contact identity links: resolves identity
src/genesys_mcp/tools/repeat_contacts.py - Repeat contacts and FCR → Repeat-contact cache: caches day slices
src/genesys_mcp/tools/repeat_contacts.py - Speech analytics → Soft-fail envelopes: uses soft-fail shape
src/genesys_mcp/tools/speech_analytics.py - Routing diagnostics → Operational reports: uses report helpers
src/genesys_mcp/tools/routing.py - Presence analysis → Archive availability: uses availability
- Schedules and adherence → Time intervals: uses intervals
src/genesys_mcp/tools/wfm.py - Workforce history → OAuth API client: uses API client
src/genesys_mcp/tools/workforce_history.py - Time off → Time intervals: uses intervals
src/genesys_mcp/tools/timeoff.py - Name resolution → OAuth API client: fetches names
src/genesys_mcp/naming.py