@langwatch/mcp-server 0.6.1 → 0.8.0

package/dist/{chunk-IX6QJKAD.js → chunk-CPUPGDNA.js}

@@ -1,6 +1,6 @@
 import {
   makeRequest
-} from "./chunk-LLRQIF52.js";
+} from "./chunk-YH2IBTEL.js";
 
 // src/langwatch-api-model-providers.ts
 async function listModelProviders() {
@@ -19,4 +19,4 @@ export {
   listModelProviders,
   setModelProvider
 };
-//# sourceMappingURL=chunk-IX6QJKAD.js.map
+//# sourceMappingURL=chunk-CPUPGDNA.js.map

package/dist/chunk-FBRKHHJV.js

@@ -0,0 +1,48 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-suites.ts
+async function listSuites() {
+  return makeRequest("GET", "/api/suites");
+}
+async function getSuite(id) {
+  return makeRequest(
+    "GET",
+    `/api/suites/${encodeURIComponent(id)}`
+  );
+}
+async function createSuite(data) {
+  return makeRequest("POST", "/api/suites", data);
+}
+async function updateSuite(params) {
+  const { id, ...data } = params;
+  return makeRequest(
+    "PATCH",
+    `/api/suites/${encodeURIComponent(id)}`,
+    data
+  );
+}
+async function runSuite(id, idempotencyKey) {
+  return makeRequest(
+    "POST",
+    `/api/suites/${encodeURIComponent(id)}/run`,
+    { idempotencyKey: idempotencyKey ?? `mcp-${Date.now()}-${Math.random().toString(36).slice(2)}` }
+  );
+}
+async function archiveSuite(id) {
+  return makeRequest(
+    "DELETE",
+    `/api/suites/${encodeURIComponent(id)}`
+  );
+}
+
+export {
+  listSuites,
+  getSuite,
+  createSuite,
+  updateSuite,
+  runSuite,
+  archiveSuite
+};
+//# sourceMappingURL=chunk-FBRKHHJV.js.map

package/dist/{chunk-5UOPNRXW.js → chunk-HDJDFKZR.js}

@@ -1,6 +1,6 @@
 import {
   makeRequest
-} from "./chunk-LLRQIF52.js";
+} from "./chunk-YH2IBTEL.js";
 
 // src/langwatch-api-evaluators.ts
 function getEvaluatorType(evaluator) {
@@ -26,12 +26,19 @@ async function updateEvaluator(params) {
     data
   );
 }
+async function deleteEvaluator(idOrSlug) {
+  return makeRequest(
+    "DELETE",
+    `/api/evaluators/${encodeURIComponent(idOrSlug)}`
+  );
+}
 
 export {
   getEvaluatorType,
   listEvaluators,
   getEvaluator,
   createEvaluator,
-  updateEvaluator
+  updateEvaluator,
+  deleteEvaluator
 };
-//# sourceMappingURL=chunk-5UOPNRXW.js.map
+//# sourceMappingURL=chunk-HDJDFKZR.js.map

package/dist/chunk-KOO5733S.js

@@ -0,0 +1,72 @@
+// src/config.ts
+import { AsyncLocalStorage } from "async_hooks";
+var GLOBAL_KEY = "__langwatch_mcp_config";
+var STORAGE_KEY = "__langwatch_mcp_config_storage";
+function getGlobalState() {
+  const g = globalThis;
+  if (!g[GLOBAL_KEY]) {
+    g[GLOBAL_KEY] = void 0;
+  }
+  if (!g[STORAGE_KEY]) {
+    g[STORAGE_KEY] = new AsyncLocalStorage();
+  }
+  return {
+    get globalConfig() {
+      return g[GLOBAL_KEY];
+    },
+    set globalConfig(val) {
+      g[GLOBAL_KEY] = val;
+    },
+    get configStorage() {
+      return g[STORAGE_KEY];
+    }
+  };
+}
+function initConfig(args) {
+  const state = getGlobalState();
+  state.globalConfig = {
+    apiKey: args.apiKey || process.env.LANGWATCH_API_KEY,
+    endpoint: args.endpoint || process.env.LANGWATCH_ENDPOINT || "https://app.langwatch.ai",
+    projectId: process.env.LANGWATCH_PROJECT_ID
+  };
+}
+function getConfig() {
+  const state = getGlobalState();
+  const scoped = state.configStorage.getStore();
+  if (scoped) return scoped;
+  if (!state.globalConfig) {
+    console.error(
+      "[MCP config] getConfig() failed: globalConfig is null, no scoped config active. Was initConfig() called? Stack:",
+      new Error().stack
+    );
+    throw new Error("Config not initialized");
+  }
+  return state.globalConfig;
+}
+function requireApiKey() {
+  const config = getConfig();
+  if (!config.apiKey) {
+    const state = getGlobalState();
+    const hasScoped = !!state.configStorage.getStore();
+    console.error(
+      `[MCP config] requireApiKey() failed: apiKey is undefined. scopedConfig=${hasScoped}, endpoint=${config.endpoint}. In HTTP mode, the API key should be set per-session via runWithConfig(). Stack:`,
+      new Error().stack
+    );
+    throw new Error(
+      "LANGWATCH_API_KEY is required. Set it via --apiKey flag or LANGWATCH_API_KEY environment variable."
+    );
+  }
+  return config.apiKey;
+}
+function runWithConfig(config, fn) {
+  const state = getGlobalState();
+  return state.configStorage.run(config, fn);
+}
+
+export {
+  initConfig,
+  getConfig,
+  requireApiKey,
+  runWithConfig
+};
+//# sourceMappingURL=chunk-KOO5733S.js.map

