@langwatch/mcp-server 2.0.0 → 2.2.0

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

@@ -0,0 +1,60 @@
+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.
+ */
+export async function handleGetRunPlan(params: {
+  id: string;
+  format?: "digest" | "json";
+}): Promise<string> {
+  const plan = await apiGetRunPlan(params.id);
+
+  if (params.format === "json") {
+    return JSON.stringify(plan, null, 2);
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Run Plan: ${plan.name}\n`);
+  lines.push(`**ID**: ${plan.id}`);
+  lines.push(`**Slug**: ${plan.slug}`);
+  lines.push(`**Covers**: ${describeRunPlanScope(plan.scope, plan.scenarioIds)}`);
+  lines.push(`**Repeat**: ${plan.repeatCount}x`);
+  lines.push(`**Simulator model**: ${plan.simulatorModel ?? "project default"}`);
+  lines.push(`**Judge model**: ${plan.judgeModel ?? "project default"}`);
+  if (plan.labels.length > 0) {
+    lines.push(`**Labels**: ${plan.labels.join(", ")}`);
+  }
+  if (plan.archivedAt) {
+    lines.push(`**Archived**: ${plan.archivedAt}`);
+  }
+  lines.push(`**Created**: ${plan.createdAt}`);
+  lines.push(`**Updated**: ${plan.updatedAt}`);
+
+  lines.push("\n## Targets");
+  for (const target of plan.targets) {
+    // The parameters are part of the target's identity, so a plan that
+    // compares one agent on two models reads as two lines that differ.
+    const overrides = Object.entries(target.runParameters ?? {})
+      .map(([name, value]) => `${name}=${String(value)}`)
+      .join(", ");
+    lines.push(`- ${target.type}:${target.referenceId}${overrides ? ` (${overrides})` : ""}`);
+  }
+
+  if (plan.scenarioIds.length > 0) {
+    lines.push("\n## Scenarios");
+    for (const id of plan.scenarioIds) {
+      lines.push(`- ${id}`);
+    }
+  }
+
+  lines.push(...formatEvaluatorAttachments(plan.evaluators));
+
+  lines.push(`\n**View**: ${plan.platformUrl}`);
+  lines.push(
+    "\n> Use `platform_rerun_run_plan` to run this configuration again, or `platform_run_plan` with this name to replace it.",
+  );
+
+  return lines.join("\n");
+}

package/src/tools/get-scenario.ts

@@ -1,10 +1,9 @@
-import { getScenario as apiGetScenario } from "../langwatch-api-scenarios.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;
@@ -32,5 +31,7 @@ export async function handleGetScenario(params: {
     lines.push(`\n**Labels**: ${scenario.labels.join(", ")}`);
   }
 
+  lines.push(...formatScenarioFields(scenario.fields));
+
   return lines.join("\n");
 }

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

@@ -1,4 +1,29 @@
-import { getSimulationRun as apiGetSimulationRun } from "../langwatch-api-simulation-runs.js";
+import {
+  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.
@@ -19,6 +44,7 @@ export async function handleGetSimulationRun(params: {
   lines.push(`**Scenario ID**: ${run.scenarioId}`);
   lines.push(`**Batch ID**: ${run.batchRunId}`);
   lines.push(`**Status**: ${run.status}`);
+  lines.push(...pendingEvaluationNote(run.status));
 
   const duration = run.durationInMs > 0 ? `${(run.durationInMs / 1000).toFixed(1)}s` : "—";
   lines.push(`**Duration**: ${duration}`);
@@ -26,32 +52,18 @@ export async function handleGetSimulationRun(params: {
     lines.push(`**Cost**: $${run.totalCost.toFixed(4)}`);
   }
   lines.push(`**Started**: ${new Date(run.timestamp).toISOString()}`);
+  if (run.note) {
+    lines.push(`**Note**: ${run.note}`);
+  }
 
   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(...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

@@ -0,0 +1,46 @@
+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.
+ */
+export async function handleGetTestSuite(params: {
+  id: string;
+  format?: "digest" | "json";
+}): Promise<string> {
+  const suite = await apiGetTestSuite(params.id);
+
+  if (params.format === "json") {
+    return JSON.stringify(suite, null, 2);
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Test Suite: ${suite.name}\n`);
+  lines.push(`**ID**: ${suite.id}`);
+  lines.push(`**Slug**: ${suite.slug}`);
+  lines.push(`**Scenarios**: ${suite.scenarioCount}`);
+  if (suite.archivedAt) {
+    lines.push(`**Archived**: ${suite.archivedAt}`);
+  }
+  lines.push(`**Created**: ${suite.createdAt}`);
+  lines.push(`**Updated**: ${suite.updatedAt}`);
+
+  lines.push(...formatSuiteFields(suite.fields));
+  lines.push(...formatEvaluatorAttachments(suite.evaluators));
+
+  lines.push("\n## Scenarios");
+  if (suite.scenarios.length === 0) {
+    lines.push("None filed yet.");
+  } else {
+    for (const scenario of suite.scenarios) {
+      lines.push(`- ${scenario.name} (${scenario.id})`);
+    }
+  }
+
+  lines.push(`\n**View**: ${suite.platformUrl}`);
+  lines.push(
+    "\n> Use `platform_run_test_suite` to run every scenario of this suite against a target.",
+  );
+
+  return lines.join("\n");
+}

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,11 +1,20 @@
-import { listAgents as apiListAgents } 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 =>
+  agent.owner?.name ?? agent.hostLabel ?? "";
+
+/**
+ * Handles the platform_list_agents MCP tool invocation.
+ *
+ * @see specs/mcp-server/agent-tools.feature
+ */
 export async function handleListAgents(): Promise<string> {
   const result = await apiListAgents({ limit: 100 });
   const agents = result.data;
 
   if (!Array.isArray(agents) || agents.length === 0) {
-    return "No agents found in this project.\n\n> Tip: Use `platform_create_agent` to create your first agent.";
+    return "No agents found in this project.\n\n> Tip: connect one from code with `connectAgent` (TypeScript, `langwatch/agent`) or `connect_agent` (Python), or use `platform_create_agent` for an HTTP agent.";
   }
 
   const lines: string[] = [];
@@ -15,12 +24,20 @@ export async function handleListAgents(): Promise<string> {
     lines.push(`## ${a.name}`);
     lines.push(`**ID**: ${a.id}`);
     lines.push(`**Type**: ${a.type}`);
+    if (a.environment) lines.push(`**Environment**: ${a.environment}`);
+    if (a.status) lines.push(`**Status**: ${a.status}`);
+    if (a.instances) lines.push(`**Instances**: ${a.instances.length}`);
+    const owner = agentOwnerLabel(a);
+    if (owner) lines.push(`**Owner**: ${owner}`);
+    if (a.selectable === false) {
+      lines.push("**Run**: only its owner can run this agent");
+    }
     lines.push(`**Updated**: ${a.updatedAt}`);
     lines.push("");
   }
 
   lines.push(
-    "> Use `platform_get_agent` with the ID to see full agent details including config.",
+    "> Use `platform_get_agent` with the ID to see full agent details including parameters, instances and config.",
   );
 
   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-dashboard-boards.ts

@@ -0,0 +1,28 @@
+/**
+ * The `list_dashboard_boards` MCP tool: the Dashboards boards a widget can be added to, with
+ * the id `add_dashboard_widget` and `update_dashboard_widget` take.
+ */
+
+import { listBoards } from "../langwatch-api-boards.js";
+import { getCurrentProject } from "../langwatch-api-projects.js";
+
+export async function handleListDashboardBoards(): Promise<string> {
+  const project = await getCurrentProject();
+  const { data: boards } = await listBoards({ projectId: project.id });
+
+  if (boards.length === 0) {
+    return "No dashboards found in this project. Create one in the Dashboards area first.";
+  }
+
+  return [
+    `# Dashboards (${boards.length} total)\n`,
+    ...boards.flatMap((board) => [
+      `## ${board.name}`,
+      `**ID**: ${board.id}`,
+      `**Widgets**: ${board.widgetCount}`,
+      `**URL**: ${board.platformUrl}`,
+      "",
+    ]),
+    "> Pass the ID to `add_dashboard_widget` to add a widget to that dashboard.",
+  ].join("\n");
+}

package/src/tools/list-dashboards.ts

@@ -1,4 +1,4 @@
-import { listDashboards as apiListDashboards } from "../langwatch-api-dashboards.js";
+import { listDashboards as apiListDashboards } from "../langwatch-api-dashboards.ts";
 
 export async function handleListDashboards(): Promise<string> {
   const result = await apiListDashboards();

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.";