@langwatch/mcp-server 0.6.1 → 0.7.0

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## [0.7.0](https://github.com/langwatch/langwatch/compare/mcp-server@v0.6.1...mcp-server@v0.7.0) (2026-04-16)
+
+
+### Features
+
+* add mcp-server to langwatch pnpm workspace ([#3069](https://github.com/langwatch/langwatch/issues/3069)) ([73915d2](https://github.com/langwatch/langwatch/commit/73915d24fd47b8d6b5e33210fd3f73ac0f745e11))
+* add prompt tag support to MCP tools, docs, and skills ([#2934](https://github.com/langwatch/langwatch/issues/2934)) ([858e0d7](https://github.com/langwatch/langwatch/commit/858e0d7df3df8c70822e2155a73453bf1a6fd324))
+* full CLI, API, and MCP coverage for all platform features ([#3168](https://github.com/langwatch/langwatch/issues/3168)) ([921b7b9](https://github.com/langwatch/langwatch/commit/921b7b92d3ccc038556fe2241a3a90302786631e))
+* **mcp-server:** oauth 2.0 + SSE client compatibility ([#2557](https://github.com/langwatch/langwatch/issues/2557)) ([7327579](https://github.com/langwatch/langwatch/commit/73275796aca80b90c4d78beb9033e33b0e4a8da9))
+* **mcp:** add dataset mcp tools ([#2926](https://github.com/langwatch/langwatch/issues/2926)) ([666710c](https://github.com/langwatch/langwatch/commit/666710cbb1052f9b7180378a7c24490e4a103b9f))
+* **mcp:** mount MCP HTTP server in-app with OAuth PKCE authorization ([#2847](https://github.com/langwatch/langwatch/issues/2847)) ([9d57dd8](https://github.com/langwatch/langwatch/commit/9d57dd877f80ba529d32879a387d4f4d0d0216b6))
+* **skills:** agent skills-based onboarding with feature map and scenario tests ([#2377](https://github.com/langwatch/langwatch/issues/2377)) ([6f6abdb](https://github.com/langwatch/langwatch/commit/6f6abdb67b97fcb7c2958dbc193dcde37d4c82a8))
+
+
+### Bug Fixes
+
+* analytics groupBy returns empty in MCP tool and trigger alerts ([#3012](https://github.com/langwatch/langwatch/issues/3012)) ([634db38](https://github.com/langwatch/langwatch/commit/634db380de35132b6ed88ce04e3998a3229f90db))
+* **mcp:** build config and create-mcp-server with tsup to fix dual-module bug ([640c2e4](https://github.com/langwatch/langwatch/commit/640c2e42024cc40b0b02c1abac4cf07f6881f497))
+* **mcp:** build subexports with tsup to eliminate dual-module bug ([#2985](https://github.com/langwatch/langwatch/issues/2985)) ([640c2e4](https://github.com/langwatch/langwatch/commit/640c2e42024cc40b0b02c1abac4cf07f6881f497))
+* **mcp:** resolve dual-module config bug causing "Config not initialized" in production ([fcf0e0b](https://github.com/langwatch/langwatch/commit/fcf0e0b0f85bfc6b10a26ac917fe2c3f0335771d))
+* **mcp:** resolve dual-module config bug in production ([#2956](https://github.com/langwatch/langwatch/issues/2956)) ([fcf0e0b](https://github.com/langwatch/langwatch/commit/fcf0e0b0f85bfc6b10a26ac917fe2c3f0335771d))
+* **mcp:** use globalThis for config singleton to fix CJS/ESM dual cache ([#3123](https://github.com/langwatch/langwatch/issues/3123)) ([a7ece22](https://github.com/langwatch/langwatch/commit/a7ece22144b67dcd5318d9abdd5d3ba66464bbb7))
+
 ## [0.6.1](https://github.com/langwatch/langwatch/compare/mcp-server@v0.6.0...mcp-server@v0.6.1) (2026-03-13)
 
 

package/Dockerfile

@@ -0,0 +1,22 @@
+FROM node:24-alpine
+
+# node-pty requires native compilation tools
+RUN apk add --no-cache python3 make g++
+
+RUN corepack enable && corepack prepare pnpm@10 --activate
+
+WORKDIR /app
+
+# Build from repo root: docker build -t langwatch-mcp -f mcp-server/Dockerfile .
+COPY mcp-server/package.json mcp-server/pnpm-lock.yaml mcp-server/pnpm-workspace.yaml ./mcp-server/
+WORKDIR /app/mcp-server
+RUN pnpm install --frozen-lockfile
+
+WORKDIR /app
+COPY mcp-server/ ./mcp-server/
+COPY langevals/ ./langevals/
+
+EXPOSE 3000
+
+WORKDIR /app/mcp-server
+CMD ["node", "--import", "tsx/esm", "src/index.ts", "--http", "--port", "3000"]

package/README.md

@@ -1,6 +1,6 @@
 # LangWatch MCP Server
 
-MCP server that gives AI coding agents access to LangWatch observability data, prompts, and documentation via the [Model Context Protocol](https://modelcontextprotocol.io/introduction).
+MCP server that gives AI coding agents access to LangWatch observability data, prompts, datasets, scenarios, evaluators, and documentation via the [Model Context Protocol](https://modelcontextprotocol.io/introduction).
 
 ## Quick Setup
 
@@ -57,17 +57,58 @@ The API key is required for observability and prompt tools. Documentation tools
 
 | Tool | Description |
 |------|-------------|
-| `list_prompts` | List all prompts |
-| `get_prompt` | Get prompt with messages and version history |
-| `create_prompt` | Create a new prompt |
-| `update_prompt` | Update prompt or create new version |
+| `platform_list_prompts` | List all prompts |
+| `platform_get_prompt` | Get prompt with messages and version history |
+| `platform_create_prompt` | Create a new prompt |
+| `platform_update_prompt` | Update prompt or create new version |
+
+### Datasets (requires API key)
+
+| Tool | Description |
+|------|-------------|
+| `platform_list_datasets` | List all datasets with record counts |
+| `platform_get_dataset` | Get dataset metadata, columns, and record preview |
+| `platform_create_dataset` | Create a new dataset with optional column definitions |
+| `platform_update_dataset` | Update dataset name or column types |
+| `platform_delete_dataset` | Archive a dataset |
+| `platform_create_dataset_records` | Add records to a dataset (max 1000 per call) |
+| `platform_update_dataset_record` | Update a single record |
+| `platform_delete_dataset_records` | Delete records by IDs (max 1000 per call) |
+
+### Scenarios (requires API key)
+
+| Tool | Description |
+|------|-------------|
+| `platform_list_scenarios` | List all scenarios |
+| `platform_get_scenario` | Get scenario details |
+| `platform_create_scenario` | Create a new scenario |
+| `platform_update_scenario` | Update a scenario |
+| `platform_archive_scenario` | Archive a scenario |
+
+### Evaluators (requires API key)
+
+| Tool | Description |
+|------|-------------|
+| `platform_list_evaluators` | List all evaluators |
+| `platform_get_evaluator` | Get evaluator details |
+| `platform_create_evaluator` | Create a new evaluator |
+| `platform_update_evaluator` | Update an evaluator |
+
+### Model Providers (requires API key)
+
+| Tool | Description |
+|------|-------------|
+| `platform_list_model_providers` | List configured model providers |
+| `platform_set_model_provider` | Configure a model provider |
 
 ## Output Formats
 
-The `search_traces` and `get_trace` tools support a `format` parameter:
+Several tools support a `format` parameter:
+
+- **`digest`** (default) — AI-readable markdown output. Optimized for LLM consumption — compact and information-dense.
+- **`json`** — Full raw data. Useful for programmatic access or when you need the complete schema.
 
-- **`digest`** (default) — AI-readable trace digest with hierarchical span tree, timing, inputs/outputs, and errors. Optimized for LLM consumption — compact and information-dense.
-- **`json`** — Full raw trace data with all fields. Useful for programmatic access or when you need the complete schema.
+Supported on: `search_traces`, `get_trace`, `platform_list_datasets`, `platform_get_dataset`, `platform_list_scenarios`, `platform_get_scenario`.
 
 ## Usage Tips
 
@@ -76,6 +117,8 @@ The `search_traces` and `get_trace` tools support a `format` parameter:
 - Search returns 25 traces per page by default. Use `scrollId` from the response to paginate.
 - Analytics uses `category.name` format for metrics (e.g., `performance.completion_time`).
 - Use `create_prompt` / `update_prompt` with `createVersion: true` for safe prompt iteration.
+- Use `platform_list_datasets` then `platform_get_dataset` to browse dataset contents.
+- Dataset tools support full CRUD: create datasets, add/update/delete records, and archive datasets.
 
 ## Development
 

package/dist/{archive-scenario-YFD5THOR.js → archive-scenario-WJ2A7ETN.js}

@@ -1,8 +1,8 @@
 import {
   archiveScenario
-} from "./chunk-6U4TCGFC.js";
-import "./chunk-LLRQIF52.js";
-import "./chunk-AAQNA53E.js";
+} from "./chunk-2GT7IFWK.js";
+import "./chunk-2WPLXEKF.js";
+import "./chunk-BWWY5KEF.js";
 
 // src/tools/archive-scenario.ts
 async function handleArchiveScenario(params) {
@@ -16,4 +16,4 @@ async function handleArchiveScenario(params) {
 export {
   handleArchiveScenario
 };
-//# sourceMappingURL=archive-scenario-YFD5THOR.js.map
+//# sourceMappingURL=archive-scenario-WJ2A7ETN.js.map

package/dist/archive-suite-4JOM4SSL.js

@@ -0,0 +1,15 @@
+import {
+  archiveSuite
+} from "./chunk-LUMEZEHL.js";
+import "./chunk-2WPLXEKF.js";
+import "./chunk-BWWY5KEF.js";
+
+// src/tools/archive-suite.ts
+async function handleArchiveSuite(params) {
+  const result = await archiveSuite(params.id);
+  return `Suite ${result.id} has been archived (soft-deleted).`;
+}
+export {
+  handleArchiveSuite
+};
+//# sourceMappingURL=archive-suite-4JOM4SSL.js.map

package/dist/archive-suite-4JOM4SSL.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/archive-suite.ts"],"sourcesContent":["import { archiveSuite as apiArchiveSuite } from \"../langwatch-api-suites.js\";\n\n/**\n * Handles the platform_archive_suite MCP tool invocation.\n */\nexport async function handleArchiveSuite(params: {\n  id: string;\n}): Promise<string> {\n  const result = await apiArchiveSuite(params.id);\n\n  return `Suite ${result.id} has been archived (soft-deleted).`;\n}\n"],"mappings":";;;;;;;AAKA,eAAsB,mBAAmB,QAErB;AAClB,QAAM,SAAS,MAAM,aAAgB,OAAO,EAAE;AAE9C,SAAO,SAAS,OAAO,EAAE;AAC3B;","names":[]}

package/dist/assign-prompt-tag-GL7EAAF3.js

@@ -0,0 +1,19 @@
+import {
+  assignPromptTag
+} from "./chunk-2WPLXEKF.js";
+import "./chunk-BWWY5KEF.js";
+
+// src/tools/assign-prompt-tag.ts
+async function handleAssignPromptTag(params) {
+  await assignPromptTag({ idOrHandle: params.idOrHandle, tag: params.tag, versionId: params.versionId });
+  const lines = [];
+  lines.push("Tag assigned successfully!\n");
+  lines.push(`**Prompt**: ${params.idOrHandle}`);
+  lines.push(`**Tag**: ${params.tag}`);
+  lines.push(`**Version ID**: ${params.versionId}`);
+  return lines.join("\n");
+}
+export {
+  handleAssignPromptTag
+};
+//# sourceMappingURL=assign-prompt-tag-GL7EAAF3.js.map

package/dist/assign-prompt-tag-GL7EAAF3.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/tools/assign-prompt-tag.ts"],"sourcesContent":["import { assignPromptTag as apiAssignPromptTag } from \"../langwatch-api.js\";\n\nexport async function handleAssignPromptTag(params: {\n  idOrHandle: string;\n  tag: string;\n  versionId: string;\n}): Promise<string> {\n  await apiAssignPromptTag({ idOrHandle: params.idOrHandle, tag: params.tag, versionId: params.versionId });\n\n  const lines: string[] = [];\n  lines.push(\"Tag assigned successfully!\\n\");\n  lines.push(`**Prompt**: ${params.idOrHandle}`);\n  lines.push(`**Tag**: ${params.tag}`);\n  lines.push(`**Version ID**: ${params.versionId}`);\n  return lines.join(\"\\n\");\n}\n"],"mappings":";;;;;;AAEA,eAAsB,sBAAsB,QAIxB;AAClB,QAAM,gBAAmB,EAAE,YAAY,OAAO,YAAY,KAAK,OAAO,KAAK,WAAW,OAAO,UAAU,CAAC;AAExG,QAAM,QAAkB,CAAC;AACzB,QAAM,KAAK,8BAA8B;AACzC,QAAM,KAAK,eAAe,OAAO,UAAU,EAAE;AAC7C,QAAM,KAAK,YAAY,OAAO,GAAG,EAAE;AACnC,QAAM,KAAK,mBAAmB,OAAO,SAAS,EAAE;AAChD,SAAO,MAAM,KAAK,IAAI;AACxB;","names":[]}

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

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

package/dist/{chunk-LLRQIF52.js → chunk-2WPLXEKF.js}

@@ -1,7 +1,7 @@
 import {
   getConfig,
   requireApiKey
-} from "./chunk-AAQNA53E.js";
+} from "./chunk-BWWY5KEF.js";
 
 // src/langwatch-api.ts
 async function makeRequest(method, path, body) {
@@ -23,6 +23,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 +51,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 +75,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 +117,11 @@ export {
   listPrompts,
   getPrompt,
   createPrompt,
-  updatePrompt
+  updatePrompt,
+  assignPromptTag,
+  listPromptTags,
+  createPromptTag,
+  renamePromptTag,
+  deletePromptTag
 };
-//# sourceMappingURL=chunk-LLRQIF52.js.map
+//# sourceMappingURL=chunk-2WPLXEKF.js.map

package/dist/chunk-2WPLXEKF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/langwatch-api.ts"],"sourcesContent":["import { getConfig, requireApiKey } from \"./config.js\";\n\n// --- Response types ---\n\nexport interface TraceSearchResult {\n  trace_id: string;\n  formatted_trace?: string;\n  input?: { value: string };\n  output?: { value: string };\n  timestamps?: { started_at?: string | number };\n  metadata?: Record<string, unknown>;\n  error?: Record<string, unknown>;\n}\n\nexport interface SearchTracesResponse {\n  traces: TraceSearchResult[];\n  pagination?: {\n    totalHits?: number;\n    scrollId?: string;\n  };\n}\n\nexport interface TraceDetailResponse {\n  trace_id: string;\n  formatted_trace?: string;\n  input?: { value: string };\n  output?: { value: string };\n  timestamps?: {\n    started_at?: string | number;\n    updated_at?: string | number;\n    inserted_at?: string | number;\n  };\n  metadata?: {\n    user_id?: string;\n    thread_id?: string;\n    customer_id?: string;\n    labels?: string[];\n    [key: string]: unknown;\n  };\n  error?: Record<string, unknown>;\n  ascii_tree?: string;\n  evaluations?: Array<{\n    evaluator_id?: string;\n    name?: string;\n    score?: number;\n    passed?: boolean;\n    label?: string;\n  }>;\n  spans?: Array<{\n    span_id: string;\n    name?: string;\n    type?: string;\n    model?: string;\n    input?: { value: string };\n    output?: { value: string };\n    timestamps?: { started_at?: number; finished_at?: number };\n    metrics?: {\n      completion_time_ms?: number;\n      prompt_tokens?: number;\n      completion_tokens?: number;\n      tokens_estimated?: boolean;\n      cost?: number;\n    };\n  }>;\n}\n\nexport interface AnalyticsBucket {\n  date: string;\n  [key: string]: unknown;\n}\n\nexport interface AnalyticsTimeseriesResponse {\n  currentPeriod: AnalyticsBucket[];\n  previousPeriod: AnalyticsBucket[];\n}\n\nexport interface PromptSummary {\n  id?: string;\n  handle?: string;\n  name?: string;\n  latestVersionNumber?: number;\n  version?: number;\n}\n\nexport interface PromptVersion {\n  version?: number;\n  commitMessage?: string;\n  model?: string;\n  messages?: Array<{ role: string; content: string }>;\n}\n\nexport interface PromptDetailResponse extends PromptSummary {\n  versions?: PromptVersion[];\n  model?: string;\n  messages?: Array<{ role: string; content: string }>;\n  prompt?: Array<{ role: string; content: string }>;\n}\n\nexport interface PromptMutationResponse {\n  id?: string;\n  handle?: string;\n  name?: string;\n  latestVersionNumber?: number;\n}\n\n// --- HTTP client ---\n\n/**\n * Sends an HTTP request to the LangWatch API.\n *\n * Builds the full URL from the configured endpoint, adds authentication,\n * and handles JSON serialization/deserialization.\n *\n * @throws Error with status code and response body when the response is not OK\n */\nexport async function makeRequest(\n  method: \"GET\" | \"POST\" | \"PUT\" | \"PATCH\" | \"DELETE\",\n  path: string,\n  body?: unknown\n): Promise<unknown> {\n  const url = getConfig().endpoint + path;\n  const headers: Record<string, string> = {\n    \"X-Auth-Token\": requireApiKey(),\n  };\n\n  if (body !== undefined) {\n    headers[\"Content-Type\"] = \"application/json\";\n  }\n\n  const response = await fetch(url, {\n    method,\n    headers,\n    ...(body !== undefined ? { body: JSON.stringify(body) } : {}),\n  });\n\n  if (!response.ok) {\n    const responseBody = await response.text();\n    throw new Error(\n      `LangWatch API error ${response.status}: ${responseBody}`\n    );\n  }\n\n  if (response.status === 204 || response.headers?.get(\"content-length\") === \"0\") {\n    return null;\n  }\n  return response.json();\n}\n\n/** Searches traces with optional filters and pagination. */\nexport async function searchTraces(params: {\n  query?: string;\n  filters?: Record<string, string[]>;\n  startDate: number;\n  endDate: number;\n  pageSize?: number;\n  pageOffset?: number;\n  scrollId?: string;\n  format?: \"digest\" | \"json\";\n}): Promise<SearchTracesResponse> {\n  const { format = \"digest\", ...rest } = params;\n  return makeRequest(\"POST\", \"/api/traces/search\", {\n    ...rest,\n    format,\n  }) as Promise<SearchTracesResponse>;\n}\n\n/** Retrieves a single trace by its ID. */\nexport async function getTraceById(\n  traceId: string,\n  format: \"digest\" | \"json\" = \"digest\"\n): Promise<TraceDetailResponse> {\n  return makeRequest(\n    \"GET\",\n    `/api/traces/${encodeURIComponent(traceId)}?format=${format}`\n  ) as Promise<TraceDetailResponse>;\n}\n\n/** Fetches analytics timeseries data for the given metrics and date range. */\nexport async function getAnalyticsTimeseries(params: {\n  series: Array<{\n    metric: string;\n    aggregation: string;\n    key?: string;\n    subkey?: string;\n  }>;\n  startDate: number;\n  endDate: number;\n  timeZone?: string;\n  groupBy?: string;\n  groupByKey?: string;\n  filters?: Record<string, string[]>;\n}): Promise<AnalyticsTimeseriesResponse> {\n  return makeRequest(\n    \"POST\",\n    \"/api/analytics/timeseries\",\n    params\n  ) as Promise<AnalyticsTimeseriesResponse>;\n}\n\n/** Lists all prompts in the project. */\nexport async function listPrompts(): Promise<PromptSummary[]> {\n  return makeRequest(\"GET\", \"/api/prompts\") as Promise<PromptSummary[]>;\n}\n\n/** Retrieves a single prompt by ID or handle. */\nexport async function getPrompt(\n  idOrHandle: string,\n  options?: { version?: number; tag?: string }\n): Promise<PromptDetailResponse> {\n  const params = new URLSearchParams();\n  if (options?.version != null) params.set(\"version\", String(options.version));\n  if (options?.tag) params.set(\"tag\", options.tag);\n  const query = params.toString() ? `?${params}` : \"\";\n  return makeRequest(\n    \"GET\",\n    `/api/prompts/${encodeURIComponent(idOrHandle)}${query}`\n  ) as Promise<PromptDetailResponse>;\n}\n\n/** Creates a new prompt. */\nexport async function createPrompt(data: {\n  handle: string;\n  messages: Array<{ role: string; content: string }>;\n  model: string;\n  tags?: string[];\n}): Promise<PromptMutationResponse> {\n  return makeRequest(\n    \"POST\",\n    \"/api/prompts\",\n    data\n  ) as Promise<PromptMutationResponse>;\n}\n\n/** Updates an existing prompt by ID or handle. */\nexport async function updatePrompt(\n  idOrHandle: string,\n  data: {\n    messages?: Array<{ role: string; content: string }>;\n    model?: string;\n    commitMessage: string;\n    tags?: string[];\n  }\n): Promise<PromptMutationResponse> {\n  return makeRequest(\n    \"PUT\",\n    `/api/prompts/${encodeURIComponent(idOrHandle)}`,\n    data\n  ) as Promise<PromptMutationResponse>;\n}\n\n/** Assigns a tag to a specific prompt version. */\nexport async function assignPromptTag({\n  idOrHandle,\n  tag,\n  versionId,\n}: {\n  idOrHandle: string;\n  tag: string;\n  versionId: string;\n}): Promise<unknown> {\n  return makeRequest(\n    \"PUT\",\n    `/api/prompts/${encodeURIComponent(idOrHandle)}/tags/${encodeURIComponent(tag)}`,\n    { versionId }\n  );\n}\n\n/** Lists all prompt tag definitions for the organization. */\nexport async function listPromptTags(): Promise<unknown> {\n  return makeRequest(\"GET\", \"/api/prompts/tags\");\n}\n\n/** Creates a custom prompt tag definition. */\nexport async function createPromptTag(name: string): Promise<unknown> {\n  return makeRequest(\"POST\", \"/api/prompts/tags\", { name });\n}\n\n/** Renames an existing prompt tag. */\nexport async function renamePromptTag({\n  tag,\n  name,\n}: {\n  tag: string;\n  name: string;\n}): Promise<unknown> {\n  return makeRequest(\n    \"PUT\",\n    `/api/prompts/tags/${encodeURIComponent(tag)}`,\n    { name }\n  );\n}\n\n/** Deletes a prompt tag and all its assignments. */\nexport async function deletePromptTag(tag: string): Promise<unknown> {\n  return makeRequest(\n    \"DELETE\",\n    `/api/prompts/tags/${encodeURIComponent(tag)}`\n  );\n}\n"],"mappings":";;;;;;AAmHA,eAAsB,YACpB,QACA,MACA,MACkB;AAClB,QAAM,MAAM,UAAU,EAAE,WAAW;AACnC,QAAM,UAAkC;AAAA,IACtC,gBAAgB,cAAc;AAAA,EAChC;AAEA,MAAI,SAAS,QAAW;AACtB,YAAQ,cAAc,IAAI;AAAA,EAC5B;AAEA,QAAM,WAAW,MAAM,MAAM,KAAK;AAAA,IAChC;AAAA,IACA;AAAA,IACA,GAAI,SAAS,SAAY,EAAE,MAAM,KAAK,UAAU,IAAI,EAAE,IAAI,CAAC;AAAA,EAC7D,CAAC;AAED,MAAI,CAAC,SAAS,IAAI;AAChB,UAAM,eAAe,MAAM,SAAS,KAAK;AACzC,UAAM,IAAI;AAAA,MACR,uBAAuB,SAAS,MAAM,KAAK,YAAY;AAAA,IACzD;AAAA,EACF;AAEA,MAAI,SAAS,WAAW,OAAO,SAAS,SAAS,IAAI,gBAAgB,MAAM,KAAK;AAC9E,WAAO;AAAA,EACT;AACA,SAAO,SAAS,KAAK;AACvB;AAGA,eAAsB,aAAa,QASD;AAChC,QAAM,EAAE,SAAS,UAAU,GAAG,KAAK,IAAI;AACvC,SAAO,YAAY,QAAQ,sBAAsB;AAAA,IAC/C,GAAG;AAAA,IACH;AAAA,EACF,CAAC;AACH;AAGA,eAAsB,aACpB,SACA,SAA4B,UACE;AAC9B,SAAO;AAAA,IACL;AAAA,IACA,eAAe,mBAAmB,OAAO,CAAC,WAAW,MAAM;AAAA,EAC7D;AACF;AAGA,eAAsB,uBAAuB,QAaJ;AACvC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGA,eAAsB,cAAwC;AAC5D,SAAO,YAAY,OAAO,cAAc;AAC1C;AAGA,eAAsB,UACpB,YACA,SAC+B;AAC/B,QAAM,SAAS,IAAI,gBAAgB;AACnC,MAAI,SAAS,WAAW,KAAM,QAAO,IAAI,WAAW,OAAO,QAAQ,OAAO,CAAC;AAC3E,MAAI,SAAS,IAAK,QAAO,IAAI,OAAO,QAAQ,GAAG;AAC/C,QAAM,QAAQ,OAAO,SAAS,IAAI,IAAI,MAAM,KAAK;AACjD,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,mBAAmB,UAAU,CAAC,GAAG,KAAK;AAAA,EACxD;AACF;AAGA,eAAsB,aAAa,MAKC;AAClC,SAAO;AAAA,IACL;AAAA,IACA;AAAA,IACA;AAAA,EACF;AACF;AAGA,eAAsB,aACpB,YACA,MAMiC;AACjC,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,mBAAmB,UAAU,CAAC;AAAA,IAC9C;AAAA,EACF;AACF;AAGA,eAAsB,gBAAgB;AAAA,EACpC;AAAA,EACA;AAAA,EACA;AACF,GAIqB;AACnB,SAAO;AAAA,IACL;AAAA,IACA,gBAAgB,mBAAmB,UAAU,CAAC,SAAS,mBAAmB,GAAG,CAAC;AAAA,IAC9E,EAAE,UAAU;AAAA,EACd;AACF;AAGA,eAAsB,iBAAmC;AACvD,SAAO,YAAY,OAAO,mBAAmB;AAC/C;AAGA,eAAsB,gBAAgB,MAAgC;AACpE,SAAO,YAAY,QAAQ,qBAAqB,EAAE,KAAK,CAAC;AAC1D;AAGA,eAAsB,gBAAgB;AAAA,EACpC;AAAA,EACA;AACF,GAGqB;AACnB,SAAO;AAAA,IACL;AAAA,IACA,qBAAqB,mBAAmB,GAAG,CAAC;AAAA,IAC5C,EAAE,KAAK;AAAA,EACT;AACF;AAGA,eAAsB,gBAAgB,KAA+B;AACnE,SAAO;AAAA,IACL;AAAA,IACA,qBAAqB,mBAAmB,GAAG,CAAC;AAAA,EAC9C;AACF;","names":[]}

package/dist/chunk-4AUB2BIA.js

@@ -0,0 +1,71 @@
+import {
+  makeRequest
+} from "./chunk-2WPLXEKF.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-VJRIIDZ7.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-4AUB2BIA.js.map

package/dist/chunk-4AUB2BIA.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/langwatch-api-agents.ts"],"sourcesContent":["import { makeRequest } from \"./langwatch-api.js\";\n\nexport interface AgentSummary {\n  id: string;\n  name: string;\n  type: string;\n  config: Record<string, unknown> | null;\n  createdAt: string;\n  updatedAt: string;\n}\n\nexport interface AgentListResponse {\n  data: AgentSummary[];\n  pagination: {\n    page: number;\n    limit: number;\n    total: number;\n    totalPages: number;\n  };\n}\n\nexport async function listAgents(params?: {\n  page?: number;\n  limit?: number;\n}): Promise<AgentListResponse> {\n  const query = new URLSearchParams();\n  if (params?.page) query.set(\"page\", String(params.page));\n  if (params?.limit) query.set(\"limit\", String(params.limit));\n  const qs = query.toString() ? `?${query}` : \"\";\n  return makeRequest(\"GET\", `/api/agents${qs}`) as Promise<AgentListResponse>;\n}\n\nexport async function getAgent(id: string): Promise<AgentSummary> {\n  return makeRequest(\n    \"GET\",\n    `/api/agents/${encodeURIComponent(id)}`,\n  ) as Promise<AgentSummary>;\n}\n\nexport async function createAgent(data: {\n  name: string;\n  type: string;\n  config: Record<string, unknown>;\n}): Promise<AgentSummary> {\n  return makeRequest(\"POST\", \"/api/agents\", data) as Promise<AgentSummary>;\n}\n\nexport async function updateAgent(params: {\n  id: string;\n  name?: string;\n  type?: string;\n  config?: Record<string, unknown>;\n}): Promise<AgentSummary> {\n  const { id, ...data } = params;\n  return makeRequest(\n    \"PATCH\",\n    `/api/agents/${encodeURIComponent(id)}`,\n    data,\n  ) as Promise<AgentSummary>;\n}\n\n/**\n * Run an agent. For HTTP agents, calls the configured URL directly.\n * For workflow-linked agents, calls the workflow run endpoint.\n */\nexport async function runAgent(\n  id: string,\n  input?: Record<string, unknown>,\n): Promise<{ agentType: string; result: Record<string, unknown> }> {\n  const agent = await getAgent(id);\n  const config = agent.config ?? {};\n\n  if (agent.type === \"http\") {\n    const url = (config as Record<string, unknown>).url as string | undefined;\n    if (!url) {\n      throw new Error(\"HTTP agent has no URL configured\");\n    }\n\n    const response = await fetch(url, {\n      method: \"POST\",\n      headers: { \"Content-Type\": \"application/json\" },\n      body: JSON.stringify(input ?? {}),\n    });\n\n    const result = (await response.json()) as Record<string, unknown>;\n    return { agentType: \"http\", result };\n  }\n\n  // For workflow-linked agents, use the workflow run endpoint\n  const workflowId = (config as Record<string, unknown>).workflowId as string | undefined;\n  if (!workflowId) {\n    throw new Error(\n      `Agent \"${agent.name}\" (type: ${agent.type}) cannot be executed directly. ` +\n        `Only HTTP agents and workflow-linked agents can be run.`,\n    );\n  }\n\n  const { runWorkflow } = await import(\"./langwatch-api-workflows.js\");\n  const result = await runWorkflow(workflowId, input);\n  return { agentType: agent.type, result };\n}\n\nexport async function deleteAgent(id: string): Promise<{ id: string; name: string }> {\n  return makeRequest(\n    \"DELETE\",\n    `/api/agents/${encodeURIComponent(id)}`,\n  ) as Promise<{ id: string; name: string }>;\n}\n"],"mappings":";;;;;AAqBA,eAAsB,WAAW,QAGF;AAC7B,QAAM,QAAQ,IAAI,gBAAgB;AAClC,MAAI,QAAQ,KAAM,OAAM,IAAI,QAAQ,OAAO,OAAO,IAAI,CAAC;AACvD,MAAI,QAAQ,MAAO,OAAM,IAAI,SAAS,OAAO,OAAO,KAAK,CAAC;AAC1D,QAAM,KAAK,MAAM,SAAS,IAAI,IAAI,KAAK,KAAK;AAC5C,SAAO,YAAY,OAAO,cAAc,EAAE,EAAE;AAC9C;AAEA,eAAsB,SAAS,IAAmC;AAChE,SAAO;AAAA,IACL;AAAA,IACA,eAAe,mBAAmB,EAAE,CAAC;AAAA,EACvC;AACF;AAEA,eAAsB,YAAY,MAIR;AACxB,SAAO,YAAY,QAAQ,eAAe,IAAI;AAChD;AAEA,eAAsB,YAAY,QAKR;AACxB,QAAM,EAAE,IAAI,GAAG,KAAK,IAAI;AACxB,SAAO;AAAA,IACL;AAAA,IACA,eAAe,mBAAmB,EAAE,CAAC;AAAA,IACrC;AAAA,EACF;AACF;AAMA,eAAsB,SACpB,IACA,OACiE;AACjE,QAAM,QAAQ,MAAM,SAAS,EAAE;AAC/B,QAAM,SAAS,MAAM,UAAU,CAAC;AAEhC,MAAI,MAAM,SAAS,QAAQ;AACzB,UAAM,MAAO,OAAmC;AAChD,QAAI,CAAC,KAAK;AACR,YAAM,IAAI,MAAM,kCAAkC;AAAA,IACpD;AAEA,UAAM,WAAW,MAAM,MAAM,KAAK;AAAA,MAChC,QAAQ;AAAA,MACR,SAAS,EAAE,gBAAgB,mBAAmB;AAAA,MAC9C,MAAM,KAAK,UAAU,SAAS,CAAC,CAAC;AAAA,IAClC,CAAC;AAED,UAAMA,UAAU,MAAM,SAAS,KAAK;AACpC,WAAO,EAAE,WAAW,QAAQ,QAAAA,QAAO;AAAA,EACrC;AAGA,QAAM,aAAc,OAAmC;AACvD,MAAI,CAAC,YAAY;AACf,UAAM,IAAI;AAAA,MACR,UAAU,MAAM,IAAI,YAAY,MAAM,IAAI;AAAA,IAE5C;AAAA,EACF;AAEA,QAAM,EAAE,YAAY,IAAI,MAAM,OAAO,uCAA8B;AACnE,QAAM,SAAS,MAAM,YAAY,YAAY,KAAK;AAClD,SAAO,EAAE,WAAW,MAAM,MAAM,OAAO;AACzC;AAEA,eAAsB,YAAY,IAAmD;AACnF,SAAO;AAAA,IACL;AAAA,IACA,eAAe,mBAAmB,EAAE,CAAC;AAAA,EACvC;AACF;","names":["result"]}

package/dist/chunk-BWWY5KEF.js

@@ -0,0 +1,71 @@
+// 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"
+  };
+}
+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-BWWY5KEF.js.map

package/dist/chunk-BWWY5KEF.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/config.ts"],"sourcesContent":["import { AsyncLocalStorage } from \"node:async_hooks\";\n\nexport interface McpConfig {\n  apiKey: string | undefined;\n  endpoint: string;\n}\n\n// ---------------------------------------------------------------------------\n// Singleton storage on globalThis\n//\n// When the langwatch app (CJS, no \"type\": \"module\") imports this module,\n// tsx creates a CJS-cached copy. When mcp-server's own ESM dist chunks\n// do `await import(\"./search-traces-*.js\")`, Node creates a separate\n// ESM-cached copy. Module-level variables are NOT shared between them.\n//\n// By storing config on globalThis, both CJS and ESM instances read/write\n// the same object, fixing the \"Config not initialized\" error that occurs\n// when initConfig() runs on the CJS side but tool handlers execute on\n// the ESM side.\n// ---------------------------------------------------------------------------\n\nconst GLOBAL_KEY = \"__langwatch_mcp_config\" as const;\nconst STORAGE_KEY = \"__langwatch_mcp_config_storage\" as const;\n\ninterface McpGlobalState {\n  globalConfig: McpConfig | undefined;\n  configStorage: AsyncLocalStorage<McpConfig>;\n}\n\nfunction getGlobalState(): McpGlobalState {\n  const g = globalThis as unknown as Record<string, unknown>;\n  if (!g[GLOBAL_KEY]) {\n    g[GLOBAL_KEY] = undefined;\n  }\n  if (!g[STORAGE_KEY]) {\n    g[STORAGE_KEY] = new AsyncLocalStorage<McpConfig>();\n  }\n  return {\n    get globalConfig() {\n      return g[GLOBAL_KEY] as McpConfig | undefined;\n    },\n    set globalConfig(val: McpConfig | undefined) {\n      g[GLOBAL_KEY] = val;\n    },\n    get configStorage() {\n      return g[STORAGE_KEY] as AsyncLocalStorage<McpConfig>;\n    },\n  };\n}\n\nexport function initConfig(args: { apiKey?: string; endpoint?: string }): void {\n  const state = getGlobalState();\n  state.globalConfig = {\n    apiKey: args.apiKey || process.env.LANGWATCH_API_KEY,\n    endpoint:\n      args.endpoint ||\n      process.env.LANGWATCH_ENDPOINT ||\n      \"https://app.langwatch.ai\",\n  };\n}\n\n/**\n * Returns the current config: the per-request scoped config if inside\n * a `runWithConfig()` callback, otherwise the global config.\n */\nexport function getConfig(): McpConfig {\n  const state = getGlobalState();\n  const scoped = state.configStorage.getStore();\n  if (scoped) return scoped;\n  if (!state.globalConfig) {\n    console.error(\n      \"[MCP config] getConfig() failed: globalConfig is null, no scoped config active. \" +\n        \"Was initConfig() called? Stack:\",\n      new Error().stack,\n    );\n    throw new Error(\"Config not initialized\");\n  }\n  return state.globalConfig;\n}\n\nexport function requireApiKey(): string {\n  const config = getConfig();\n  if (!config.apiKey) {\n    const state = getGlobalState();\n    const hasScoped = !!state.configStorage.getStore();\n    console.error(\n      \"[MCP config] requireApiKey() failed: apiKey is undefined. \" +\n        `scopedConfig=${hasScoped}, endpoint=${config.endpoint}. ` +\n        \"In HTTP mode, the API key should be set per-session via runWithConfig(). Stack:\",\n      new Error().stack,\n    );\n    throw new Error(\n      \"LANGWATCH_API_KEY is required. Set it via --apiKey flag or LANGWATCH_API_KEY environment variable.\"\n    );\n  }\n  return config.apiKey;\n}\n\n/**\n * Runs `fn` with a per-request scoped config. All calls to `getConfig()`\n * and `requireApiKey()` within `fn` (including async continuations) will\n * see the provided config instead of the global one.\n */\nexport function runWithConfig<T>(config: McpConfig, fn: () => T): T {\n  const state = getGlobalState();\n  return state.configStorage.run(config, fn);\n}\n"],"mappings":";AAAA,SAAS,yBAAyB;AAqBlC,IAAM,aAAa;AACnB,IAAM,cAAc;AAOpB,SAAS,iBAAiC;AACxC,QAAM,IAAI;AACV,MAAI,CAAC,EAAE,UAAU,GAAG;AAClB,MAAE,UAAU,IAAI;AAAA,EAClB;AACA,MAAI,CAAC,EAAE,WAAW,GAAG;AACnB,MAAE,WAAW,IAAI,IAAI,kBAA6B;AAAA,EACpD;AACA,SAAO;AAAA,IACL,IAAI,eAAe;AACjB,aAAO,EAAE,UAAU;AAAA,IACrB;AAAA,IACA,IAAI,aAAa,KAA4B;AAC3C,QAAE,UAAU,IAAI;AAAA,IAClB;AAAA,IACA,IAAI,gBAAgB;AAClB,aAAO,EAAE,WAAW;AAAA,IACtB;AAAA,EACF;AACF;AAEO,SAAS,WAAW,MAAoD;AAC7E,QAAM,QAAQ,eAAe;AAC7B,QAAM,eAAe;AAAA,IACnB,QAAQ,KAAK,UAAU,QAAQ,IAAI;AAAA,IACnC,UACE,KAAK,YACL,QAAQ,IAAI,sBACZ;AAAA,EACJ;AACF;AAMO,SAAS,YAAuB;AACrC,QAAM,QAAQ,eAAe;AAC7B,QAAM,SAAS,MAAM,cAAc,SAAS;AAC5C,MAAI,OAAQ,QAAO;AACnB,MAAI,CAAC,MAAM,cAAc;AACvB,YAAQ;AAAA,MACN;AAAA,MAEA,IAAI,MAAM,EAAE;AAAA,IACd;AACA,UAAM,IAAI,MAAM,wBAAwB;AAAA,EAC1C;AACA,SAAO,MAAM;AACf;AAEO,SAAS,gBAAwB;AACtC,QAAM,SAAS,UAAU;AACzB,MAAI,CAAC,OAAO,QAAQ;AAClB,UAAM,QAAQ,eAAe;AAC7B,UAAM,YAAY,CAAC,CAAC,MAAM,cAAc,SAAS;AACjD,YAAQ;AAAA,MACN,0EACkB,SAAS,cAAc,OAAO,QAAQ;AAAA,MAExD,IAAI,MAAM,EAAE;AAAA,IACd;AACA,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACA,SAAO,OAAO;AAChB;AAOO,SAAS,cAAiB,QAAmB,IAAgB;AAClE,QAAM,QAAQ,eAAe;AAC7B,SAAO,MAAM,cAAc,IAAI,QAAQ,EAAE;AAC3C;","names":[]}

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

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