@langwatch/mcp-server 0.4.0 → 0.6.0

package/src/langwatch-api.ts

@@ -78,7 +78,6 @@ export interface PromptSummary {
   id?: string;
   handle?: string;
   name?: string;
-  description?: string | null;
   latestVersionNumber?: number;
   version?: number;
 }
@@ -87,14 +86,12 @@ export interface PromptVersion {
   version?: number;
   commitMessage?: string;
   model?: string;
-  modelProvider?: string;
   messages?: Array<{ role: string; content: string }>;
 }
 
 export interface PromptDetailResponse extends PromptSummary {
   versions?: PromptVersion[];
   model?: string;
-  modelProvider?: string;
   messages?: Array<{ role: string; content: string }>;
   prompt?: Array<{ role: string; content: string }>;
 }
@@ -116,8 +113,8 @@ export interface PromptMutationResponse {
  *
  * @throws Error with status code and response body when the response is not OK
  */
-async function makeRequest(
-  method: "GET" | "POST",
+export async function makeRequest(
+  method: "GET" | "POST" | "PUT" | "PATCH" | "DELETE",
   path: string,
   body?: unknown
 ): Promise<unknown> {
@@ -126,7 +123,7 @@ async function makeRequest(
     "X-Auth-Token": requireApiKey(),
   };
 
-  if (method === "POST") {
+  if (body !== undefined) {
     headers["Content-Type"] = "application/json";
   }
 
@@ -216,12 +213,9 @@ export async function getPrompt(
 
 /** Creates a new prompt. */
 export async function createPrompt(data: {
-  name: string;
-  handle?: string;
+  handle: string;
   messages: Array<{ role: string; content: string }>;
   model: string;
-  modelProvider: string;
-  description?: string;
 }): Promise<PromptMutationResponse> {
   return makeRequest(
     "POST",
@@ -236,30 +230,12 @@ export async function updatePrompt(
   data: {
     messages?: Array<{ role: string; content: string }>;
     model?: string;
-    modelProvider?: string;
-    commitMessage?: string;
+    commitMessage: string;
   }
 ): Promise<PromptMutationResponse> {
   return makeRequest(
-    "POST",
+    "PUT",
     `/api/prompts/${encodeURIComponent(idOrHandle)}`,
     data
   ) as Promise<PromptMutationResponse>;
 }
-
-/** Creates a new version of an existing prompt. */
-export async function createPromptVersion(
-  idOrHandle: string,
-  data: {
-    messages?: Array<{ role: string; content: string }>;
-    model?: string;
-    modelProvider?: string;
-    commitMessage?: string;
-  }
-): Promise<PromptMutationResponse> {
-  return makeRequest(
-    "POST",
-    `/api/prompts/${encodeURIComponent(idOrHandle)}/versions`,
-    data
-  ) as Promise<PromptMutationResponse>;
-}

package/src/tools/archive-scenario.ts

@@ -0,0 +1,19 @@
+import { archiveScenario as apiArchiveScenario } from "../langwatch-api-scenarios.js";
+
+/**
+ * Handles the platform_archive_scenario MCP tool invocation.
+ *
+ * Archives (soft-deletes) a scenario and returns confirmation.
+ */
+export async function handleArchiveScenario(params: {
+  scenarioId: string;
+}): Promise<string> {
+  const result = await apiArchiveScenario(params.scenarioId);
+
+  const lines: string[] = [];
+  lines.push("Scenario archived successfully!\n");
+  lines.push(`**ID**: ${result.id}`);
+  lines.push(`**Status**: ${result.archived ? "archived" : "active"}`);
+
+  return lines.join("\n");
+}

package/src/tools/create-evaluator.ts

@@ -0,0 +1,33 @@
+import {
+  createEvaluator as apiCreateEvaluator,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_create_evaluator MCP tool invocation.
+ *
+ * Creates a new evaluator in the LangWatch project and returns a
+ * confirmation with the created evaluator's details.
+ */
+export async function handleCreateEvaluator(params: {
+  name: string;
+  config: Record<string, unknown>;
+}): Promise<string> {
+  const result = await apiCreateEvaluator(params);
+
+  const evaluatorType = getEvaluatorType(result);
+
+  const lines: string[] = [];
+  lines.push("Evaluator created successfully!\n");
+  lines.push(`**ID**: ${result.id}`);
+  if (result.slug) lines.push(`**Slug**: ${result.slug}`);
+  lines.push(`**Name**: ${result.name}`);
+  if (evaluatorType) lines.push(`**Evaluator Type**: ${evaluatorType}`);
+  lines.push(`**Kind**: ${result.type}`);
+
+  if (Array.isArray(result.fields) && result.fields.length > 0) {
+    lines.push(`**Input Fields**: ${result.fields.map((f) => f.identifier).join(", ")}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/create-prompt.ts

@@ -1,7 +1,23 @@
 import { createPrompt as apiCreatePrompt } from "../langwatch-api.js";
 
+const HANDLE_PATTERN = /^[a-z0-9_-]+(?:\/[a-z0-9_-]+)?$/;
+
 /**
- * Handles the create_prompt MCP tool invocation.
+ * Converts a human-readable name into a URL-friendly handle.
+ *
+ * Lowercases the input, replaces non-alphanumeric runs with hyphens,
+ * and strips leading/trailing hyphens. May return an empty string
+ * for inputs with no alphanumeric characters — callers must validate.
+ */
+function toHandle(name: string): string {
+  return name
+    .toLowerCase()
+    .replace(/[^a-z0-9]+/g, "-")
+    .replace(/^-|-$/g, "");
+}
+
+/**
+ * Handles the platform_create_prompt MCP tool invocation.
  *
  * Creates a new prompt in the LangWatch project and returns a
  * confirmation with the created prompt's details.
@@ -11,17 +27,26 @@ export async function handleCreatePrompt(params: {
   handle?: string;
   messages: Array<{ role: string; content: string }>;
   model: string;
-  modelProvider: string;
-  description?: string;
 }): Promise<string> {
-  const result = await apiCreatePrompt(params);
+  const handle = params.handle?.trim() || toHandle(params.name);
+  if (!handle || !HANDLE_PATTERN.test(handle)) {
+    throw new Error(
+      `Invalid prompt handle "${handle || ""}". Handle must match ${HANDLE_PATTERN}. Provide a valid \`handle\` explicitly.`
+    );
+  }
+
+  const result = await apiCreatePrompt({
+    handle,
+    messages: params.messages,
+    model: params.model,
+  });
 
   const lines: string[] = [];
   lines.push("Prompt created successfully!\n");
   if (result.id) lines.push(`**ID**: ${result.id}`);
   if (result.handle) lines.push(`**Handle**: ${result.handle}`);
   lines.push(`**Name**: ${result.name || params.name}`);
-  lines.push(`**Model**: ${params.model} (${params.modelProvider})`);
+  lines.push(`**Model**: ${params.model}`);
   if (result.latestVersionNumber != null)
     lines.push(`**Version**: v${result.latestVersionNumber}`);
 

package/src/tools/create-scenario.ts

@@ -0,0 +1,30 @@
+import { createScenario as apiCreateScenario } from "../langwatch-api-scenarios.js";
+
+/**
+ * Handles the platform_create_scenario MCP tool invocation.
+ *
+ * Creates a new scenario in the LangWatch project and returns a
+ * confirmation with the created scenario's details.
+ */
+export async function handleCreateScenario(params: {
+  name: string;
+  situation: string;
+  criteria?: string[];
+  labels?: string[];
+}): Promise<string> {
+  const result = await apiCreateScenario(params);
+
+  const lines: string[] = [];
+  lines.push("Scenario created successfully!\n");
+  lines.push(`**ID**: ${result.id}`);
+  lines.push(`**Name**: ${result.name}`);
+  lines.push(`**Situation**: ${result.situation}`);
+  if (Array.isArray(result.criteria) && result.criteria.length > 0) {
+    lines.push(`**Criteria**: ${result.criteria.length} criteria`);
+  }
+  if (Array.isArray(result.labels) && result.labels.length > 0) {
+    lines.push(`**Labels**: ${result.labels.join(", ")}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/discover-evaluator-schema.ts

@@ -0,0 +1,143 @@
+import { AVAILABLE_EVALUATORS } from "../../../langevals/ts-integration/evaluators.generated.js";
+import type { EvaluatorDefinition, EvaluatorTypes } from "../../../langevals/ts-integration/evaluators.generated.js";
+
+/**
+ * Formats evaluator schema information for the discover_schema tool.
+ *
+ * Two levels of detail:
+ * - Overview (no evaluatorType): compact list of all evaluator types
+ * - Detail (with evaluatorType): full schema for one evaluator type
+ */
+export function formatEvaluatorSchema(evaluatorType?: string): string {
+  if (evaluatorType) {
+    return formatEvaluatorDetail(evaluatorType);
+  }
+  return formatEvaluatorOverview();
+}
+
+/**
+ * Returns a compact overview of all available evaluator types.
+ * Shows type, name, category, and a one-line description.
+ */
+function formatEvaluatorOverview(): string {
+  const lines: string[] = [];
+  lines.push("# Available Evaluator Types\n");
+
+  const byCategory = new Map<string, { type: string; name: string; description: string }[]>();
+
+  for (const [type, def] of Object.entries(AVAILABLE_EVALUATORS)) {
+    const evalDef = def as EvaluatorDefinition<EvaluatorTypes>;
+    const oneLine = extractFirstLine(evalDef.description);
+    const entry = { type, name: evalDef.name, description: oneLine };
+
+    const list = byCategory.get(evalDef.category) ?? [];
+    list.push(entry);
+    byCategory.set(evalDef.category, list);
+  }
+
+  for (const [category, entries] of byCategory) {
+    lines.push(`## ${category}\n`);
+    for (const entry of entries) {
+      lines.push(`- **${entry.type}** (${entry.name}): ${entry.description}`);
+    }
+    lines.push("");
+  }
+
+  lines.push(
+    "> Use `discover_schema({ category: 'evaluators', evaluatorType: '<type>' })` for full details on a specific evaluator type.",
+  );
+
+  return lines.join("\n");
+}
+
+/**
+ * Returns the full schema for a specific evaluator type.
+ * Includes settings with descriptions and defaults, required/optional fields, env vars, and result fields.
+ */
+function formatEvaluatorDetail(evaluatorType: string): string {
+  const def = AVAILABLE_EVALUATORS[evaluatorType as EvaluatorTypes] as
+    | EvaluatorDefinition<EvaluatorTypes>
+    | undefined;
+
+  if (!def) {
+    return `Unknown evaluator type: "${evaluatorType}". Use \`discover_schema({ category: 'evaluators' })\` to see all available types.`;
+  }
+
+  const lines: string[] = [];
+  lines.push(`# ${def.name} (\`${evaluatorType}\`)\n`);
+  lines.push(`**Category**: ${def.category}`);
+  lines.push(`**Is Guardrail**: ${def.isGuardrail ? "Yes" : "No"}`);
+  if (def.docsUrl) {
+    lines.push(`**Docs**: ${def.docsUrl}`);
+  }
+  lines.push("");
+  lines.push(`## Description\n`);
+  lines.push(def.description.trim());
+
+  // Required and optional fields
+  lines.push("\n## Fields\n");
+  if (def.requiredFields.length > 0) {
+    lines.push(`**Required**: ${def.requiredFields.join(", ")}`);
+  } else {
+    lines.push("**Required**: none");
+  }
+  if (def.optionalFields.length > 0) {
+    lines.push(`**Optional**: ${def.optionalFields.join(", ")}`);
+  }
+
+  // Settings
+  const settingsEntries = Object.entries(def.settings);
+  if (settingsEntries.length > 0) {
+    lines.push("\n## Settings\n");
+    for (const [key, setting] of settingsEntries) {
+      const s = setting as { description?: string; default: unknown };
+      const defaultStr = JSON.stringify(s.default);
+      const desc = s.description ? ` - ${s.description}` : "";
+      lines.push(`- **${key}**${desc}`);
+      lines.push(`  Default: \`${defaultStr}\``);
+    }
+  }
+
+  // Env vars
+  if (def.envVars.length > 0) {
+    lines.push("\n## Required Environment Variables\n");
+    for (const envVar of def.envVars) {
+      lines.push(`- \`${envVar}\``);
+    }
+  }
+
+  // Result fields
+  const resultEntries = Object.entries(def.result);
+  if (resultEntries.length > 0) {
+    lines.push("\n## Result Fields\n");
+    for (const [key, value] of resultEntries) {
+      const v = value as { description: string };
+      lines.push(`- **${key}**: ${v.description}`);
+    }
+  }
+
+  lines.push("\n## Usage Example\n");
+  lines.push("```json");
+  lines.push(JSON.stringify({
+    evaluatorType: evaluatorType,
+    settings: Object.fromEntries(
+      settingsEntries.map(([key, setting]) => [key, (setting as { default: unknown }).default]),
+    ),
+  }, null, 2));
+  lines.push("```");
+
+  return lines.join("\n");
+}
+
+/**
+ * Extracts the first meaningful line from a multi-line description.
+ */
+function extractFirstLine(description: string): string {
+  const trimmed = description.trim();
+  const firstLine = trimmed.split("\n")[0]?.trim() ?? trimmed;
+  // Limit to a reasonable length
+  if (firstLine.length > 120) {
+    return firstLine.slice(0, 117) + "...";
+  }
+  return firstLine;
+}

package/src/tools/discover-scenario-schema.ts

@@ -0,0 +1,71 @@
+/**
+ * Returns a human-readable description of the scenario schema,
+ * including field descriptions, authoring guidance, and examples.
+ */
+export function formatScenarioSchema(): string {
+  const lines: string[] = [];
+
+  lines.push("# Scenario Schema\n");
+
+  lines.push("## Fields\n");
+  lines.push(
+    '- **name** (required): A short, descriptive name (e.g., "billing dispute resolution", "password reset with 2FA unavailable")',
+  );
+  lines.push(
+    "- **situation** (required): The context that guides the user simulator — who the user is, what they want, and any constraints (see Writing a Good Situation below)",
+  );
+  lines.push(
+    "- **criteria** (array of strings): Pass/fail conditions a judge evaluates the agent against (see Writing Good Criteria below)",
+  );
+  lines.push(
+    '- **labels** (array of strings): Tags for organizing scenarios (e.g., "auth", "happy-path", "edge-case")',
+  );
+
+  lines.push("\n## Writing a Good Situation\n");
+  lines.push(
+    "The situation drives the user simulator. Include these elements:",
+  );
+  lines.push("- **Persona**: Who is the user? (e.g., a stressed small business owner, a confused teenager)");
+  lines.push("- **Emotional state**: How are they feeling? (e.g., frustrated, anxious, impatient)");
+  lines.push("- **Background/Context**: What happened before this conversation?");
+  lines.push("- **Intent**: What do they want to accomplish?");
+  lines.push("- **Constraints**: What limitations do they have? (e.g., no phone for 2FA, unfamiliar with technical terms)");
+  lines.push("\nExample:");
+  lines.push("```");
+  lines.push("User is a small business owner stressed about tax deadline.");
+  lines.push("They need help categorizing expenses but aren't familiar with");
+  lines.push("accounting terms. They appreciate patient explanations and examples.");
+  lines.push("They have a spreadsheet of transactions but aren't sure which");
+  lines.push("categories apply to their consulting business.");
+  lines.push("```");
+
+  lines.push("\n## Writing Good Criteria\n");
+  lines.push("Criteria are what the judge uses to pass or fail the agent. Each criterion should be:");
+  lines.push("- **Specific and testable** — not vague like \"responds helpfully\"");
+  lines.push("- **Behavioral** — describes what the agent should *do*, not how it works internally");
+  lines.push("- **Independent** — each criterion checks one thing");
+  lines.push("\nGood criteria patterns:");
+  lines.push("- **Information gathering**: \"Agent asks for the user's account number before proceeding\"");
+  lines.push("- **Safety/guardrails**: \"Agent does not reveal internal system details or error stack traces\"");
+  lines.push("- **Clarification**: \"Agent asks clarifying questions before taking irreversible action\"");
+  lines.push("- **Tone**: \"Agent maintains a professional and empathetic tone throughout\"");
+  lines.push("- **Completeness**: \"Agent confirms the user understands the solution before ending\"");
+  lines.push("- **Domain-specific**: \"Agent recommends releasing a wild frog rather than keeping it as a pet\"");
+  lines.push("\nAvoid vague criteria like:");
+  lines.push('- "Responds correctly" — correct how?');
+  lines.push('- "Is helpful" — helpful in what way?');
+  lines.push('- "Works well" — not testable');
+
+  lines.push("\n## Target Types\n");
+  lines.push("Scenarios can target different execution backends:");
+  lines.push("- **prompt**: Test a prompt template with variable substitution");
+  lines.push("- **http**: Test an HTTP endpoint (e.g., a deployed agent API)");
+  lines.push("- **code**: Test a code function directly");
+
+  lines.push("\n## Tips\n");
+  lines.push("- Start simple, then layer complexity (add constraints, edge cases)");
+  lines.push("- Test edge cases: user changes their mind, gives ambiguous input, makes mistakes");
+  lines.push("- Use `fetch_scenario_docs` for the full authoring guide and advanced patterns");
+
+  return lines.join("\n");
+}

package/src/tools/get-evaluator.ts

@@ -0,0 +1,53 @@
+import {
+  getEvaluator as apiGetEvaluator,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_get_evaluator MCP tool invocation.
+ *
+ * Retrieves a specific evaluator by ID or slug and formats it as
+ * AI-readable markdown.
+ */
+export async function handleGetEvaluator(params: {
+  idOrSlug: string;
+}): Promise<string> {
+  const evaluator = await apiGetEvaluator(params.idOrSlug);
+
+  const evaluatorType = getEvaluatorType(evaluator);
+
+  const lines: string[] = [];
+  lines.push(`# Evaluator: ${evaluator.name}\n`);
+  lines.push(`**ID**: ${evaluator.id}`);
+  if (evaluator.slug) lines.push(`**Slug**: ${evaluator.slug}`);
+  lines.push(`**Kind**: ${evaluator.type}`);
+  if (evaluatorType) lines.push(`**Evaluator Type**: ${evaluatorType}`);
+
+  if (evaluator.config) {
+    lines.push("\n## Config");
+    lines.push("```json");
+    lines.push(JSON.stringify(evaluator.config, null, 2));
+    lines.push("```");
+  }
+
+  if (Array.isArray(evaluator.fields) && evaluator.fields.length > 0) {
+    lines.push("\n## Input Fields");
+    for (const field of evaluator.fields) {
+      const opt = field.optional ? " (optional)" : "";
+      lines.push(`- **${field.identifier}** (${field.type})${opt}`);
+    }
+  }
+
+  if (Array.isArray(evaluator.outputFields) && evaluator.outputFields.length > 0) {
+    lines.push("\n## Output Fields");
+    for (const field of evaluator.outputFields) {
+      lines.push(`- **${field.identifier}** (${field.type})`);
+    }
+  }
+
+  if (evaluator.workflowName) {
+    lines.push(`\n**Workflow**: ${evaluator.workflowName}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/get-prompt.ts

@@ -1,7 +1,7 @@
 import { getPrompt as apiGetPrompt } from "../langwatch-api.js";
 
 /**
- * Handles the get_prompt MCP tool invocation.
+ * Handles the platform_get_prompt MCP tool invocation.
  *
  * Retrieves a specific prompt by ID or handle and formats it as
  * AI-readable markdown, including messages, model config, and version history.
@@ -19,15 +19,12 @@ export async function handleGetPrompt(params: {
 
   if (prompt.handle) lines.push(`**Handle**: ${prompt.handle}`);
   if (prompt.id) lines.push(`**ID**: ${prompt.id}`);
-  if (prompt.description) lines.push(`**Description**: ${prompt.description}`);
   if (prompt.latestVersionNumber != null)
     lines.push(`**Latest Version**: v${prompt.latestVersionNumber}`);
 
   // Show model config
   const version = prompt.versions?.[0] ?? prompt;
   if (version.model) lines.push(`**Model**: ${version.model}`);
-  if (version.modelProvider)
-    lines.push(`**Provider**: ${version.modelProvider}`);
 
   // Show messages
   const messages = version.messages || prompt.prompt || [];

package/src/tools/get-scenario.ts

@@ -0,0 +1,36 @@
+import { getScenario as apiGetScenario } from "../langwatch-api-scenarios.js";
+
+/**
+ * Handles the get_scenario MCP tool invocation.
+ *
+ * Retrieves a specific scenario by ID and formats it as
+ * AI-readable markdown or raw JSON.
+ */
+export async function handleGetScenario(params: {
+  scenarioId: string;
+  format?: "digest" | "json";
+}): Promise<string> {
+  const scenario = await apiGetScenario(params.scenarioId);
+
+  if (params.format === "json") {
+    return JSON.stringify(scenario, null, 2);
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Scenario: ${scenario.name}\n`);
+  lines.push(`**ID**: ${scenario.id}`);
+  lines.push(`**Situation**: ${scenario.situation}`);
+
+  if (Array.isArray(scenario.criteria) && scenario.criteria.length > 0) {
+    lines.push("\n## Criteria");
+    for (const criterion of scenario.criteria) {
+      lines.push(`- ${criterion}`);
+    }
+  }
+
+  if (Array.isArray(scenario.labels) && scenario.labels.length > 0) {
+    lines.push(`\n**Labels**: ${scenario.labels.join(", ")}`);
+  }
+
+  return lines.join("\n");
+}

package/src/tools/list-evaluators.ts

@@ -0,0 +1,37 @@
+import {
+  listEvaluators as apiListEvaluators,
+  getEvaluatorType,
+} from "../langwatch-api-evaluators.js";
+
+/**
+ * Handles the platform_list_evaluators MCP tool invocation.
+ *
+ * Lists all evaluators in the LangWatch project, formatted as an
+ * AI-readable digest.
+ */
+export async function handleListEvaluators(): Promise<string> {
+  const evaluators = await apiListEvaluators();
+
+  if (!Array.isArray(evaluators) || evaluators.length === 0) {
+    return "No evaluators found in this project.\n\n> Tip: Use `platform_create_evaluator` to create your first evaluator. Call `discover_schema({ category: 'evaluators' })` to see available evaluator types.";
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Evaluators (${evaluators.length} total)\n`);
+
+  for (const e of evaluators) {
+    const evaluatorType = getEvaluatorType(e);
+    lines.push(`## ${e.name}`);
+    lines.push(`**ID**: ${e.id}`);
+    if (e.slug) lines.push(`**Slug**: ${e.slug}`);
+    if (evaluatorType) lines.push(`**Type**: ${evaluatorType}`);
+    lines.push(`**Kind**: ${e.type}`);
+    lines.push("");
+  }
+
+  lines.push(
+    "> Use `platform_get_evaluator` with the ID or slug to see full evaluator details.",
+  );
+
+  return lines.join("\n");
+}

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

@@ -0,0 +1,40 @@
+import { listModelProviders as apiListModelProviders } from "../langwatch-api-model-providers.js";
+
+/**
+ * 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).
+ */
+export async function handleListModelProviders(): Promise<string> {
+  const providers = await apiListModelProviders();
+
+  const entries = Object.entries(providers);
+  if (entries.length === 0) {
+    return "No model providers configured for this project.\n\n> Tip: Use `platform_set_model_provider` to configure an API key for a model provider.";
+  }
+
+  const lines: string[] = [];
+  lines.push(`# Model Providers (${entries.length} total)\n`);
+
+  for (const [key, provider] of entries) {
+    const status = provider.enabled ? "enabled" : "disabled";
+    lines.push(`## ${key}`);
+    lines.push(`**Status**: ${status}`);
+
+    if (provider.customKeys) {
+      const keyFields = Object.entries(provider.customKeys)
+        .map(([k, v]) => `${k}: ${v ? "set" : "not set"}`)
+        .join(", ");
+      lines.push(`**Keys**: ${keyFields}`);
+    }
+
+    if (provider.models && provider.models.length > 0) {
+      lines.push(`**Models**: ${provider.models.length} available`);
+    }
+
+    lines.push("");
+  }
+
+  return lines.join("\n");
+}

package/src/tools/list-prompts.ts

@@ -1,7 +1,7 @@
 import { listPrompts as apiListPrompts } from "../langwatch-api.js";
 
 /**
- * Handles the list_prompts MCP tool invocation.
+ * Handles the platform_list_prompts MCP tool invocation.
  *
  * Lists all prompts in the LangWatch project, formatted as an
  * AI-readable markdown table.
@@ -15,20 +15,19 @@ export async function handleListPrompts(): Promise<string> {
 
   const lines: string[] = [];
   lines.push(`# Prompts (${prompts.length} total)\n`);
-  lines.push("| Handle | Name | Latest Version | Description |");
-  lines.push("|--------|------|----------------|-------------|");
+  lines.push("| Handle | Name | Latest Version |");
+  lines.push("|--------|------|----------------|");
 
   for (const p of prompts) {
     const handle = p.handle || p.id || "N/A";
     const name = p.name || "Untitled";
     const versionNum = p.latestVersionNumber ?? p.version;
     const version = versionNum != null ? `v${versionNum}` : "N/A";
-    const desc = (p.description || "").slice(0, 60);
-    lines.push(`| ${handle} | ${name} | ${version} | ${desc} |`);
+    lines.push(`| ${handle} | ${name} | ${version} |`);
   }
 
   lines.push(
-    "\n> Use `get_prompt` with the handle or ID to see full prompt details."
+    "\n> Use `platform_get_prompt` with the handle or ID to see full prompt details."
   );
 
   return lines.join("\n");