package/dist/chunk-KZNBCKWG.js

@@ -0,0 +1,39 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-dashboards.ts
+async function listDashboards() {
+  return makeRequest("GET", "/api/dashboards");
+}
+async function getDashboard(id) {
+  return makeRequest(
+    "GET",
+    `/api/dashboards/${encodeURIComponent(id)}`
+  );
+}
+async function createDashboard(data) {
+  return makeRequest("POST", "/api/dashboards", data);
+}
+async function renameDashboard(id, data) {
+  return makeRequest(
+    "PATCH",
+    `/api/dashboards/${encodeURIComponent(id)}`,
+    data
+  );
+}
+async function deleteDashboard(id) {
+  return makeRequest(
+    "DELETE",
+    `/api/dashboards/${encodeURIComponent(id)}`
+  );
+}
+
+export {
+  listDashboards,
+  getDashboard,
+  createDashboard,
+  renameDashboard,
+  deleteDashboard
+};
+//# sourceMappingURL=chunk-KZNBCKWG.js.map

package/dist/chunk-L6QENXYA.js

@@ -0,0 +1,42 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-annotations.ts
+async function listAnnotations() {
+  return makeRequest("GET", "/api/annotations");
+}
+async function getAnnotation(id) {
+  return makeRequest(
+    "GET",
+    `/api/annotations/${encodeURIComponent(id)}`
+  );
+}
+async function getAnnotationsByTrace(traceId) {
+  return makeRequest(
+    "GET",
+    `/api/annotations/trace/${encodeURIComponent(traceId)}`
+  );
+}
+async function createAnnotation(traceId, data) {
+  return makeRequest(
+    "POST",
+    `/api/annotations/trace/${encodeURIComponent(traceId)}`,
+    data
+  );
+}
+async function deleteAnnotation(id) {
+  return makeRequest(
+    "DELETE",
+    `/api/annotations/${encodeURIComponent(id)}`
+  );
+}
+
+export {
+  listAnnotations,
+  getAnnotation,
+  getAnnotationsByTrace,
+  createAnnotation,
+  deleteAnnotation
+};
+//# sourceMappingURL=chunk-L6QENXYA.js.map

package/dist/{chunk-6U4TCGFC.js → chunk-NACSR6B7.js}

