@langwatch/mcp-server 2.1.0 → 3.0.0

package/src/tools/get-run-plan.ts

@@ -1,6 +1,6 @@
-import { getRunPlan as apiGetRunPlan } from "../langwatch-api-run-plans.js";
-import { describeRunPlanScope } from "./format-run-plan.js";
-import { formatEvaluatorAttachments } from "./format-suite-details.js";
+import { getRunPlan as apiGetRunPlan } from "../langwatch-api-run-plans.ts";
+import { describeRunPlanScope } from "./format-run-plan.ts";
+import { formatEvaluatorAttachments } from "./format-suite-details.ts";
 
 /**
  * Handles the platform_get_run_plan MCP tool invocation.
@@ -39,9 +39,7 @@ export async function handleGetRunPlan(params: {
     const overrides = Object.entries(target.runParameters ?? {})
       .map(([name, value]) => `${name}=${String(value)}`)
       .join(", ");
-    lines.push(
-      `- ${target.type}:${target.referenceId}${overrides ? ` (${overrides})` : ""}`,
-    );
+    lines.push(`- ${target.type}:${target.referenceId}${overrides ? ` (${overrides})` : ""}`);
   }
 
   if (plan.scenarioIds.length > 0) {

package/src/tools/get-scenario.ts

@@ -1,11 +1,9 @@
-import { getScenario as apiGetScenario } from "../langwatch-api-scenarios.js";
-import { formatScenarioFields } from "./format-scenario.js";
+import { getScenario as apiGetScenario } from "../langwatch-api-scenarios.ts";
+import { formatScenarioFields } from "./format-scenario.ts";
 
 /**
- * Handles the get_scenario MCP tool invocation.
- *
- * Retrieves a specific scenario by ID and formats it as
- * AI-readable markdown or raw JSON.
+ * Handles the get_scenario MCP tool: retrieves a scenario by ID and
+ * formats it as AI-readable markdown or raw JSON.
  */
 export async function handleGetScenario(params: {
   scenarioId: string;

package/src/tools/get-simulation-run.ts

@@ -1,8 +1,29 @@
-import { getSimulationRun as apiGetSimulationRun } from "../langwatch-api-simulation-runs.js";
 import {
-  formatEvaluations,
-  pendingEvaluationNote,
-} from "./format-suite-details.js";
+  getSimulationRun as apiGetSimulationRun,
+  type SimulationRunSummary,
+} from "../langwatch-api-simulation-runs.ts";
+import { formatEvaluations, pendingEvaluationNote } from "./format-suite-details.ts";
+
+function resultLines(results: NonNullable<SimulationRunSummary["results"]>): string[] {
+  const lines = ["\n## Results"];
+  if (results.verdict) {
+    lines.push(`**Verdict**: ${results.verdict}`);
+  }
+  if (results.reasoning) {
+    lines.push(`**Reasoning**: ${results.reasoning}`);
+  }
+  if (results.metCriteria && results.metCriteria.length > 0) {
+    lines.push(`**Met Criteria**: ${results.metCriteria.join(", ")}`);
+  }
+  if (results.unmetCriteria && results.unmetCriteria.length > 0) {
+    lines.push(`**Unmet Criteria**: ${results.unmetCriteria.join(", ")}`);
+  }
+  if (results.error) {
+    lines.push(`**Error**: ${results.error}`);
+  }
+  lines.push(...formatEvaluations(results.evaluations));
+  return lines;
+}
 
 /**
  * Handles the platform_get_simulation_run MCP tool invocation.
@@ -36,31 +57,13 @@ export async function handleGetSimulationRun(params: {
   }
 
   if (run.results) {
-    lines.push("\n## Results");
-    if (run.results.verdict) {
-      lines.push(`**Verdict**: ${run.results.verdict}`);
-    }
-    if (run.results.reasoning) {
-      lines.push(`**Reasoning**: ${run.results.reasoning}`);
-    }
-    if (run.results.metCriteria && run.results.metCriteria.length > 0) {
-      lines.push(`**Met Criteria**: ${run.results.metCriteria.join(", ")}`);
-    }
-    if (run.results.unmetCriteria && run.results.unmetCriteria.length > 0) {
-      lines.push(`**Unmet Criteria**: ${run.results.unmetCriteria.join(", ")}`);
-    }
-    if (run.results.error) {
-      lines.push(`**Error**: ${run.results.error}`);
-    }
-    lines.push(...formatEvaluations(run.results.evaluations));
+    lines.push(...resultLines(run.results));
   }
 
   if (run.messages && run.messages.length > 0) {
     lines.push("\n## Conversation");
     for (const msg of run.messages) {
-      const content = msg.content.length > 300
-        ? msg.content.slice(0, 300) + "..."
-        : msg.content;
+      const content = msg.content.length > 300 ? msg.content.slice(0, 300) + "..." : msg.content;
       lines.push(`**[${msg.role}]**: ${content}`);
     }
   }

package/src/tools/get-test-suite.ts

@@ -1,8 +1,5 @@
-import { getTestSuite as apiGetTestSuite } from "../langwatch-api-test-suites.js";
-import {
-  formatEvaluatorAttachments,
-  formatSuiteFields,
-} from "./format-suite-details.js";
+import { getTestSuite as apiGetTestSuite } from "../langwatch-api-test-suites.ts";
+import { formatEvaluatorAttachments, formatSuiteFields } from "./format-suite-details.ts";
 
 /**
  * Handles the platform_get_test_suite MCP tool invocation.

package/src/tools/get-trace.ts

@@ -1,11 +1,9 @@
-import { getTraceById as apiGetTraceById } from "../langwatch-api.js";
-import { formatEvaluationLines } from "../utils/format-evaluations.js";
+import { getTraceById as apiGetTraceById } from "../langwatch-api.ts";
+import { formatEvaluationLines } from "../utils/format-evaluations.ts";
 
 /**
- * Handles the get_trace MCP tool invocation.
- *
- * Retrieves a single trace by ID. In digest mode (default), returns the
- * AI-readable formatted digest. In json mode, returns the full raw JSON.
+ * Handles the get_trace MCP tool: retrieves a trace by ID as an
+ * AI-readable digest (default) or full raw JSON.
  */
 export async function handleGetTrace(params: {
   traceId: string;
@@ -20,11 +18,20 @@ export async function handleGetTrace(params: {
 
   const lines: string[] = [];
   lines.push(`# Trace: ${params.traceId}\n`);
+  addTraceDigest(lines, result);
 
+  lines.push('\n> Tip: Use `get_trace` with `format: "json"` to get the full raw trace data.');
+
+  return lines.join("\n");
+}
+
+function addTraceDigest(
+  lines: string[],
+  result: Awaited<ReturnType<typeof apiGetTraceById>>,
+): void {
   if (result.timestamps) {
     lines.push(`**Started**: ${result.timestamps.started_at}`);
-    if (result.timestamps.updated_at)
-      lines.push(`**Updated**: ${result.timestamps.updated_at}`);
+    if (result.timestamps.updated_at) lines.push(`**Updated**: ${result.timestamps.updated_at}`);
   }
 
   if (result.metadata) {
@@ -39,13 +46,5 @@ export async function handleGetTrace(params: {
     lines.push("\n## Evaluations", ...formatEvaluationLines(result.evaluations));
   }
 
-  if (result.formatted_trace) {
-    lines.push(`\n## Trace Details\n${result.formatted_trace}`);
-  }
-
-  lines.push(
-    '\n> Tip: Use `get_trace` with `format: "json"` to get the full raw trace data.'
-  );
-
-  return lines.join("\n");
+  if (result.formatted_trace) lines.push(`\n## Trace Details\n${result.formatted_trace}`);
 }

package/src/tools/get-workflow.ts

@@ -1,4 +1,4 @@
-import { getWorkflow as apiGetWorkflow } from "../langwatch-api-workflows.js";
+import { getWorkflow as apiGetWorkflow } from "../langwatch-api-workflows.ts";
 
 export async function handleGetWorkflow(params: { id: string }): Promise<string> {
   const workflow = await apiGetWorkflow(params.id);

package/src/tools/list-agents.ts

@@ -1,4 +1,4 @@
-import { listAgents as apiListAgents, type AgentSummary } from "../langwatch-api-agents.js";
+import { listAgents as apiListAgents, type AgentSummary } from "../langwatch-api-agents.ts";
 
 /** Who a personal or host-scoped agent belongs to, empty for a shared one. */
 export const agentOwnerLabel = (agent: AgentSummary): string =>

package/src/tools/list-analytics-reports.ts

@@ -0,0 +1,27 @@
+import { listAnalyticsReports } from "../langwatch-api-analytics-reports.ts";
+
+export async function handleListAnalyticsReports(): Promise<string> {
+  const result = await listAnalyticsReports();
+  const reports = result.data;
+
+  if (!Array.isArray(reports) || reports.length === 0) {
+    return "No Analytics Reports found in this project.\n\n> Tip: Use `platform_create_analytics_report` to create a new Analytics Report.";
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Analytics Reports (${reports.length} total)\n`);
+
+  for (const report of reports) {
+    lines.push(`## ${report.name}`);
+    lines.push(`**ID**: ${report.id}`);
+    lines.push(`**Graphs**: ${report.graphCount}`);
+    lines.push(`**Updated**: ${report.updatedAt}`);
+    lines.push("");
+  }
+
+  lines.push(
+    "> Use `platform_get_analytics_report` with the ID to see the Analytics Report's details including graphs.",
+  );
+
+  return lines.join("\n");
+}

package/src/tools/list-annotations.ts

@@ -1,11 +1,9 @@
 import {
   listAnnotations as apiListAnnotations,
   getAnnotationsByTrace as apiGetByTrace,
-} from "../langwatch-api-annotations.js";
+} from "../langwatch-api-annotations.ts";
 
-export async function handleListAnnotations(params: {
-  traceId?: string;
-}): Promise<string> {
+export async function handleListAnnotations(params: { traceId?: string }): Promise<string> {
   const annotations = params.traceId
     ? await apiGetByTrace(params.traceId)
     : await apiListAnnotations();
@@ -20,7 +18,12 @@ export async function handleListAnnotations(params: {
   lines.push(`# Annotations (${annotations.length} total)\n`);
 
   for (const a of annotations) {
-    const rating = a.isThumbsUp === true ? "👍" : a.isThumbsUp === false ? "👎" : "—";
+    let rating = "—";
+    if (a.isThumbsUp === true) {
+      rating = "👍";
+    } else if (a.isThumbsUp === false) {
+      rating = "👎";
+    }
     lines.push(`## Annotation ${a.id ?? "—"}`);
     lines.push(`**Trace ID**: ${a.traceId ?? "—"}`);
     lines.push(`**Rating**: ${rating}`);

package/src/tools/list-api-keys.ts

@@ -1,4 +1,4 @@
-import { listApiKeys as apiListApiKeys } from "../langwatch-api-api-keys.js";
+import { listApiKeys as apiListApiKeys } from "../langwatch-api-api-keys.ts";
 
 export async function handleListApiKeys(): Promise<string> {
   const result = await apiListApiKeys();
@@ -12,7 +12,12 @@ export async function handleListApiKeys(): Promise<string> {
   lines.push(`# API Keys (${keys.length} total)\n`);
 
   for (const k of keys) {
-    const status = k.revokedAt ? "REVOKED" : k.expiresAt && new Date(k.expiresAt) < new Date() ? "EXPIRED" : "ACTIVE";
+    let status = "ACTIVE";
+    if (k.revokedAt) {
+      status = "REVOKED";
+    } else if (k.expiresAt && new Date(k.expiresAt) < new Date()) {
+      status = "EXPIRED";
+    }
     lines.push(`## ${k.name}`);
     lines.push(`**ID**: ${k.id}`);
     lines.push(`**Status**: ${status}`);

package/src/tools/list-dashboards.ts

@@ -1,27 +1,26 @@
-import { listDashboards as apiListDashboards } from "../langwatch-api-dashboards.js";
+/**
+ * The `list_dashboards` MCP tool: the dashboards a widget can be added to, with
+ * the id `add_dashboard_widget` and `update_dashboard_widget` take.
+ */
 
-export async function handleListDashboards(): Promise<string> {
-  const result = await apiListDashboards();
-  const dashboards = result.data;
-
-  if (!Array.isArray(dashboards) || dashboards.length === 0) {
-    return "No dashboards found in this project.\n\n> Tip: Use `platform_create_dashboard` to create a new dashboard.";
-  }
+import { listDashboards } from "../langwatch-api-dashboards.js";
 
-  const lines: string[] = [];
-  lines.push(`# Dashboards (${dashboards.length} total)\n`);
+export async function handleListDashboards(): Promise<string> {
+  const { data: dashboards } = await listDashboards();
 
-  for (const d of dashboards) {
-    lines.push(`## ${d.name}`);
-    lines.push(`**ID**: ${d.id}`);
-    lines.push(`**Graphs**: ${d.graphCount}`);
-    lines.push(`**Updated**: ${d.updatedAt}`);
-    lines.push("");
+  if (dashboards.length === 0) {
+    return "No dashboards found in this project. Create one in the Dashboards area first.";
   }
 
-  lines.push(
-    "> Use `platform_get_dashboard` with the ID to see dashboard details including graphs.",
-  );
-
-  return lines.join("\n");
+  return [
+    `# Dashboards (${dashboards.length} total)\n`,
+    ...dashboards.flatMap((dashboard) => [
+      `## ${dashboard.name}`,
+      `**ID**: ${dashboard.id}`,
+      `**Widgets**: ${dashboard.widgetCount}`,
+      `**URL**: ${dashboard.platformUrl}`,
+      "",
+    ]),
+    "> Pass the ID to `add_dashboard_widget` to add a widget to that dashboard.",
+  ].join("\n");
 }

package/src/tools/list-dataset-records.ts

@@ -1,7 +1,5 @@
-import {
-  listDatasetRecords as apiListDatasetRecords,
-} from "../langwatch-api-datasets.js";
-import { escapeMarkdown } from "../utils/escape-markdown.js";
+import { listDatasetRecords as apiListDatasetRecords } from "../langwatch-api-datasets.ts";
+import { escapeMarkdown } from "../utils/escape-markdown.ts";
 
 /**
  * Handles the platform_list_dataset_records MCP tool invocation.
@@ -31,7 +29,9 @@ export async function handleListDatasetRecords(params: {
   }
 
   const lines: string[] = [];
-  lines.push(`# Records (page ${pagination.page} of ${pagination.totalPages}, ${pagination.total} total)\n`);
+  lines.push(
+    `# Records (page ${pagination.page} of ${pagination.totalPages}, ${pagination.total} total)\n`,
+  );
 
   for (const record of records) {
     lines.push(`**${escapeMarkdown(record.id)}**: ${escapeMarkdown(JSON.stringify(record.entry))}`);
@@ -39,7 +39,9 @@ export async function handleListDatasetRecords(params: {
 
   if (pagination.page < pagination.totalPages) {
     lines.push("");
-    lines.push(`> Use \`platform_list_dataset_records\` with \`page: ${pagination.page + 1}\` to see the next page.`);
+    lines.push(
+      `> Use \`platform_list_dataset_records\` with \`page: ${pagination.page + 1}\` to see the next page.`,
+    );
   }
 
   return lines.join("\n");

package/src/tools/list-datasets.ts

@@ -1,15 +1,9 @@
-import {
-  listDatasets as apiListDatasets,
-  type DatasetSummary,
-} from "../langwatch-api-datasets.js";
-import { escapeMarkdown } from "../utils/escape-markdown.js";
+import { listDatasets as apiListDatasets, type DatasetSummary } from "../langwatch-api-datasets.ts";
+import { escapeMarkdown } from "../utils/escape-markdown.ts";
 
 /**
- * Fetches all datasets by paginating through the API until every page
- * has been retrieved.
- *
- * Returns the accumulated dataset summaries along with the total count
- * reported by the server.
+ * Fetches all datasets by paginating until every page is retrieved.
+ * Returns the accumulated summaries plus the total count from the server.
  */
 async function fetchAllDatasets(): Promise<{
   datasets: DatasetSummary[];
@@ -20,7 +14,6 @@ async function fetchAllDatasets(): Promise<{
   let page = 1;
   let total = 0;
 
-  // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition -- loop until break
   while (true) {
     const response = await apiListDatasets({ page, limit: PAGE_SIZE });
     total = response.pagination.total;
@@ -36,14 +29,14 @@ async function fetchAllDatasets(): Promise<{
 }
 
 /**
- * Handles the platform_list_datasets MCP tool invocation.
- *
- * Lists all datasets in the LangWatch project, formatted as an
+ * Handles the platform_list_datasets MCP tool: lists datasets as an
  * AI-readable digest or raw JSON.
  */
-export async function handleListDatasets(params: {
-  format?: "digest" | "json";
-} = {}): Promise<string> {
+export async function handleListDatasets(
+  params: {
+    format?: "digest" | "json";
+  } = {},
+): Promise<string> {
   if (params.format === "json") {
     const { datasets, total } = await fetchAllDatasets();
     return JSON.stringify({ data: datasets, total }, null, 2);
@@ -66,15 +59,11 @@ export async function handleListDatasets(params: {
       const colNames = ds.columnTypes.map((c) => c.name).join(", ");
       lines.push(`**Columns**: ${colNames}`);
     }
-    lines.push(
-      `**Records**: ${ds.recordCount ?? "unknown"}`,
-    );
+    lines.push(`**Records**: ${ds.recordCount ?? "unknown"}`);
     lines.push("");
   }
 
-  lines.push(
-    "> Use `platform_get_dataset` with the slug to see full dataset details and records.",
-  );
+  lines.push("> Use `platform_get_dataset` with the slug to see full dataset details and records.");
 
   return lines.join("\n");
 }

package/src/tools/list-evaluators.ts

@@ -1,13 +1,11 @@
 import {
   listEvaluators as apiListEvaluators,
   getEvaluatorType,
-} from "../langwatch-api-evaluators.js";
+} from "../langwatch-api-evaluators.ts";
 
 /**
- * Handles the platform_list_evaluators MCP tool invocation.
- *
- * Lists all evaluators in the LangWatch project, formatted as an
- * AI-readable digest.
+ * Handles the platform_list_evaluators MCP tool: lists evaluators in
+ * the project as an AI-readable digest.
  */
 export async function handleListEvaluators(): Promise<string> {
   const evaluators = await apiListEvaluators();
@@ -29,9 +27,7 @@ export async function handleListEvaluators(): Promise<string> {
     lines.push("");
   }
 
-  lines.push(
-    "> Use `platform_get_evaluator` with the ID or slug to see full evaluator details.",
-  );
+  lines.push("> Use `platform_get_evaluator` with the ID or slug to see full evaluator details.");
 
   return lines.join("\n");
 }

package/src/tools/list-experiment-runs.ts

@@ -1,4 +1,4 @@
-import { makeRequest } from "../langwatch-api.js";
+import { makeRequest } from "../langwatch-api.ts";
 
 interface RunSummaryEvaluator {
   name: string;
@@ -52,12 +52,10 @@ const passRate = (evaluations: RunSummary["evaluations"]): string => {
   if (passed.length === 0) {
     const scored = entries.filter((e) => typeof e.averageScore === "number");
     if (scored.length === 0) return "—";
-    const avg =
-      scored.reduce((sum, e) => sum + (e.averageScore ?? 0), 0) / scored.length;
+    const avg = scored.reduce((sum, e) => sum + (e.averageScore ?? 0), 0) / scored.length;
     return `${avg.toFixed(2)} avg`;
   }
-  const avg =
-    passed.reduce((sum, e) => sum + (e.averagePassed ?? 0), 0) / passed.length;
+  const avg = passed.reduce((sum, e) => sum + (e.averagePassed ?? 0), 0) / passed.length;
   return `${(avg * 100).toFixed(0)}% pass`;
 };
 
@@ -72,9 +70,7 @@ export async function handleExperimentListRuns(params: {
   limit?: number;
 }): Promise<string> {
   const requested =
-    typeof params.limit === "number" && params.limit > 0
-      ? params.limit
-      : DEFAULT_LIMIT;
+    typeof params.limit === "number" && params.limit > 0 ? params.limit : DEFAULT_LIMIT;
   const effectiveLimit = Math.min(requested, MAX_LIMIT);
 
   const search = new URLSearchParams();
@@ -85,7 +81,7 @@ export async function handleExperimentListRuns(params: {
   try {
     result = (await makeRequest(
       "GET",
-      `/api/experiments/runs?${search.toString()}`,
+      `/api/v1/experiments/runs?${search.toString()}`,
     )) as ExperimentRunsListResponse;
   } catch (error) {
     const message = error instanceof Error ? error.message : String(error);

package/src/tools/list-experiments.ts

@@ -1,4 +1,4 @@
-import { makeRequest } from "../langwatch-api.js";
+import { makeRequest } from "../langwatch-api.ts";
 
 interface ExperimentSummary {
   id: string;
@@ -38,13 +38,9 @@ const escapeMarkdownTableCell = (value: string): string =>
 const formatInlineCode = (value: string): string =>
   `\`${value.replace(/[\\`|]/g, (c) => `\\${c}`).replace(/\n/g, " ")}\``;
 
-export async function handleExperimentList(params: {
-  limit?: number;
-}): Promise<string> {
+export async function handleExperimentList(params: { limit?: number }): Promise<string> {
   const requested =
-    typeof params.limit === "number" && params.limit > 0
-      ? params.limit
-      : DEFAULT_LIMIT;
+    typeof params.limit === "number" && params.limit > 0 ? params.limit : DEFAULT_LIMIT;
   const effectiveLimit = Math.min(requested, MAX_LIMIT);
 
   const search = new URLSearchParams();
@@ -52,7 +48,7 @@ export async function handleExperimentList(params: {
 
   const result = (await makeRequest(
     "GET",
-    `/api/experiments?${search.toString()}`,
+    `/api/v1/experiments?${search.toString()}`,
   )) as ExperimentListResponse;
 
   if (result.experiments.length === 0) {
@@ -88,8 +84,6 @@ export async function handleExperimentList(params: {
   }
 
   lines.push("");
-  lines.push(
-    "> Use `platform_experiment_list_runs` with one of these slugs to see its runs.",
-  );
+  lines.push("> Use `platform_experiment_list_runs` with one of these slugs to see its runs.");
   return lines.join("\n");
 }

package/src/tools/list-model-providers.ts

@@ -1,10 +1,8 @@
-import { listModelProviders as apiListModelProviders } from "../langwatch-api-model-providers.js";
+import { listModelProviders as apiListModelProviders } from "../langwatch-api-model-providers.ts";
 
 /**
- * Handles the platform_list_model_providers MCP tool invocation.
- *
- * Lists all model providers for the project, showing provider name,
- * enabled status, and which key fields are set (masked).
+ * Handles the platform_list_model_providers MCP tool: lists providers
+ * with name, enabled status, and which key fields are set (masked).
  */
 export async function handleListModelProviders(): Promise<string> {
   const providers = await apiListModelProviders();

package/src/tools/list-projects.ts

@@ -1,4 +1,4 @@
-import { listProjects as apiListProjects } from "../langwatch-api-projects.js";
+import { listProjects as apiListProjects } from "../langwatch-api-projects.ts";
 
 export async function handleListProjects(params?: {
   page?: number;
@@ -33,9 +33,7 @@ export async function handleListProjects(params?: {
     );
   }
 
-  lines.push(
-    "> Use `platform_get_project` with the ID to see full project details.",
-  );
+  lines.push("> Use `platform_get_project` with the ID to see full project details.");
 
   return lines.join("\n");
 }

package/src/tools/list-prompt-tags.ts

@@ -1,11 +1,11 @@
-import { listPromptTags as apiListPromptTags } from "../langwatch-api.js";
+import { listPromptTags as apiListPromptTags } from "../langwatch-api.ts";
 
 export async function handleListPromptTags(): Promise<string> {
-  const tags = (await apiListPromptTags()) as Array<{
+  const tags = (await apiListPromptTags()) as {
     id: string;
     name: string;
     createdAt?: string;
-  }>;
+  }[];
 
   if (!tags || tags.length === 0) {
     return "No prompt tags found. The `latest` tag is always available.";

package/src/tools/list-prompts.ts

@@ -1,10 +1,8 @@
-import { listPrompts as apiListPrompts } from "../langwatch-api.js";
+import { listPrompts as apiListPrompts } from "../langwatch-api.ts";
 
 /**
- * Handles the platform_list_prompts MCP tool invocation.
- *
- * Lists all prompts in the LangWatch project, formatted as an
- * AI-readable markdown table.
+ * Handles the platform_list_prompts MCP tool: lists prompts in the
+ * project as an AI-readable markdown table.
  */
 export async function handleListPrompts(): Promise<string> {
   const prompts = await apiListPrompts();
@@ -26,9 +24,7 @@ export async function handleListPrompts(): Promise<string> {
     lines.push(`| ${handle} | ${name} | ${version} |`);
   }
 
-  lines.push(
-    "\n> Use `platform_get_prompt` with the handle or ID to see full prompt details."
-  );
+  lines.push("\n> Use `platform_get_prompt` with the handle or ID to see full prompt details.");
 
   return lines.join("\n");
 }

package/src/tools/list-run-plans.ts

@@ -1,5 +1,5 @@
-import { listRunPlans as apiListRunPlans } from "../langwatch-api-run-plans.js";
-import { describeRunPlanScope } from "./format-run-plan.js";
+import { listRunPlans as apiListRunPlans } from "../langwatch-api-run-plans.ts";
+import { describeRunPlanScope } from "./format-run-plan.ts";
 
 /**
  * Handles the platform_list_run_plans MCP tool invocation.

package/src/tools/list-scenarios.ts

@@ -1,10 +1,8 @@
-import { listScenarios as apiListScenarios } from "../langwatch-api-scenarios.js";
+import { listScenarios as apiListScenarios } from "../langwatch-api-scenarios.ts";
 
 /**
- * Handles the platform_list_scenarios MCP tool invocation.
- *
- * Lists all scenarios in the LangWatch project, formatted as an
- * AI-readable digest or raw JSON.
+ * Handles the platform_list_scenarios MCP tool: lists scenarios in the
+ * project as an AI-readable digest or raw JSON.
  */
 export async function handleListScenarios(params: {
   testSuiteId?: string;
@@ -35,23 +33,24 @@ export async function handleListScenarios(params: {
   for (const s of scenarios) {
     lines.push(`## ${s.name}`);
     lines.push(`**ID**: ${s.id}`);
-    const preview =
-      s.situation && s.situation.length > 60
-        ? s.situation.slice(0, 60) + "..."
-        : s.situation;
+    const preview = formatSituationPreview(s.situation);
     lines.push(`**Situation**: ${preview}`);
-    lines.push(
-      `**Criteria**: ${Array.isArray(s.criteria) ? s.criteria.length : 0} criteria`,
-    );
+    lines.push(`**Criteria**: ${Array.isArray(s.criteria) ? s.criteria.length : 0} criteria`);
     if (Array.isArray(s.labels) && s.labels.length > 0) {
       lines.push(`**Labels**: ${s.labels.join(", ")}`);
     }
     lines.push("");
   }
 
-  lines.push(
-    "> Use `platform_get_scenario` with the ID to see full scenario details.",
-  );
+  lines.push("> Use `platform_get_scenario` with the ID to see full scenario details.");
 
   return lines.join("\n");
 }
+
+function formatSituationPreview(situation: string | undefined): string | undefined {
+  if (situation && situation.length > 60) {
+    return situation.slice(0, 60) + "...";
+  }
+
+  return situation;
+}