What is Unleash Ff Mcp Server

Unleash-ff-mcp-server is a Model Context Protocol (MCP) server designed for managing feature flags within the Unleash feature flag management system. It enables AI agents to programmatically interact with feature flags using the Unleash API.

Use cases

Use cases include managing feature flags in web applications, enabling/disabling features based on user feedback, and conducting experiments to evaluate new functionalities.

How to use

To use unleash-ff-mcp-server, install it via npm with ‘npm install -g @ylin6/unleash-ff-mcp-server’ or run it directly using ‘npx @ylin6/unleash-ff-mcp-server’. Configure the server by setting the environment variables ‘UNLEASH_API_URL’ and ‘UNLEASH_AUTH_TOKEN’.

Key features

Key features include retrieving project lists, managing feature flags (create, update, get), and integration with AI tools like Cursor for seamless interaction with feature flags.

Where to use

Unleash-ff-mcp-server is suitable for software development teams that utilize feature flags for feature management, A/B testing, and operational control in various applications.

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