@@ -1,6 +1,6 @@
 import {
   makeRequest
-} from "./chunk-LLRQIF52.js";
+} from "./chunk-YH2IBTEL.js";
 
 // src/langwatch-api-scenarios.ts
 async function listScenarios() {
@@ -37,4 +37,4 @@ export {
   updateScenario,
   archiveScenario
 };
-//# sourceMappingURL=chunk-6U4TCGFC.js.map
+//# sourceMappingURL=chunk-NACSR6B7.js.map

package/dist/chunk-NUFPTHKU.js

@@ -0,0 +1,9 @@
+// src/utils/escape-markdown.ts
+function escapeMarkdown(value) {
+  return value.replace(/\\/g, "\\\\").replace(/\|/g, "\\|").replace(/\n/g, " ");
+}
+
+export {
+  escapeMarkdown
+};
+//# sourceMappingURL=chunk-NUFPTHKU.js.map

package/dist/chunk-OVQF3D5R.js

@@ -0,0 +1,86 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-datasets.ts
+async function listDatasets(params) {
+  const query = new URLSearchParams();
+  if (params?.page != null) query.set("page", String(params.page));
+  if (params?.limit != null) query.set("limit", String(params.limit));
+  const qs = query.toString();
+  const path = qs ? `/api/dataset?${qs}` : "/api/dataset";
+  return makeRequest("GET", path);
+}
+async function getDataset(slugOrId) {
+  return makeRequest(
+    "GET",
+    `/api/dataset/${encodeURIComponent(slugOrId)}`
+  );
+}
+async function createDataset(data) {
+  return makeRequest(
+    "POST",
+    "/api/dataset",
+    data
+  );
+}
+async function updateDataset(params) {
+  const { slugOrId, ...data } = params;
+  return makeRequest(
+    "PATCH",
+    `/api/dataset/${encodeURIComponent(slugOrId)}`,
+    data
+  );
+}
+async function deleteDataset(slugOrId) {
+  return makeRequest(
+    "DELETE",
+    `/api/dataset/${encodeURIComponent(slugOrId)}`
+  );
+}
+async function createDatasetRecords(params) {
+  const { slugOrId, entries } = params;
+  return makeRequest(
+    "POST",
+    `/api/dataset/${encodeURIComponent(slugOrId)}/records`,
+    { entries }
+  );
+}
+async function updateDatasetRecord(params) {
+  const { slugOrId, recordId, entry } = params;
+  return makeRequest(
+    "PATCH",
+    `/api/dataset/${encodeURIComponent(slugOrId)}/records/${encodeURIComponent(recordId)}`,
+    { entry }
+  );
+}
+async function deleteDatasetRecords(params) {
+  const { slugOrId, recordIds } = params;
+  return makeRequest(
+    "DELETE",
+    `/api/dataset/${encodeURIComponent(slugOrId)}/records`,
+    { recordIds }
+  );
+}
+async function listDatasetRecords(params) {
+  const { slugOrId } = params;
+  const query = new URLSearchParams();
+  if (params.page != null) query.set("page", String(params.page));
+  if (params.limit != null) query.set("limit", String(params.limit));
+  const qs = query.toString();
+  const path = `/api/dataset/${encodeURIComponent(slugOrId)}/records${qs ? `?${qs}` : ""}`;
+  return makeRequest("GET", path);
+}
+
+export {
+  listDatasets,
+  getDataset,
+  createDataset,
+  updateDataset,
+  deleteDataset,
+  createDatasetRecords,
+  updateDatasetRecord,
+  deleteDatasetRecords,
+  listDatasetRecords
+};
+//# sourceMappingURL=chunk-OVQF3D5R.js.map

package/dist/chunk-PO7FM7IX.js

@@ -0,0 +1,35 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-workflows.ts
+async function listWorkflows() {
+  return makeRequest("GET", "/api/workflows");
+}
+async function getWorkflow(id) {
+  return makeRequest(
+    "GET",
+    `/api/workflows/${encodeURIComponent(id)}`
+  );
+}
+async function runWorkflow(id, input) {
+  return makeRequest(
+    "POST",
+    `/api/workflows/${encodeURIComponent(id)}/run`,
+    input ?? {}
+  );
+}
+async function deleteWorkflow(id) {
+  return makeRequest(
+    "DELETE",
+    `/api/workflows/${encodeURIComponent(id)}`
+  );
+}
+
+export {
+  listWorkflows,
+  getWorkflow,
+  runWorkflow,
+  deleteWorkflow
+};
+//# sourceMappingURL=chunk-PO7FM7IX.js.map

package/dist/chunk-PZUWCWOS.js

@@ -0,0 +1,25 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-simulation-runs.ts
+async function listSimulationRuns(params) {
+  const query = new URLSearchParams();
+  if (params?.scenarioSetId) query.set("scenarioSetId", params.scenarioSetId);
+  if (params?.batchRunId) query.set("batchRunId", params.batchRunId);
+  if (params?.limit) query.set("limit", String(params.limit));
+  const qs = query.toString() ? `?${query}` : "";
+  return makeRequest("GET", `/api/simulation-runs${qs}`);
+}
+async function getSimulationRun(scenarioRunId) {
+  return makeRequest(
+    "GET",
+    `/api/simulation-runs/${encodeURIComponent(scenarioRunId)}`
+  );
+}
+
+export {
+  listSimulationRuns,
+  getSimulationRun
+};
+//# sourceMappingURL=chunk-PZUWCWOS.js.map

package/dist/chunk-WVI5CJ6S.js

@@ -0,0 +1,21 @@
+import {
+  escapeMarkdown
+} from "./chunk-NUFPTHKU.js";
+
+// src/tools/format-dataset-mutation.ts
+function formatDatasetMutationDetails(result) {
+  const lines = [];
+  lines.push(`**Name**: ${escapeMarkdown(result.name)}`);
+  lines.push(`**Slug**: ${escapeMarkdown(result.slug)}`);
+  lines.push(`**ID**: ${escapeMarkdown(result.id)}`);
+  if (Array.isArray(result.columnTypes) && result.columnTypes.length > 0) {
+    const colNames = result.columnTypes.map((c) => `${escapeMarkdown(c.name)} (${escapeMarkdown(c.type)})`).join(", ");
+    lines.push(`**Columns**: ${colNames}`);
+  }
+  return lines;
+}
+
+export {
+  formatDatasetMutationDetails
+};
+//# sourceMappingURL=chunk-WVI5CJ6S.js.map

package/dist/{chunk-LLRQIF52.js → chunk-YH2IBTEL.js}

@@ -1,14 +1,18 @@
 import {
   getConfig,
   requireApiKey
-} from "./chunk-AAQNA53E.js";
+} from "./chunk-KOO5733S.js";
 
 // src/langwatch-api.ts
 async function makeRequest(method, path, body) {
-  const url = getConfig().endpoint + path;
+  const config = getConfig();
+  const url = config.endpoint + path;
   const headers = {
     "X-Auth-Token": requireApiKey()
   };
+  if (config.projectId) {
+    headers["X-Project-Id"] = config.projectId;
+  }
   if (body !== void 0) {
     headers["Content-Type"] = "application/json";
   }
@@ -23,6 +27,9 @@ async function makeRequest(method, path, body) {
       `LangWatch API error ${response.status}: ${responseBody}`
     );
   }
