@langwatch/mcp-server 2.1.0 → 3.0.0

package/dist/chunk-7CZQDZ2K.js

@@ -0,0 +1,319 @@
+import {
+  getConfig,
+  requireApiKey
+} from "./chunk-DULFP3MK.js";
+
+// package.json
+var package_default = {
+  name: "@langwatch/mcp-server",
+  version: "3.0.0",
+  description: "An MCP server for Langwatch.",
+  license: "MIT",
+  author: "",
+  repository: {
+    type: "git",
+    url: "https://github.com/langwatch/langwatch.git",
+    directory: "mcp-server"
+  },
+  bin: {
+    "langwatch-mcp-server": "./dist/index.js"
+  },
+  type: "module",
+  main: "./dist/index.js",
+  module: "./dist/index.js",
+  types: "./dist/index.d.ts",
+  exports: {
+    ".": {
+      import: "./dist/index.js"
+    },
+    "./create-mcp-server": {
+      types: "./src/create-mcp-server.d.ts",
+      import: "./dist/create-mcp-server.js",
+      require: "./dist/create-mcp-server.cjs",
+      default: "./dist/create-mcp-server.js"
+    },
+    "./config": {
+      types: "./src/config.d.ts",
+      import: "./dist/config.js",
+      require: "./dist/config.cjs",
+      default: "./dist/config.js"
+    }
+  },
+  scripts: {
+    start: "node --experimental-transform-types src/index.ts",
+    build: "tsup && node build.js",
+    typecheck: "GOMAXPROCS=2 GOMEMLIMIT=2GiB pnpm -w exec tsc -b mcp/typescript",
+    prepublish: "pnpm run build",
+    test: "vitest run",
+    "test:integration": "vitest run --config vitest.integration.config.js",
+    "test:scenario": "vitest run --config vitest.scenario.config.js"
+  },
+  dependencies: {
+    "@langwatch/evaluator-contract": "workspace:*",
+    "@modelcontextprotocol/sdk": "catalog:",
+    zod: "catalog:"
+  },
+  devDependencies: {
+    "@ai-sdk/anthropic": "catalog:",
+    "@anthropic-ai/claude-code": "2.1.228",
+    "@langwatch/egress": "workspace:*",
+    "@langwatch/handled-error": "workspace:*",
+    "@langwatch/redaction": "workspace:*",
+    "@langwatch/scenario": "catalog:",
+    "@types/debug": "catalog:",
+    "@types/express": "^5.0.6",
+    "@types/node": "catalog:",
+    "@types/yargs": "^17.0.33",
+    ai: "catalog:",
+    chalk: "catalog:",
+    dotenv: "catalog:",
+    esbuild: "catalog:",
+    express: "^5.2.1",
+    "node-pty": "catalog:",
+    tsup: "catalog:",
+    typescript: "catalog:sdk-toolchain",
+    vitest: "catalog:",
+    yargs: "^18.0.0",
+    "zod-validation-error": "catalog:"
+  },
+  engines: {
+    node: "^22.23.4 || ^24.22.1 || >=26.12.1"
+  }
+};
+
+// src/langwatch-api.ts
+var MCP_IDENTITY_HEADERS = {
+  "User-Agent": `langwatch-mcp/${package_default.version}`,
+  "X-LangWatch-SDK-Name": "langwatch-mcp",
+  "X-LangWatch-SDK-Language": "typescript",
+  "X-LangWatch-SDK-Version": package_default.version
+};
+var LANGWATCH_API_VERSION = "2026-10-26";
+var HOSTED_MCP_HEADER = "X-LangWatch-MCP-Host";
+var LangWatchApiError = class extends Error {
+  constructor(message, status, responseBody, options = {}) {
+    super(message);
+    this.status = status;
+    this.responseBody = responseBody;
+    this.name = "LangWatchApiError";
+    this.code = options.code;
+    this.tips = options.tips;
+    this.docsUrl = options.docsUrl;
+    this.fault = options.fault;
+    this.reasons = options.reasons;
+  }
+  status;
+  responseBody;
+  code;
+  tips;
+  docsUrl;
+  fault;
+  /**
+   * The per-field failures behind this error, verbatim from the envelope. A validation failure
+   * carries the offending field and the values it would have accepted here — the difference
+   * between an agent correcting its own request and an agent guessing again.
+   */
+  reasons;
+};
+var VALID_FAULTS = [
+  "customer",
+  "platform",
+  "provider",
+  "presumed_platform"
+];
+function parseErrorBody(responseBody) {
+  try {
+    const parsed = JSON.parse(responseBody);
+    if (!isRecord(parsed)) return {};
+    const envelope = parsed;
+    const nestedValue = envelope.error;
+    const nested = isRecord(nestedValue) ? nestedValue : null;
+    const body = nested ?? envelope;
+    const code = readErrorCode(body);
+    const message = typeof body.message === "string" ? body.message : void 0;
+    if (code === void 0 && message === void 0) {
+      return {};
+    }
+    const tips = readStringArray(body.tips);
+    const docsUrl = typeof body.docsUrl === "string" ? body.docsUrl : void 0;
+    const fault = VALID_FAULTS.includes(body.fault) ? body.fault : void 0;
+    const reasons = Array.isArray(body.reasons) && body.reasons.every((r) => !!r && typeof r === "object") ? body.reasons : void 0;
+    return { code, message, tips, docsUrl, fault, reasons };
+  } catch {
+    return {};
+  }
+}
+function isRecord(value) {
+  return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+function readErrorCode(body) {
+  if (typeof body.code === "string") return body.code;
+  if (typeof body.error === "string") return body.error;
+  return void 0;
+}
+function readStringArray(value) {
+  if (!Array.isArray(value) || !value.every(isString)) return void 0;
+  return value;
+}
+function isString(value) {
+  return typeof value === "string";
+}
+function describeReason(reason) {
+  const meta = reason.meta;
+  if (!meta || typeof meta !== "object") return null;
+  const field = typeof meta.field === "string" ? meta.field : null;
+  if (!field) return null;
+  const parts = [`- ${field}`];
+  if (meta.received !== void 0) {
+    parts.push(`received ${JSON.stringify(meta.received)}`);
+  }
+  if (Array.isArray(meta.expected) && meta.expected.length > 0) {
+    parts.push(`expected one of: ${meta.expected.join(", ")}`);
+  }
+  return parts.join(" \u2014 ");
+}
+async function makeRequest(method, path, body) {
+  const config = getConfig();
+  const url = config.endpoint + path;
+  const headers = {
+    ...MCP_IDENTITY_HEADERS,
+    "X-API-Version": LANGWATCH_API_VERSION,
+    "X-Auth-Token": requireApiKey()
+  };
+  if (config.projectId) {
+    headers["X-Project-Id"] = config.projectId;
+  }
+  if (config.hosted) {
+    headers[HOSTED_MCP_HEADER] = "hosted";
+  }
+  if (body !== void 0) {
+    headers["Content-Type"] = "application/json";
+  }
+  const response = await fetch(url, {
+    method,
+    headers,
+    ...body !== void 0 ? { body: JSON.stringify(body) } : {}
+  });
+  if (!response.ok) {
+    const responseBody = await response.text();
+    const parsed = parseErrorBody(responseBody);
+    const lines = [`LangWatch API error ${response.status}: ${parsed.message ?? responseBody}`];
+    const reasonLines = (parsed.reasons ?? []).map(describeReason).filter((line) => line !== null);
+    if (reasonLines.length > 0) {
+      lines.push("Rejected fields:", ...reasonLines);
+    }
+    if (parsed.tips && parsed.tips.length > 0) {
+      lines.push("Tips:", ...parsed.tips.map((tip) => `- ${tip}`));
+    }
+    if (parsed.docsUrl) {
+      lines.push(`Docs: ${parsed.docsUrl}`);
+    }
+    throw new LangWatchApiError(lines.join("\n"), response.status, responseBody, {
+      code: parsed.code,
+      tips: parsed.tips,
+      docsUrl: parsed.docsUrl,
+      fault: parsed.fault,
+      reasons: parsed.reasons
+    });
+  }
+  if (response.status === 204 || response.headers?.get("content-length") === "0") {
+    return null;
+  }
+  return response.json();
+}
+async function searchTraces(params) {
+  const { format = "digest", ...rest } = params;
+  return makeRequest("POST", "/api/v1/traces/search", {
+    ...rest,
+    format
+  });
+}
+async function getTraceById(traceId, format = "digest") {
+  return makeRequest(
+    "GET",
+    `/api/v1/traces/${encodeURIComponent(traceId)}?format=${format}`
+  );
+}
+async function getAnalyticsTimeseries(params) {
+  return makeRequest(
+    "POST",
+    "/api/v1/analytics/timeseries",
+    params
+  );
+}
+async function listPrompts() {
+  return makeRequest("GET", "/api/v1/prompts");
+}
+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/v1/prompts/${encodeURIComponent(idOrHandle)}${query}`
+  );
+}
+async function getPromptVersions(idOrHandle) {
+  return makeRequest(
+    "GET",
+    `/api/v1/prompts/${encodeURIComponent(idOrHandle)}/versions`
+  );
+}
+async function createPrompt(data) {
+  return makeRequest("POST", "/api/v1/prompts", data);
+}
+async function updatePrompt(idOrHandle, data) {
+  return makeRequest(
+    "PUT",
+    `/api/v1/prompts/${encodeURIComponent(idOrHandle)}`,
+    data
+  );
+}
+async function assignPromptTag({
+  idOrHandle,
+  tag,
+  versionId
+}) {
+  return makeRequest(
+    "PUT",
+    `/api/v1/prompts/${encodeURIComponent(idOrHandle)}/tags/${encodeURIComponent(tag)}`,
+    { versionId }
+  );
+}
+async function listPromptTags() {
+  return makeRequest("GET", "/api/v1/prompts/tags");
+}
+async function createPromptTag(name) {
+  return makeRequest("POST", "/api/v1/prompts/tags", { name });
+}
+async function renamePromptTag({
+  tag,
+  name
+}) {
+  return makeRequest("PUT", `/api/v1/prompts/tags/${encodeURIComponent(tag)}`, { name });
+}
+async function deletePromptTag(tag) {
+  return makeRequest("DELETE", `/api/v1/prompts/tags/${encodeURIComponent(tag)}`);
+}
+
+export {
+  package_default,
+  LANGWATCH_API_VERSION,
+  LangWatchApiError,
+  makeRequest,
+  searchTraces,
+  getTraceById,
+  getAnalyticsTimeseries,
+  listPrompts,
+  getPrompt,
+  getPromptVersions,
+  createPrompt,
+  updatePrompt,
+  assignPromptTag,
+  listPromptTags,
+  createPromptTag,
+  renamePromptTag,
+  deletePromptTag
+};
+//# sourceMappingURL=chunk-7CZQDZ2K.js.map

package/dist/{chunk-RVAE2MEA.js → chunk-7GETGE6B.js}

@@ -1,32 +1,32 @@
 import {
   makeRequest
-} from "./chunk-GELJ2MQR.js";
+} from "./chunk-7CZQDZ2K.js";
 
 // src/langwatch-api-scenarios.ts
 async function listScenarios() {
-  return makeRequest("GET", "/api/scenarios");
+  return makeRequest("GET", "/api/v1/scenarios");
 }
 async function getScenario(id) {
   return makeRequest(
     "GET",
-    `/api/scenarios/${encodeURIComponent(id)}`
+    `/api/v1/scenarios/${encodeURIComponent(id)}`
   );
 }
 async function createScenario(data) {
-  return makeRequest("POST", "/api/scenarios", data);
+  return makeRequest("POST", "/api/v1/scenarios", data);
 }
 async function updateScenario(params) {
   const { id, ...data } = params;
   return makeRequest(
     "PUT",
-    `/api/scenarios/${encodeURIComponent(id)}`,
+    `/api/v1/scenarios/${encodeURIComponent(id)}`,
     data
   );
 }
 async function archiveScenario(id) {
   return makeRequest(
     "DELETE",
-    `/api/scenarios/${encodeURIComponent(id)}`
+    `/api/v1/scenarios/${encodeURIComponent(id)}`
   );
 }
 
@@ -37,4 +37,4 @@ export {
   updateScenario,
   archiveScenario
 };
-//# sourceMappingURL=chunk-RVAE2MEA.js.map
+//# sourceMappingURL=chunk-7GETGE6B.js.map

package/dist/{chunk-OJLYYJWI.js → chunk-AASW2TO2.js}

@@ -1,36 +1,33 @@
 import {
   makeRequest
-} from "./chunk-GELJ2MQR.js";
+} from "./chunk-7CZQDZ2K.js";
 
 // src/langwatch-api-evaluators.ts
 function getEvaluatorType(evaluator) {
   return evaluator.config?.evaluatorType;
 }
 async function listEvaluators() {
-  return makeRequest("GET", "/api/evaluators");
+  return makeRequest("GET", "/api/v1/evaluators");
 }
 async function getEvaluator(idOrSlug) {
   return makeRequest(
     "GET",
-    `/api/evaluators/${encodeURIComponent(idOrSlug)}`
+    `/api/v1/evaluators/${encodeURIComponent(idOrSlug)}`
   );
 }
 async function createEvaluator(data) {
-  return makeRequest("POST", "/api/evaluators", data);
+  return makeRequest("POST", "/api/v1/evaluators", data);
 }
 async function updateEvaluator(params) {
   const { id, ...data } = params;
   return makeRequest(
     "PUT",
-    `/api/evaluators/${encodeURIComponent(id)}`,
+    `/api/v1/evaluators/${encodeURIComponent(id)}`,
     data
   );
 }
 async function deleteEvaluator(idOrSlug) {
-  return makeRequest(
-    "DELETE",
-    `/api/evaluators/${encodeURIComponent(idOrSlug)}`
-  );
+  return makeRequest("DELETE", `/api/v1/evaluators/${encodeURIComponent(idOrSlug)}`);
 }
 
 export {
@@ -41,4 +38,4 @@ export {
   updateEvaluator,
   deleteEvaluator
 };
-//# sourceMappingURL=chunk-OJLYYJWI.js.map
+//# sourceMappingURL=chunk-AASW2TO2.js.map

package/dist/{chunk-QAMP3CGR.js → chunk-B4RFWIUP.js}

@@ -1,6 +1,6 @@
 import {
   makeRequest
-} from "./chunk-GELJ2MQR.js";
+} from "./chunk-7CZQDZ2K.js";
 
 // src/langwatch-api-simulation-runs.ts
 async function listSimulationRuns(params) {
@@ -9,12 +9,12 @@ async function listSimulationRuns(params) {
   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}`);
