Unleash Feature Flag MCP Server
About
An MCP server that enables AI agents to manage feature flags in the Unleash feature management system via the Unleash API. It is intended for developers and teams using AI assistants like Cursor or Claude to interact with Unleash programmatically.
Details
- Author
- ylin6
- GitHub stars
- 3
- Downloads
- 266
- Categories
- Other
Jump to
- Retrieves all projects from the Unleash instance.
- Lists all feature flags within a specific project.
- Creates new feature flags with type, name, and description.
- Updates existing feature flags (description and type).
- Retrieves details of a single feature flag by project and feature ID.
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Unleash Feature Flag MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
Install globally with npm install -g @ylin6/unleash-ff-mcp-server or run directly with npx @ylin6/unleash-ff-mcp-server. Configure environment variables UNLEASH_API_URL and UNLEASH_AUTH_TOKEN. For Cursor, use env UNLEASH_API_URL=XXXX UNLEASH_AUTH_TOKEN=XXX npx -y @ylin6/unleash-ff-mcp-server.
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"unleash feature flag mcp server": {
"unleash-ff-mcp-server": {
"command": "npx",
"args": [
"@ylin6/unleash-ff-mcp-server"
]
}
}
}
}McpServers
{
"unleash-ff-mcp-server": {
"command": "npx",
"args": [
"@ylin6/unleash-ff-mcp-server"
]
}
}Unleash Feature Flag MCP Server
This repository contains a Model Context Protocol (MCP) server for interacting with Unleash feature flag management system. It allows AI agents to manage feature flags through the Unleash API.
What is MCP?
The Model Context Protocol (MCP) is a specification for enabling AI models to interact with external tools and data sources. This server implements the MCP protocol for Unleash, allowing AI assistants to manage feature flags programmatically.
Installation
You can install the package from npm:
npm install -g @ylin6/unleash-ff-mcp-server
Or run it directly using npx:
npx @ylin6/unleash-ff-mcp-server
Configuration
The server requires the following environment variables:
- UNLEASH_API_URL: The URL of your Unleash API instance
- UNLEASH_AUTH_TOKEN: The authentication token for your Unleash instance
Available Tools
The MCP server provides the following tools for managing feature flags:
Get Projects
Retrieves a list of all projects in the Unleash instance.
Get Features
Retrieves all feature flags within a specific project.
Parameters:
- projectId: The ID of the project
Create Feature Flag
Creates a new feature flag within a project.
Parameters:
- projectId: The ID of the project
- name: The name of the feature flag
- description: A description of the feature flag
- type: The type of the feature flag (e.g., "release", "experiment", "operational", "kill-switch")
Update Feature Flag
Updates an existing feature flag.
Parameters:
- projectId: The ID of the project
- featureId: The ID of the feature flag
- description: A new description for the feature flag
- type: A new type for the feature flag
Get Feature Flag
Retrieves details about a specific feature flag.
Parameters:
- projectId: The ID of the project
- featureId: The ID of the feature flag
Using with Cursor
To use this MCP server with Cursor, use the following command in your cursor settings
env UNLEASH_API_URL=XXXX UNLEASH_AUTH_TOKEN=XXX npx -y @ylin6/unleash-ff-mcp-server
Examples
Example conversation with Cursor/Claude:
You: Show me all the feature flags in the 'dashboard' project
Claude: I'll fetch all the feature flags in the 'dashboard' project for you.
[Claude uses the getFeatures tool with projectId='dashboard']
Claude: Here are all the feature flags in the 'website' project:
- new-homepage (type: release)
- dark-mode (type: experiment)
- beta-footer (type: operational)
...
Development
To inspect the MCP server's operations, you can run:
npm run inspect
This uses the MCP inspector to analyze request/response patterns.
License
ISC
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
