@launchdarkly/mcp-server weekly downloads statistics

LaunchDarkly local MCP server

The local Model Context Protocol (MCP) server for LaunchDarkly federal and European Union (EU) environments.

[!IMPORTANT] Use the LaunchDarkly hosted MCP server where available

LaunchDarkly strongly recommends using the hosted MCP server where it is available. The hosted server is more feature complete and receives more frequent updates than this self-managed server.

LaunchDarkly provides this self-managed MCP server for LaunchDarkly EU or Federal instances, which do not yet support the hosted MCP.

Table of Contents

• LaunchDarkly local MCP server • Installation • Requirements • Available Resources and Operations • Available Environments • Contributions • About LaunchDarkly

Installation

This MCP server can be installed in any AI client that supports the MCP protocol. Refer to your AI client's instructions if it isn't listed here.

Cursor installation steps

Create a .cursor/mcp.json file in your project root with the following content:

Specify your API key as found on LaunchDarkly's Authorization page.

Claude installation steps

Add the following server definition to your claude_desktop_config.json file:

Specify your API key as found on LaunchDarkly's Authorization page.

Qodo Gen installation steps

1. Open Qodo Gen chat panel in VSCode or IntelliJ. 2. Click Connect more tools. 3. Click + Add new MCP. 4. Add the following configuration:

Specify your API key as found on LaunchDarkly's Authorization page.

1. Click Save.

GitHub Copilot CLI installation steps

Use the Copilot CLI to interactively add the MCP server:

Or create/edit ~/.copilot/mcp-config.json with the following content:

Specify your API key as found on LaunchDarkly's Authorization page.

For more information, see the GitHub Copilot CLI documentation.

Standalone binary installation steps

You can also run the MCP server as a standalone binary with no additional dependencies. You must pull these binaries from available GitHub releases while specifying the appropriate tag value:

Installation steps from a local clone

You can also run the MCP server locally by cloning this repository. Once cloned, you'll need to install dependencies (npm install) and build the server (npm run build).

Then, configure your server definition to reference your local clone. For example:

Installation steps using environment variables

Some AI clients allow for accessing environment variables within MCP configurations. In AI clients where this is supported, you can configure your MCP server to read from an environment variable like MCP_LD_TOKEN as follows:

Installation steps for Docker

If installing the MCP server from the AWS Markeplace, pull the image using an authenticated role using the provided instructions in the marketplace listing.

To run the container:

The container listens on 0.0.0.0, so --auth-token (at least 16 characters) is required. Clients must send Authorization: Bearer on /sse and /message. Outside Docker, the SSE transport listens on 127.0.0.1 by default; pass --host to change it, which also requires --auth-token for non-loopback hosts.

Then, configure your server definition to point at the running container. For example:

This won't work in AI clients (such as Cursor) which don't support accessing environment variables directly within MCP configurations. As a workaround, you can invoke a local script from your MCP configuration. See here for an example.

Requirements

For supported JavaScript runtimes, please consult RUNTIMES.md.

Available Resources and Operations

Available methods

AiConfigs

• getTargeting - Show an AI Config's targeting • updateTargeting - Update AI Config targeting • list - List AI Configs • create - Create new AI Config • delete - Delete AI Config • get - Get AI Config • update - Update AI Config • createVariation - Create AI Config variation • deleteVariation - Delete AI Config variation • getVariation - Get AI Config variation • updateVariation - Update AI Config variation

AuditLog

• listEntries - List audit log entries

CodeReferences

• listRepositories - List repositories

Environments

• listByProject - List environments

FeatureFlags

• getStatus - Get flag status across environments • list - List feature flags • create - Create a feature flag • get - Get feature flag • patch - Update feature flag • delete - Delete feature flag

Available Environments

Most customer accounts run on LaunchDarkly's commercial (default) environment. Customers on other environments can specify the --server-url argument to connect to the appropriate environment. For example, customers on LaunchDarkly's Federal environment should specify the --server-url https://app.launchdarkly.us argument when starting their MCP server.

| Environment | Server URL |

| Commercial (Default) | https://app.launchdarkly.com | | Federal | https://app.launchdarkly.us | | EU | https://app.eu.launchdarkly.com |

Contributions

While we value open-source contributions to this SDK, this library is generated programmatically. Any manual changes added to internal files will be overwritten on the next generation. We look forward to hearing your feedback. Feel free to open a PR or an issue with a proof of concept and we'll do our best to include it in a future release.

About LaunchDarkly…