How outboundani/genesys-mcp works
genesys-mcp is a stateless MCP server that lets AI clients create and inspect Genesys Cloud resources. An authenticated client sends MCP tool requests to the Worker, which dispatches them into organization-management, Architect flow, outbound-cadence, or AVA capabilities; those actions use the Genesys Platform API. The AVA branch also supports knowledge authoring, chat, scripted testing, evaluation, and a server-side workspace. Setup pages and OAuth support access and configuration. The README documents capabilities beyond the sampled excerpts; edges are limited to documented relationships or references shown in the source index.
Main entry points: tools.js MCP tool dispatcher · ava-tools.js AVA lifecycle tools · index.js HTTP Worker · genesys.js Genesys API client
Components 18
Access and MCP
- HTTP Worker
src/index.js - OAuth and auth
src/oauth.js - Setup and landing UI
src/ui.js - Configuration
src/config.js
Tool dispatch and API
- MCP tool dispatcher
src/tools.js - Operator guidance
src/about.js - Genesys API client
src/genesys.js - API write rules
src/rules.js
Architect flows
- Flow authoring and rendering
src/flows.js
Outbound campaigns
- Outbound tools
src/tools.js - Cadence rendering
src/outbound.js
AVA lifecycle
- AVA lifecycle tools
src/ava-tools.js - AVA validation and evaluation
src/ava.js - Knowledge management
src/ava-knowledge.js - AVA playbooks
src/ava-playbooks.js - AVA workspace
src/ava.js
Other components
- AI client
- Genesys Cloud
Connections 20
- AI client → HTTP Worker: sends MCP requests
README.md - HTTP Worker → OAuth and auth: checks authorization
src/index.js - HTTP Worker → Setup and landing UI: serves setup pages
src/index.js - HTTP Worker → Configuration: loads configuration
src/index.js - HTTP Worker → MCP tool dispatcher: dispatches tool calls
src/index.js - MCP tool dispatcher → Operator guidance: exposes instructions
src/tools.js - MCP tool dispatcher → Genesys API client: calls API client
src/tools.js - MCP tool dispatcher → API write rules: applies write rules
src/tools.js - MCP tool dispatcher → Flow authoring and rendering: delegates flow work
src/tools.js - MCP tool dispatcher → Outbound tools: handles outbound tools
README.md - MCP tool dispatcher → AVA lifecycle tools: dispatches AVA tools
src/tools.js - Genesys API client → Genesys Cloud: makes Platform API calls
src/genesys.js - Outbound tools → Cadence rendering: renders cadence
src/tools.js - AVA lifecycle tools → AVA validation and evaluation: uses AVA helpers
src/ava-tools.js - AVA lifecycle tools → Knowledge management: uses knowledge tools
src/ava-tools.js - AVA lifecycle tools → AVA playbooks: serves playbooks
src/ava-tools.js - AVA lifecycle tools → AVA workspace: stores workspace data
src/ava-tools.js - AVA lifecycle tools → Genesys API client: performs AVA operations
src/ava-tools.js - Knowledge management → Genesys API client: manages Genesys knowledge
src/ava-knowledge.js - Flow authoring and rendering → Genesys API client: publishes flow jobs
README.md