# mcp-server

Wires your coding agent to ConfigCat so it can read, create and edit feature flags through the Management API without leaving the editor.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 17
- Author: configcat
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/configcat/mcp-server
- Updated: 2026-10-22
- HTML: https://affpapa.org/en/nevibecode/mcp/configcat-mcp-server

## What it does

This server exposes ConfigCat's public Management API as tools. An agent can walk through products, configs and environments, then create, replace or delete feature flags and handle tags, segments, webhooks and organization members. Another tool group returns SDK docs and usage samples so the agent can wire the right ConfigCat SDK into your codebase.

It runs over stdio and starts with `npx`. Authentication is Basic Auth: `CONFIGCAT_API_USER` and `CONFIGCAT_API_PASS` carry the credentials from your ConfigCat account's public API settings. The host is set by `CONFIGCAT_BASE_URL`, which defaults to `https://api.configcat.com`.

Diagnostics tools cover audit logs, a report on stale flags and the organization's current usage against its quota. No credentials means no connection to the API, so set up Management API access first.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `CONFIGCAT_API_USER`, `CONFIGCAT_API_PASS`, `CONFIGCAT_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env CONFIGCAT_API_USER=<CONFIGCAT_API_USER> --env CONFIGCAT_API_PASS=<CONFIGCAT_API_PASS> --env CONFIGCAT_BASE_URL=<CONFIGCAT_BASE_URL> --transport stdio configcat-mcp-server -- npx -y @configcat/mcp-server
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add configcat-mcp-server --env CONFIGCAT_API_USER=<CONFIGCAT_API_USER> --env CONFIGCAT_API_PASS=<CONFIGCAT_API_PASS> --env CONFIGCAT_BASE_URL=<CONFIGCAT_BASE_URL> -- npx -y @configcat/mcp-server
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "configcat-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@configcat/mcp-server"
            ],
            "env": {
                "CONFIGCAT_API_USER": "<CONFIGCAT_API_USER>",
                "CONFIGCAT_API_PASS": "<CONFIGCAT_API_PASS>",
                "CONFIGCAT_BASE_URL": "<CONFIGCAT_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "configcat-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@configcat/mcp-server"
            ],
            "env": {
                "CONFIGCAT_API_USER": "<CONFIGCAT_API_USER>",
                "CONFIGCAT_API_PASS": "<CONFIGCAT_API_PASS>",
                "CONFIGCAT_BASE_URL": "<CONFIGCAT_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e CONFIGCAT_API_USER=<CONFIGCAT_API_USER> -e CONFIGCAT_API_PASS=<CONFIGCAT_API_PASS> -e CONFIGCAT_BASE_URL=<CONFIGCAT_BASE_URL> configcat-mcp-server npx -y @configcat/mcp-server
```
Replace <…> with your own values

## When to use it
- create a feature flag from inside the editor
- find flags nobody has touched in a while
- drop ConfigCat SDK examples into a project
- review a product's audit log
- check how much of the organization quota is left

## Example prompts
- List every product and config in ConfigCat
- Create a flag `new-checkout` in the main product's config
- Show me the stale flags report

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

## Other versions with the same name
- [mcp-server · heyputer](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — ★ 43872
- [mcp-server · mapbox](https://affpapa.org/en/nevibecode/mcp/mapbox-mcp-server.md) — ★ 363
- [mcp-server · packmindhub](https://affpapa.org/en/nevibecode/mcp/packmindhub-mcp-server.md) — ★ 319
- [mcp-server · bingowon](https://affpapa.org/en/nevibecode/mcp/bingowon-mcp-server.md) — ★ 121
- [mcp-server · ui5](https://affpapa.org/en/nevibecode/mcp/ui5-mcp-server.md) — ★ 104

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
