How do I install Cognigy Ai MCP Management Server?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Cognigy Ai MCP Management Server need an API key?

The publisher lists these environment variables: COGNIGY_BASE_URL, COGNIGY_API_KEY.

What transport does Cognigy Ai MCP Management Server use?

Cognigy Ai MCP Management Server runs locally over stdio.

When was Cognigy Ai MCP Management Server last checked?

Last checked 2026-11-09. MCP server for Cognigy.AI - 132 tools to build, configure & operate conversational AI agents

Cognigy Ai MCP Management MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y [email protected]

Credentials from the publisher

COGNIGY_BASE_URL — Cognigy API base URL (e.g., https://api-trial.cognigy.ai)
COGNIGY_API_KEY — Your Cognigy API key (from My Profile → API Keys)

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1COGNIGY_BASE_URL=<value> COGNIGY_API_KEY=<secret> claude mcp add io.github.tsvetang2-cognigy-ai-mcp-management-server -- npx -y cognigy-ai-mcp-management-server@0.2.1

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "io.github.tsvetang2-cognigy-ai-mcp-management-server": {4      "command": "npx",5      "args": [6        "-y",7        "[email protected]"8      ],9      "env": {10        "COGNIGY_BASE_URL": "<value>",11        "COGNIGY_API_KEY": "<secret>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.2.1

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Cognigy.AI Management MCP 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

# 1. Install the Cognigy REST API client (required peer dependency)
npm install @cognigy/rest-api-client

# 2. Install this MCP server
npm install -g cognigy-ai-mcp-management-server

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:

# Required: Your Cognigy API endpoint
export COGNIGY_BASE_URL=https://api-trial.cognigy.ai

# Required: Your API key (never commit this!)
export COGNIGY_API_KEY=your-api-key-here

# Optional: Default project for operations
export COGNIGY_DEFAULT_PROJECT_ID=your-project-id

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-<company>.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):

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Add to .mcp.json in your project root:

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "cognigy": {
      "command": "npx",
      "args": ["cognigy-ai-mcp-management-server"],
      "env": {
        "COGNIGY_BASE_URL": "https://api-trial.cognigy.ai",
        "COGNIGY_API_KEY": "your-api-key-here"
      }
    }
  }
}

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)
Analytics	4	Conversation, call, knowledge metrics
Audit	2	Audit event logs
Handover	7	Live agent providers and services

Key Features

Safe by default: All mutating tools use dryRun: true by default
Async-aware: Long-running operations poll until completion
Security: API keys only in memory, secrets automatically redacted
Pagination: All list operations support limit and skip

Development & Testing

Live API Testing

# Create .env from template
cp .env.example .env
# Edit .env with your credentials

# Run development server
npm run dev

Build

npm run build    # Compile TypeScript
npm test         # Run test suite (49 tests)
npm run lint     # Check code style

Regenerate Types (optional)

If you need to update the generated types from a newer Cognigy API:

npm run update:spec   # Download latest OpenAPI spec
npm run gen:types     # Regenerate TypeScript types

Important: Dependencies

This package requires @cognigy/rest-api-client as a peer dependency. This means:

You must install it separately (see Installation above)
You accept Cognigy's license terms by installing their package
We do not bundle or redistribute any Cognigy code

You are responsible for:

Reviewing and accepting Cognigy's proprietary license terms
Having appropriate rights to use the Cognigy API
Keeping your API credentials secure

The Cognigy REST API client is the official SDK maintained by Cognigy GmbH and is published on npm under "Cognigy Proprietary License".

License

This MCP server is released under the MIT License. See LICENSE for details.

Note: The MIT license applies only to this MCP server code. Dependencies (particularly @cognigy/rest-api-client) are subject to their own licenses.

Contributing

Contributions are welcome! Please:

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Follow existing code patterns (Zod schemas, dryRun flags, etc.)
Add tests for new tools
Run npm test && npm run build before committing
Submit a Pull Request

Development Guidelines

All tools must have Zod input validation
Mutating tools must support dryRun flag (default: true)
Tool descriptions should be LLM-friendly (1-2 sentences)
Never log or expose API keys/secrets
Test against mock server before live API

Support

Issues: GitHub Issues
Cognigy Docs: docs.cognigy.com
MCP Spec: modelcontextprotocol.io

Built with Model Context Protocol SDK

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Cognigy Ai MCP Management Server?

Does Cognigy Ai MCP Management Server need an API key?

What transport does Cognigy Ai MCP Management Server use?

When was Cognigy Ai MCP Management Server last checked?

Documentation

Cognigy.AI Management MCP Server

What is this?

Requirements

Installation

Configuration

MCP Client Configuration

Claude Desktop

Claude Code

Cursor

Available Tools

Key Features

Development & Testing

Live API Testing

Build

Regenerate Types (optional)

Important: Dependencies

License

Contributing

Development Guidelines

Support