+  return makeRequest("GET", `/api/v1/simulation-runs${qs}`);
 }
 async function getSimulationRun(scenarioRunId) {
   return makeRequest(
     "GET",
-    `/api/simulation-runs/${encodeURIComponent(scenarioRunId)}`
+    `/api/v1/simulation-runs/${encodeURIComponent(scenarioRunId)}`
   );
 }
 
@@ -22,4 +22,4 @@ export {
   listSimulationRuns,
   getSimulationRun
 };
-//# sourceMappingURL=chunk-QAMP3CGR.js.map
+//# sourceMappingURL=chunk-B4RFWIUP.js.map

package/dist/{chunk-ZXKLPC2E.js → chunk-BIIKE3EI.js}

@@ -24,4 +24,4 @@ function parseRelativeDate(input) {
 export {
   parseRelativeDate
 };
-//# sourceMappingURL=chunk-ZXKLPC2E.js.map
+//# sourceMappingURL=chunk-BIIKE3EI.js.map

package/dist/{chunk-G4ZAZTZW.js → chunk-D2HS73VI.js}

@@ -1,6 +1,6 @@
 import {
   makeRequest
-} from "./chunk-GELJ2MQR.js";
+} from "./chunk-7CZQDZ2K.js";
 
 // src/langwatch-api-projects.ts
 async function listProjects(params) {
@@ -8,30 +8,27 @@ async function listProjects(params) {
   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/projects${qs}`);
+  return makeRequest("GET", `/api/v1/projects${qs}`);
 }
 async function getProject(id) {
   return makeRequest(
     "GET",
-    `/api/projects/${encodeURIComponent(id)}`
+    `/api/v1/projects/${encodeURIComponent(id)}`
   );
 }
 async function createProject(data) {
-  return makeRequest("POST", "/api/projects", data);
+  return makeRequest("POST", "/api/v1/projects", data);
 }
 async function updateProject(params) {
   const { id, ...data } = params;
   return makeRequest(
     "PATCH",
-    `/api/projects/${encodeURIComponent(id)}`,
+    `/api/v1/projects/${encodeURIComponent(id)}`,
     data
   );
 }
 async function archiveProject(id) {
-  return makeRequest(
-    "DELETE",
-    `/api/projects/${encodeURIComponent(id)}`
-  );
+  return makeRequest("DELETE", `/api/v1/projects/${encodeURIComponent(id)}`);
 }
 
 export {
@@ -41,4 +38,4 @@ export {
   updateProject,
   archiveProject
 };
-//# sourceMappingURL=chunk-G4ZAZTZW.js.map
+//# sourceMappingURL=chunk-D2HS73VI.js.map

package/dist/{chunk-37SMPMQS.js → chunk-DMM3JQ42.js}

@@ -1,7 +1,12 @@
 // src/utils/format-evaluations.ts
 function formatEvaluationLines(evaluations) {
   return evaluations.map((evaluation) => {
-    const status = evaluation.passed === true ? "PASSED" : evaluation.passed === false ? "FAILED" : "N/A";
+    let status = "N/A";
+    if (evaluation.passed === true) {
+      status = "PASSED";
+    } else if (evaluation.passed === false) {
+      status = "FAILED";
+    }
     return `- **${evaluation.name || evaluation.evaluator_id}**: ${status}${evaluation.score != null ? ` (score: ${evaluation.score})` : ""}${evaluation.label ? ` [${evaluation.label}]` : ""}`;
   });
 }
@@ -9,4 +14,4 @@ function formatEvaluationLines(evaluations) {
 export {
   formatEvaluationLines
 };
-//# sourceMappingURL=chunk-37SMPMQS.js.map
+//# sourceMappingURL=chunk-DMM3JQ42.js.map

package/dist/{chunk-WT4PO4A3.js → chunk-DULFP3MK.js}

@@ -33,21 +33,23 @@ function initConfig(args) {
   state.globalConfig = {
     apiKey: args.apiKey || process.env.LANGWATCH_API_KEY,
     endpoint: normalizeEndpoint(args.endpoint ?? "") || normalizeEndpoint(process.env.LANGWATCH_ENDPOINT ?? "") || "https://app.langwatch.ai",
-    projectId: process.env.LANGWATCH_PROJECT_ID
+    projectId: args.projectId ?? process.env.LANGWATCH_PROJECT_ID
   };
 }
-function getConfig() {
+function tryGetConfig() {
   const state = getGlobalState();
-  const scoped = state.configStorage.getStore();
-  if (scoped) return scoped;
-  if (!state.globalConfig) {
+  return state.configStorage.getStore() ?? state.globalConfig;
+}
+function getConfig() {
+  const config = tryGetConfig();
+  if (!config) {
     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;
+  return config;
 }
 function requireApiKey() {
   const config = getConfig();
@@ -71,8 +73,9 @@ function runWithConfig(config, fn) {
 
 export {
   initConfig,
+  tryGetConfig,
   getConfig,
   requireApiKey,
   runWithConfig
 };
-//# sourceMappingURL=chunk-WT4PO4A3.js.map
+//# sourceMappingURL=chunk-DULFP3MK.js.map