mcpField
U
Unleash Feature Flag MCP Server

Unleash Feature Flag MCP Server

Local
github.com/ylin6Developer Tools3Updated 86w ago
Repository

About Unleash Feature Flag MCP Server

An MCP server for managing feature flags through the Unleash API, suited to teams maintaining project flags programmatically. It supports project and flag retrieval, as well as flag creation and updates.

Key features

  1. 01List Unleash projects
  2. 02View flags within a project
  3. 03Create feature flags
  4. 04Update flag descriptions and types
  5. 05Retrieve an individual flag

Use cases

  1. 01Review projects in an Unleash instance
  2. 02Inspect flags for a specific project
  3. 03Create a release or experiment flag
  4. 04Change an existing flag's description or type

MCP support

The server provides MCP clients with tools to retrieve Unleash projects and manage feature flags. Configuration requires the Unleash API URL and an authentication token.

#unleash#feature-flag#mcp-server

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "unleash-ff": {
      "command": "npx",
      "args": [
        "-y",
        "@ylin6/unleash-ff-mcp-server"
      ]
    }
  }
}
Run commandnpx -y @ylin6/unleash-ff-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npm@ylin6/unleash-ff-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

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

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.