Unleash Feature Flags

You can use this MCP server to manage Unleash feature flags from AI assistants or automation tools. It exposes a programmatic interface that lets you list projects, view and modify feature flags, and create new flags through simple tool calls, keeping your feature management workflow fast and scriptable.

How to use

Connect with your MCP client to manage Unleash feature flags. You can retrieve the list of projects, inspect features within a project, and perform create or update operations on feature flags. Use clear project and flag identifiers to run the supported actions, and rely on the server to translate your requests into Unleash API calls.

How to install

Prerequisites you need installed on your machine are Node.js (recommended version per your project’s needs) and npm.

Install and run the MCP server globally or run it directly with a short command.

npm install -g @ylin6/unleash-ff-mcp-server

npx @ylin6/unleash-ff-mcp-server

Configuration and usage notes

The server requires two environment variables to connect to your Unleash instance. Set them in your environment when starting the server or configure your run context accordingly.

Required environment variables:

• UNLEASH_API_URL: The URL of your Unleash API instance
• UNLEASH_AUTH_TOKEN: The authentication token for your Unleash instance

A typical run using your shell would look like setting the environment and starting the MCP server with npx.

env UNLEASH_API_URL=https://your-unleash.example.com \
UNLEASH_AUTH_TOKEN=YOUR_TOKEN \
npx -y @ylin6/unleash-ff-mcp-server

Security and maintenance notes

Keep your Unleash API URL and token secure. Use the minimal required permissions for your token and rotate credentials periodically. Monitor access to the MCP server and enforce least-privilege practices in your automation workflows.

Available tools

Get Projects

Retrieve a list of all projects in the Unleash instance.

Get Features

Retrieve all feature flags within a specific project.

Create Feature Flag

Create a new feature flag within a project with a name, description, and type.

Update Feature Flag

Update an existing feature flag's description and type.

Get Feature Flag

Retrieve details about a specific feature flag.