TsvetanG2/cognigy-ai-mcp-management-server

> Model Context Protocol server for managing Cognigy.AI virtual agents through the Management API
>
> This is an independent, open-source MCP server and is not affiliated with, endorsed by, or sponsored by Cognigy or NiCE. It requires your own valid Cognigy.AI account and API key, used in accordance with Cognigy's commercial license terms. "Cognigy" and "Cognigy.AI" are trademarks of their respective owners.
What is this?
**cognigy-ai-mcp-management-server** is a local MCP server that enables AI coding assistants (Claude, Cursor, etc.) to build, configure, test, and operate Cognigy.AI conversational AI agents programmatically.
Instead of clicking through the Cognigy UI, you can now:
- Create and manage flows, nodes, and intents via natural language
- Run NLU training and regression tests automatically
- Deploy snapshots and packages across environments
- Configure LLMs, Knowledge AI, and integrations
**Built for:** Developers, solution architects, and SI partners who build on Cognigy.AI.
Requirements
- **Node.js** 20.0.0 or higher
- **Cognigy.AI account** with API access (Trial, SaaS, or on-premises)
- **API Key** generated from Cognigy UI (My Profile → API Keys)
Installation
**Important:** The @cognigy/rest-api-client package is licensed under "Cognigy Proprietary License". By installing it, you agree to Cognigy's license terms.
Configuration
Set environment variables before running:
**Common Base URLs:**
| Environment | Base URL |
|-------------|----------|
| Trial | https://api-trial.cognigy.ai |
| SaaS EU | https://api-app.cognigy.ai |
| SaaS US | https://api-app-us.cognigy.ai |
| Dedicated | https://api- .cognigy.cloud |
MCP Client Configuration
Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):
Claude Code
Add to .mcp.json in your project root:
Cursor
Add to .cursor/mcp.json:
Available Tools
All Tools
This server provides **132 MCP tools** organized by domain:
| Category | Tools | Description |
|----------|-------|-------------|
| **Projects & Flows** | 5 | List projects, flows, flow settings, logs |
| **Nodes** | 9 | CRUD operations, search, move, AI output generation |
| **Intents & NLU** | 10 | Intent management, training, scoring, audit |
| **Endpoints** | 2 | List and inspect endpoint configurations |
| **Sessions** | 2 | Inject/reset conversation context |
| **Conversations** | 3 | Fetch conversations, transcripts |
| **Playbooks & Testing** | 6 | Run playbooks, regression tests |
| **Snapshots** | 9 | Create, restore, package, diff, promote |
| **Packages** | 7 | Create, merge, upload, download |
| **Connections** | 5 | Manage API connections (secrets redacted) |
| **LLMs** | 7 | Configure generative AI providers |
| **NLU Connectors** | 5 | External NLU (Dialogflow, LUIS, etc.) |
| **Knowledge AI** | 21 | Stores, sources, chunks, connectors (RAG) |
| **Functions** | 9 | Custom code functions, instances |
| **Extensions** | 6 | Upload, configure, manage extensions |
| **Contact Profiles** | 11 | Profile CRUD, merge, export (GDPR) |