mcp

This MCP server exposes ConfigCat's public management API via the MCP interface, enabling you to manage feature flags, configs, environments, products, and related entities directly from your editor or IDE. The server provides a comprehensive set of tools to Create, Read, Update, and Delete items such as organizations, members, permission groups, products, configs, environments, segments, SDK keys, webhooks, integrations, code references, and feature flag metadata. It also includes provisions to fetch documentation and code examples for integrating ConfigCat SDKs into your projects. To use it, connect through your preferred client (Cursor, VS Code, Claude Desktop, etc.) by pointing at the MCP server and authenticating with your ConfigCat Management API credentials. You can then browse entities, run operations, and view results through the provided command surface. The environment variables CONFIGCAT_API_USER and CONFIGCAT_API_PASS must be set to your ConfigCat public management API credentials, with CONFIGCAT_BASE_URL typically defaulting to https://api.configcat.com. The server is designed for management operations; for evaluating feature flag values in production, use the ConfigCat SDKs or Proxy as recommended in the docs.

Prerequisites:

• Node.js (recommended LTS) and npm or yarn installed on your machine
• Access to ConfigCat public management API credentials (CONFIGCAT_API_USER and CONFIGCAT_API_PASS)

Installation steps:

1. Ensure Node.js and npm are installed

   • node -v
   • npm -v

2. Run the MCP server using npx (no local install required) or install the package locally:

   • Quick start (no install): npx -y @configcat/mcp-server

   • If you prefer a local install: npm install -g @configcat/mcp-server mcp-server

3. Configure environment variables (preferred via your MCP client):

   • CONFIGCAT_API_USER: your ConfigCat Management API username
   • CONFIGCAT_API_PASS: your ConfigCat Management API password
   • CONFIGCAT_BASE_URL: (optional) API base URL, defaults to https://api.configcat.com

4. In your MCP client, reference the server as:

   • command: npx args: ["-y", "@configcat/mcp-server"] env: { "CONFIGCAT_API_USER": "YOUR_API_USER", "CONFIGCAT_API_PASS": "YOUR_API_PASSWORD", "CONFIGCAT_BASE_URL": "https://api.configcat.com" }

Tips and common considerations:

• Always keep API credentials secure. Use environment variables provided by your MCP client instead of embedding secrets in configuration files.
• The server respects ConfigCat API rate limits; if you hit limits, you may see appropriate error messages from the API layer.
• This MCP server is intended for management operations only. Do not rely on it for evaluating feature flag values in production; use ConfigCat SDKs or the Proxy for runtime value resolution.
• If you need to customize the base URL (e.g., for a private instance or different region), set CONFIGCAT_BASE_URL accordingly.
• When using VS Code or Claude Desktop integrations, ensure the runtime environment has network access to the ConfigCat API endpoints.
• Consult the Available Tools list in the README to discover the full set of management operations supported (Organizations, Members, Permissions, Products, Configs, Environments, Segments, Webhooks, Integrations, Code References, Feature Flags and Settings, Tags, and values-related tools).