@launchdarkly/mcp-server 0.2.7 → 0.3.1

package/README.md

@@ -17,7 +17,7 @@ The official [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) se
   * [Installation](#installation)
   * [Requirements](#requirements)
   * [Available Resources and Operations](#available-resources-and-operations)
-  * [Available environments](#available-environments)
+  * [Available Environments](#available-environments)
   * [Contributions](#contributions)
   * [About LaunchDarkly](#about-launchdarkly)
 
@@ -151,7 +151,7 @@ For supported JavaScript runtimes, please consult [RUNTIMES.md](RUNTIMES.md).
 
 <!-- Placeholder for Future Speakeasy SDK Sections -->
 
-## Available environments
+## 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.
 

package/bin/mcp-server.js

@@ -34236,9 +34236,9 @@ var init_config = __esm(() => {
   SDK_METADATA = {
     language: "typescript",
     openapiDocVersion: "2.0",
-    sdkVersion: "0.2.7",
-    genVersion: "2.610.0",
-    userAgent: "speakeasy-sdk/typescript 0.2.7 2.610.0 2.0 @launchdarkly/mcp-server"
+    sdkVersion: "0.3.1",
+    genVersion: "2.618.0",
+    userAgent: "speakeasy-sdk/typescript 0.3.1 2.618.0 2.0 @launchdarkly/mcp-server"
   };
 });
 
@@ -34803,7 +34803,6 @@ class ClientSDK {
     } else {
       this.#hooks = new SDKHooks;
     }
-    this._options = { ...options, hooks: this.#hooks };
     const url = serverURLFromOptions(options);
     if (url) {
       url.pathname = url.pathname.replace(/\/+$/, "") + "/";
@@ -34814,7 +34813,8 @@ class ClientSDK {
     });
     this._baseURL = baseURL;
     this.#httpClient = client;
-    this.#logger = options.debugLogger;
+    this._options = { ...options, hooks: this.#hooks };
+    this.#logger = this._options.debugLogger;
     if (!this.#logger && env().LAUNCHDARKLY_DEBUG) {
       this.#logger = console;
     }
@@ -34868,7 +34868,7 @@ class ClientSDK {
       headers.set(k2, v2);
     }
     if (!isBrowserLike) {
-      headers.set(conf.uaHeader ?? "user-agent", SDK_METADATA.userAgent);
+      headers.set(conf.uaHeader ?? "user-agent", conf.userAgent ?? SDK_METADATA.userAgent);
     }
     const fetchOptions = {
       ...options?.fetchOptions,
@@ -38468,6 +38468,7 @@ async function $do(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "postAIConfig",
     oAuth2Scopes: [],
@@ -38483,6 +38484,7 @@ async function $do(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -38532,7 +38534,8 @@ var init_aiConfigsCreate2 = __esm(() => {
   };
   tool$aiConfigsCreate = {
     name: "create-ai-config",
-    description: `Creates a new AI Config within a project. Useful for setting up LLM configurations programmatically.`,
+    description: `Creates a new AI Config within a project. Useful for setting up LLM configurations programmatically.
+`,
     scopes: ["write"],
     args,
     tool: async (client, args2, ctx) => {
@@ -38582,6 +38585,7 @@ async function $do2(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "postAIConfigVariation",
     oAuth2Scopes: [],
@@ -38597,6 +38601,7 @@ async function $do2(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -38645,22 +38650,10 @@ var init_aiConfigsCreateVariation2 = __esm(() => {
     request: PostAIConfigVariationRequest$inboundSchema
   };
   tool$aiConfigsCreateVariation = {
-    name: "ai-configs-create-variation",
-    description: `Create AI Config variation
-
-Create a new variation for a given AI Config.
-
-The <code>model</code> in the request body requires a <code>modelName</code> and <code>parameters</code>, for example:
-
-\`\`\`
-  "model": {
-    "modelName": "claude-3-opus-20240229",
-    "parameters": {
-      "max_tokens": 1024
-    }
-  }
-\`\`\`
+    name: "create-ai-config-variation",
+    description: `Adds a new variation to an AI Config, supporting experimentation or multi-model strategies.
 `,
+    scopes: ["write"],
     args: args2,
     tool: async (client, args3, ctx) => {
       const [result, apiCall] = await aiConfigsCreateVariation(client, args3.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -38706,6 +38699,7 @@ async function $do3(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "deleteAIConfig",
     oAuth2Scopes: [],
@@ -38721,6 +38715,7 @@ async function $do3(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -38769,10 +38764,10 @@ var init_aiConfigsDelete2 = __esm(() => {
     request: DeleteAIConfigRequest$inboundSchema
   };
   tool$aiConfigsDelete = {
-    name: "ai-configs-delete",
-    description: `Delete AI Config
-
-Delete an existing AI Config.`,
+    name: "delete-ai-config",
+    description: `Deletes an AI Config and its associated variations. Intended for cleanup or deprecation workflows.
+`,
+    scopes: ["write"],
     args: args3,
     tool: async (client, args4, ctx) => {
       const [result, apiCall] = await aiConfigsDelete(client, args4.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -38821,6 +38816,7 @@ async function $do4(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "deleteAIConfigVariation",
     oAuth2Scopes: [],
@@ -38836,6 +38832,7 @@ async function $do4(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -38884,10 +38881,9 @@ var init_aiConfigsDeleteVariation2 = __esm(() => {
     request: DeleteAIConfigVariationRequest$inboundSchema
   };
   tool$aiConfigsDeleteVariation = {
-    name: "ai-configs-delete-variation",
-    description: `Delete AI Config variation
-
-Delete a specific variation of an AI Config by config key and variation key.`,
+    name: "delete-ai-config-variation",
+    description: `Deletes an AI Config variation.`,
+    scopes: ["write"],
     args: args4,
     tool: async (client, args5, ctx) => {
       const [result, apiCall] = await aiConfigsDeleteVariation(client, args5.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -38932,6 +38928,7 @@ async function $do5(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "getAIConfig",
     oAuth2Scopes: [],
@@ -38947,6 +38944,7 @@ async function $do5(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -38995,10 +38993,9 @@ var init_aiConfigsGet2 = __esm(() => {
     request: GetAIConfigRequest$inboundSchema
   };
   tool$aiConfigsGet = {
-    name: "ai-configs-get",
-    description: `Get AI Config
-
-Retrieve a specific AI Config by its key.`,
+    name: "get-ai-config",
+    description: `Retrieves details of a specific AI Config, including variations and model settings.`,
+    scopes: ["read"],
     args: args5,
     tool: async (client, args6, ctx) => {
       const [result, apiCall] = await aiConfigsGet(client, args6.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -39048,6 +39045,7 @@ async function $do6(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "getAIConfigVariation",
     oAuth2Scopes: [],
@@ -39063,6 +39061,7 @@ async function $do6(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39111,10 +39110,9 @@ var init_aiConfigsGetVariation2 = __esm(() => {
     request: GetAIConfigVariationRequest$inboundSchema
   };
   tool$aiConfigsGetVariation = {
-    name: "ai-configs-get-variation",
-    description: `Get AI Config variation
-
-Get an AI Config variation by key. The response includes all variation versions for the given variation key.`,
+    name: "get-ai-config-variation",
+    description: `Retrieves an AI configuration variation.`,
+    scopes: ["read"],
     args: args6,
     tool: async (client, args7, ctx) => {
       const [result, apiCall] = await aiConfigsGetVariation(client, args7.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -39162,6 +39160,7 @@ async function $do7(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "getAIConfigs",
     oAuth2Scopes: [],
@@ -39178,6 +39177,7 @@ async function $do7(client, request, options) {
     headers,
     query,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39227,8 +39227,9 @@ var init_aiConfigsList2 = __esm(() => {
   };
   tool$aiConfigsList = {
     name: "list-ai-configs",
-    description: `Lists all AI Configs in a project, allowing agents to enumerate available configurations for analysis or testing.`,
-    scopes: ["read", "read"],
+    description: `Retrieves AI configuration settings for a specific project. This endpoint allows agents to access and modify AI-related configurations, ensuring that the AI's behavior aligns with project requirements and user expectations.
+`,
+    scopes: ["read"],
     args: args7,
     tool: async (client, args8, ctx) => {
       const [result, apiCall] = await aiConfigsList(client, args8.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -39275,6 +39276,7 @@ async function $do8(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "patchAIConfig",
     oAuth2Scopes: [],
@@ -39290,6 +39292,7 @@ async function $do8(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39338,21 +39341,9 @@ var init_aiConfigsUpdate2 = __esm(() => {
     request: PatchAIConfigRequest$inboundSchema
   };
   tool$aiConfigsUpdate = {
-    name: "ai-configs-update",
-    description: `Update AI Config
-
-Edit an existing AI Config.
-
-The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields.
-
-Here's an example:
-  \`\`\`
-    {
-      "description": "Example updated description",
-      "tags": ["new-tag"]
-    }
-  \`\`\`
-`,
+    name: "update-ai-config",
+    description: `Updates metadata or configuration of an existing AI Config.`,
+    scopes: ["write"],
     args: args8,
     tool: async (client, args9, ctx) => {
       const [result, apiCall] = await aiConfigsUpdate(client, args9.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -39405,6 +39396,7 @@ async function $do9(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "patchAIConfigVariation",
     oAuth2Scopes: [],
@@ -39420,6 +39412,7 @@ async function $do9(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39468,25 +39461,10 @@ var init_aiConfigsUpdateVariation2 = __esm(() => {
     request: PatchAIConfigVariationRequest$inboundSchema
   };
   tool$aiConfigsUpdateVariation = {
-    name: "ai-configs-update-variation",
-    description: `Update AI Config variation
-
-Edit an existing variation of an AI Config. This creates a new version of the variation.
-
-The request body must be a JSON object of the fields to update. The values you include replace the existing values for the fields.
-
-Here's an example:
-\`\`\`
-  {
-    "messages": [
-      {
-        "role": "system",
-        "content": "The new message"
-      }
-    ]
-  }
-\`\`\`
+    name: "update-ai-config-variation",
+    description: `Updates a specific variation within an AI Config. Enables fine-tuned control of model behavior.
 `,
+    scopes: ["write"],
     args: args9,
     tool: async (client, args10, ctx) => {
       const [result, apiCall] = await aiConfigsUpdateVariation(client, args10.request, { fetchOptions: { signal: ctx.signal } }).$inspect();
@@ -39531,6 +39509,7 @@ async function $do10(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "postFeatureFlag",
     oAuth2Scopes: [],
@@ -39547,6 +39526,7 @@ async function $do10(client, request, options) {
     headers,
     query,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39596,7 +39576,8 @@ var init_featureFlagsCreate2 = __esm(() => {
   };
   tool$featureFlagsCreate = {
     name: "create-feature-flag",
-    description: `Creates a new feature flag within a project. AI agents can use this operation to define feature toggles for controlled rollouts, experimentation, or gated features, automating the flag setup process.`,
+    description: `Creates a new feature flag within a project. AI agents can use this operation to define feature toggles for controlled rollouts, experimentation, or gated features, automating the flag setup process.
+`,
     scopes: ["write"],
     args: args10,
     tool: async (client, args11, ctx) => {
@@ -39642,6 +39623,7 @@ async function $do11(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "deleteFeatureFlag",
     oAuth2Scopes: [],
@@ -39657,6 +39639,7 @@ async function $do11(client, request, options) {
     path,
     headers,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39706,7 +39689,8 @@ var init_featureFlagsDelete2 = __esm(() => {
   };
   tool$featureFlagsDelete = {
     name: "delete-feature-flag",
-    description: `Removes a feature flag from the project. Used by AI agents to clean up deprecated toggles that are no longer in use, improving system hygiene and maintainability.`,
+    description: `Removes a feature flag from the project. Used by AI agents to clean up deprecated toggles that are no longer in use, improving system hygiene and maintainability.
+`,
     scopes: ["write"],
     args: args11,
     tool: async (client, args12, ctx) => {
@@ -39755,6 +39739,7 @@ async function $do12(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "getFeatureFlag",
     oAuth2Scopes: [],
@@ -39771,6 +39756,7 @@ async function $do12(client, request, options) {
     headers,
     query,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39820,7 +39806,8 @@ var init_featureFlagsGet2 = __esm(() => {
   };
   tool$featureFlagsGet = {
     name: "get-feature-flag",
-    description: `Fetches the full configuration for a specific feature flag, including environments, variations, and targeting rules. Useful for agents auditing or managing specific feature toggles in a detailed, contextual manner.`,
+    description: `Fetches the full configuration for a specific feature flag, including environments, variations, and targeting rules. Useful for agents auditing or managing specific feature toggles in a detailed, contextual manner.
+`,
     scopes: ["read"],
     args: args12,
     tool: async (client, args13, ctx) => {
@@ -39874,6 +39861,7 @@ async function $do13(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "getFeatureFlags",
     oAuth2Scopes: [],
@@ -39890,6 +39878,7 @@ async function $do13(client, request, options) {
     headers,
     query,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -39939,7 +39928,8 @@ var init_featureFlagsList2 = __esm(() => {
   };
   tool$featureFlagsList = {
     name: "list-feature-flags",
-    description: `Retrieves all feature flags within a project, including metadata and targeting rules. Enables AI agents to enumerate existing flags for inspection, configuration analysis, or generating flag usage reports across environments.`,
+    description: `Retrieves all feature flags within a project, including metadata and targeting rules. Enables AI agents to enumerate existing flags for inspection, configuration analysis, or generating flag usage reports across environments.
+`,
     scopes: ["read"],
     args: args13,
     tool: async (client, args14, ctx) => {
@@ -39989,6 +39979,7 @@ async function $do14(client, request, options) {
   const securityInput = secConfig == null ? {} : { apiKey: secConfig };
   const requestSecurity = resolveGlobalSecurity(securityInput);
   const context = {
+    options: client._options,
     baseURL: options?.serverURL ?? client._baseURL ?? "",
     operationID: "patchFeatureFlag",
     oAuth2Scopes: [],
@@ -40005,6 +39996,7 @@ async function $do14(client, request, options) {
     headers,
     query,
     body,
+    userAgent: client._options.userAgent,
     timeoutMs: options?.timeoutMs || client._options.timeoutMs || -1
   }, options);
   if (!requestRes.ok) {
@@ -40054,7 +40046,8 @@ var init_featureFlagsPatch2 = __esm(() => {
   };
   tool$featureFlagsPatch = {
     name: "update-feature-flag",
-    description: `Updates the configuration of an existing feature flag. Enables agents to change targeting rules, modify variations, or adapt rollout strategies dynamically in response to user behavior or experiment results.`,
+    description: `Updates the configuration of an existing feature flag. Enables agents to change targeting rules, modify variations, or adapt rollout strategies dynamically in response to user behavior or experiment results.
+`,
     scopes: ["write"],
     args: args14,
     tool: async (client, args15, ctx) => {
@@ -40075,7 +40068,7 @@ var init_featureFlagsPatch2 = __esm(() => {
 function createMCPServer(deps) {
   const server = new McpServer({
     name: "LaunchDarkly",
-    version: "0.2.7"
+    version: "0.3.1"
   });
   const client = new LaunchDarklyCore({
     apiKey: deps.apiKey,
@@ -41317,7 +41310,7 @@ var routes = an({
 var app = He(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.2.7"
+    currentVersion: "0.3.1"
   }
 });
 zt(app, process3.argv.slice(2), buildContext(process3));
@@ -41325,5 +41318,5 @@ export {
   app
 };
 
-//# debugId=74ABC09135B2920A64756E2164756E21
+//# debugId=39793AD8090FB23C64756E2164756E21
 //# sourceMappingURL=mcp-server.js.map