+  if (response.status === 204 || response.headers?.get("content-length") === "0") {
+    return null;
+  }
   return response.json();
 }
 async function searchTraces(params) {
@@ -48,8 +55,11 @@ async function getAnalyticsTimeseries(params) {
 async function listPrompts() {
   return makeRequest("GET", "/api/prompts");
 }
-async function getPrompt(idOrHandle, version) {
-  const query = version != null ? `?version=${version}` : "";
+async function getPrompt(idOrHandle, options) {
+  const params = new URLSearchParams();
+  if (options?.version != null) params.set("version", String(options.version));
+  if (options?.tag) params.set("tag", options.tag);
+  const query = params.toString() ? `?${params}` : "";
   return makeRequest(
     "GET",
     `/api/prompts/${encodeURIComponent(idOrHandle)}${query}`
@@ -69,6 +79,39 @@ async function updatePrompt(idOrHandle, data) {
     data
   );
 }
+async function assignPromptTag({
+  idOrHandle,
+  tag,
+  versionId
+}) {
+  return makeRequest(
+    "PUT",
+    `/api/prompts/${encodeURIComponent(idOrHandle)}/tags/${encodeURIComponent(tag)}`,
+    { versionId }
+  );
+}
+async function listPromptTags() {
+  return makeRequest("GET", "/api/prompts/tags");
+}
+async function createPromptTag(name) {
+  return makeRequest("POST", "/api/prompts/tags", { name });
+}
+async function renamePromptTag({
+  tag,
+  name
+}) {
+  return makeRequest(
+    "PUT",
+    `/api/prompts/tags/${encodeURIComponent(tag)}`,
+    { name }
+  );
+}
+async function deletePromptTag(tag) {
+  return makeRequest(
+    "DELETE",
+    `/api/prompts/tags/${encodeURIComponent(tag)}`
+  );
+}
 
 export {
   makeRequest,
@@ -78,6 +121,11 @@ export {
   listPrompts,
   getPrompt,
   createPrompt,
-  updatePrompt
+  updatePrompt,
+  assignPromptTag,
+  listPromptTags,
+  createPromptTag,
+  renamePromptTag,
+  deletePromptTag
 };
-//# sourceMappingURL=chunk-LLRQIF52.js.map
+//# sourceMappingURL=chunk-YH2IBTEL.js.map

package/dist/chunk-YI3OG4PI.js

@@ -0,0 +1,71 @@
+import {
+  makeRequest
+} from "./chunk-YH2IBTEL.js";
+
+// src/langwatch-api-agents.ts
+async function listAgents(params) {
+  const query = new URLSearchParams();
+  if (params?.page) query.set("page", String(params.page));
+  if (params?.limit) query.set("limit", String(params.limit));
+  const qs = query.toString() ? `?${query}` : "";
+  return makeRequest("GET", `/api/agents${qs}`);
+}
+async function getAgent(id) {
+  return makeRequest(
+    "GET",
+    `/api/agents/${encodeURIComponent(id)}`
+  );
+}
+async function createAgent(data) {
+  return makeRequest("POST", "/api/agents", data);
+}
+async function updateAgent(params) {
+  const { id, ...data } = params;
+  return makeRequest(
+    "PATCH",
+    `/api/agents/${encodeURIComponent(id)}`,
+    data
+  );
+}
+async function runAgent(id, input) {
+  const agent = await getAgent(id);
+  const config = agent.config ?? {};
+  if (agent.type === "http") {
+    const url = config.url;
+    if (!url) {
+      throw new Error("HTTP agent has no URL configured");
+    }
+    const response = await fetch(url, {
+      method: "POST",
+      headers: { "Content-Type": "application/json" },
+      body: JSON.stringify(input ?? {})
+    });
+    const result2 = await response.json();
+    return { agentType: "http", result: result2 };
+  }
+  const workflowId = config.workflowId;
+  if (!workflowId) {
+    throw new Error(
+      `Agent "${agent.name}" (type: ${agent.type}) cannot be executed directly. Only HTTP agents and workflow-linked agents can be run.`
+    );
+  }
+  const { runWorkflow } = await import("./langwatch-api-workflows-4CJQAYP2.js");
+  const result = await runWorkflow(workflowId, input);
+  return { agentType: agent.type, result };
+}
+async function deleteAgent(id) {
+  return makeRequest(
+    "DELETE",
+    `/api/agents/${encodeURIComponent(id)}`
+  );
+}
+
+export {
+  listAgents,
+  getAgent,
+  createAgent,
+  updateAgent,
+  runAgent,
+  deleteAgent
+};
+//# sourceMappingURL=chunk-YI3OG4PI.js.map

package/dist/config.d.ts

@@ -0,0 +1,17 @@
+interface McpConfig {
+  apiKey: string | undefined;
+  endpoint: string;
+}
+
+declare function initConfig(args: {
+  apiKey?: string;
+  endpoint?: string;
+}): void;
+
+declare function getConfig(): McpConfig;
+
+declare function requireApiKey(): string;
+
+declare function runWithConfig<T>(config: McpConfig, fn: () => T): T;
+
+export { type McpConfig, getConfig, initConfig, requireApiKey, runWithConfig };

package/dist/config.js

@@ -0,0 +1,13 @@
+import {
+  getConfig,
+  initConfig,
+  requireApiKey,
+  runWithConfig
+} from "./chunk-KOO5733S.js";
+export {
+  getConfig,
+  initConfig,
+  requireApiKey,
+  runWithConfig
+};
+//# sourceMappingURL=config.js.map

package/dist/create-agent-YRSDH7P7.js

@@ -0,0 +1,23 @@
+import {
+  createAgent
+} from "./chunk-YI3OG4PI.js";
+import "./chunk-YH2IBTEL.js";
+import "./chunk-KOO5733S.js";
+
+// src/tools/create-agent.ts
+async function handleCreateAgent(params) {
+  const agent = await createAgent({
+    name: params.name,
+    type: params.type,
+    config: params.config ?? {}
+  });
+  return `Agent created successfully!
+
+**Name**: ${agent.name}
+**ID**: ${agent.id}
+**Type**: ${agent.type}`;
+}
+export {
+  handleCreateAgent
+};
+//# sourceMappingURL=create-agent-YRSDH7P7.js.map

package/dist/create-annotation-FYQNKMVJ.js

@@ -0,0 +1,24 @@
+import {
+  createAnnotation
+} from "./chunk-L6QENXYA.js";
+import "./chunk-YH2IBTEL.js";
+import "./chunk-KOO5733S.js";
+
+// src/tools/create-annotation.ts
+async function handleCreateAnnotation(params) {
+  const annotation = await createAnnotation(params.traceId, {
+    comment: params.comment,
+    isThumbsUp: params.isThumbsUp,
+    email: params.email
+  });
+  const rating = params.isThumbsUp === true ? " \u{1F44D}" : params.isThumbsUp === false ? " \u{1F44E}" : "";
+  return `Annotation created successfully!${rating}
+
+**ID**: ${annotation.id ?? "\u2014"}
+**Trace ID**: ${params.traceId}${params.comment ? `
+**Comment**: ${params.comment}` : ""}`;
+}
+export {
+  handleCreateAnnotation
+};
+//# sourceMappingURL=create-annotation-FYQNKMVJ.js.map