create_flagLABSCO SUMMARY
The whole flag lifecycle, from the editor.
It is opinionated in a useful way: evaluate_change comes first and often calls detect_flag itself, so the common failure — a second flag for something already flagged — is designed out. cleanup_flag closes the other end, which is the half teams usually skip.
What it is
A feature-flag workflow over the Unleash Admin API, built for coding assistants: assess a change, check for an existing flag, create one, wrap the code, configure rollout, and remove it later.
What you get
- A code change scored for risk, with a recommendation on whether a flag is warranted
- Existing flags discovered before a duplicate is created
- A flag created with validation and typing
- Language-specific guidance on wrapping the change in that flag
- Rollout strategies configured, and a strategy removed from an environment
- A flag enabled or disabled in an environment
- A flag's metadata and activation strategies read back
- Flags in a project and projects available to the token, listed with pagination
- Instructions for safely removing flagged code paths
Requirements
Node.js 22 or newer and an Unleash instance with an Admin API token — what the server can see and change is bounded by that token's projects.
Setup effort
One command plus credentials — npx -y @unleash/mcp@latest --log-level error, then supply credentials
USE CASES
Deciding whether this change needs a flag at all
The change is scored for risk and checked against existing flags before anything is created.
Creating a flag without leaving the code
The flag is created with proper typing, and the guidance for wrapping the change comes back in the language you are writing.
Rolling something out gradually
Configure the strategy, then enable the flag in one environment at a time.
Checking what state a flag is in
Metadata and activation strategies read back, so nobody guesses whether it is on in production.
Retiring a flag and the code around it
Instructions for removing the flagged paths safely, plus the strategy deletion that goes with it.
Finding out which projects your token reaches
The project list bounds what the assistant can touch, which is worth knowing before it starts.
11 tools
Listed in project docs. Your client may show a different list.
evaluate_changedetect_flagwrap_changeset_flag_rolloutget_flag_statelist_flagslist_projectstoggle_flag_environmentremove_flag_strategycleanup_flagBEFORE YOU INSTALL
What to know first
Tools you get
11 tools named in the project's documentation.
Requires
- npx on PATH
- Node.js 22 or later
- UNLEASH_PAT in your environment
INSTALLATION
Connect your client
Server setup
npx -y @unleash/mcp@latest --log-level errorMCP Clients
Claude Code — npx
claude mcp add unleash \
--env UNLEASH_BASE_URL=<YOUR_UNLEASH_BASE_URL> \
--env UNLEASH_PAT=<YOUR_UNLEASH_PAT> \
-- npx -y @unleash/mcp@latest --log-level errorCodex — npx
codex mcp add unleash \
--env UNLEASH_BASE_URL=<YOUR_UNLEASH_BASE_URL> \
--env UNLEASH_PAT=<YOUR_UNLEASH_PAT> \
-- npx -y @unleash/mcp@latest --log-level errorClaude Code — remote
claude mcp add unleash https://<YOUR_UNLEASH_BASE_URL>/api/admin/mcp --transport httpCodex — remote
codex mcp add unleash https://<YOUR_UNLEASH_BASE_URL>/api/admin/mcp --transport http