mcp-server · configcat — Claude Code MCP server: ConfigCat flags in your editor
Wires your coding agent to ConfigCat so it can read, create and edit feature flags through the Management API without leaving the editor.
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-serverWhat mcp-server 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.
What it helps with
- 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 for the agent
- List every product and config in ConfigCat
- Create a flag
new-checkoutin the main product's config - Show me the stale flags report
How to install mcp-server
Platform CLI
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-serverReplace <…> with your own values
Platform CLI
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-serverReplace <…> with your own values
Config file
{
"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
Config file
{
"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
Platform CLI
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-serverReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about mcp-server
How do I install mcp-server in Claude Code?
Run claude mcp add mcp-server -e CONFIGCAT_API_USER=<CONFIGCAT_API_USER> -e CONFIGCAT_API_PASS=<CONFIGCAT_API_PASS> -- npx -y @configcat/mcp-server. Put your Management API username and password in place of the placeholders.
What does mcp-server do?
It gives an agent tools for ConfigCat's Management API: feature flags, configs, environments, segments, webhooks and members, plus SDK documentation.
What do I need before it will work?
Basic Auth credentials for the public Management API, passed as CONFIGCAT_API_USER and CONFIGCAT_API_PASS. You can point CONFIGCAT_BASE_URL at another host if needed.
Similar MCP servers
All MCP servers for Agent setup: memory, context, orchestration →mcp-server by other authors comes first.
