@steuerboard/mcp 0.3.3 → 0.4.0

package/src/mcp-server/cli/start/impl.ts

@@ -5,25 +5,30 @@
 import { SSEServerTransport } from "@modelcontextprotocol/sdk/server/sse.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import express from "express";
-import { SDKOptions } from "../../../lib/config.js";
 import { LocalContext } from "../../cli.js";
 import {
   ConsoleLoggerLevel,
   createConsoleLogger,
 } from "../../console-logger.js";
+import { MCPServerFlags } from "../../flags.js";
 import { createMCPServer } from "../../server.js";
+import { buildAnnotationFilter } from "../../tools.js";
 
-interface StartCommandFlags {
+import { landingPageExpress } from "../../../landing-page.js";
+
+interface StartCommandFlags extends MCPServerFlags {
   readonly transport: "stdio" | "sse";
   readonly port: number;
-  readonly tool?: string[];
-  readonly "bearer-auth"?: string;
-  readonly "server-url"?: string;
-  readonly "server-index"?: SDKOptions["serverIdx"];
   readonly "log-level": ConsoleLoggerLevel;
   readonly env?: [string, string][];
 }
 
+interface Session {
+  mcpServer: ReturnType<typeof createMCPServer>["server"];
+  transport: SSEServerTransport;
+  cleanup: () => Promise<void>;
+}
+
 export async function main(this: LocalContext, flags: StartCommandFlags) {
   flags.env?.forEach(([key, value]) => {
     process.env[key] = value;
@@ -44,9 +49,11 @@ export async function main(this: LocalContext, flags: StartCommandFlags) {
 async function startStdio(flags: StartCommandFlags) {
   const logger = createConsoleLogger(flags["log-level"]);
   const transport = new StdioServerTransport();
-  const server = createMCPServer({
+  const { server } = createMCPServer({
     logger,
     allowedTools: flags.tool,
+    dynamic: flags.mode === "dynamic",
+    annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
     security: { bearerAuth: flags["bearer-auth"] ?? "" },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
@@ -61,38 +68,109 @@ async function startStdio(flags: StartCommandFlags) {
   process.on("SIGINT", abort);
 }
 
-async function startSSE(flags: StartCommandFlags) {
-  const logger = createConsoleLogger(flags["log-level"]);
+async function startSSE(cliFlags: StartCommandFlags) {
+  const logger = createConsoleLogger(cliFlags["log-level"]);
   const app = express();
-  const mcpServer = createMCPServer({
-    logger,
-    allowedTools: flags.tool,
-    security: { bearerAuth: flags["bearer-auth"] ?? "" },
-    serverURL: flags["server-url"],
-    serverIdx: flags["server-index"],
-  });
-  let transport: SSEServerTransport | undefined;
+  const sessions = new Map<string, Session>();
   const controller = new AbortController();
 
-  app.get("/sse", async (_req, res) => {
-    transport = new SSEServerTransport("/message", res);
+  app.get("/sse", async (req, res) => {
+    const sessionId = crypto.randomUUID();
+
+    logger.info("SSE connection initiated", {
+      sessionId,
+      userAgent: req.headers["user-agent"],
+    });
+
+    // Track early disconnection
+    let connectionClosed = false;
+    res.on("close", () => {
+      if (!connectionClosed) {
+        logger.info("Connection closed early", { sessionId });
+      }
+      connectionClosed = true;
+    });
+
+    // Merge CLI flags with header overrides for security credentials
+    const flags: StartCommandFlags = {
+      ...cliFlags,
+      // Security fields can be overridden via headers
+      "bearer-auth": (req.headers["bearerauth"] as string)
+        ?? cliFlags["bearer-auth"],
+    };
+
+    // Create a new MCP server for this connection with its auth
+    const { server: mcpServer } = createMCPServer({
+      logger,
+      allowedTools: flags.tool,
+      dynamic: flags.mode === "dynamic",
+      annotationFilter: buildAnnotationFilter(flags["tool-annotations"]),
+      security: { bearerAuth: flags["bearer-auth"] ?? "" },
+      serverURL: flags["server-url"],
+      serverIdx: flags["server-index"],
+    });
+
+    // Message path includes session ID for routing
+    const transport = new SSEServerTransport(`/message/${sessionId}`, res);
+
+    const cleanup = async () => {
+      await mcpServer.close();
+    };
+
+    sessions.set(sessionId, { mcpServer, transport, cleanup });
+    logger.info("Session created", { sessionId, totalSessions: sessions.size });
+    controller.signal.addEventListener("abort", cleanup);
+
+    // Log server-side errors for debugging (e.g. tools/list handler failures)
+    mcpServer.server.onerror = (error) => {
+      logger.error("MCP protocol error", {
+        sessionId,
+        error: error instanceof Error ? error.message : String(error),
+        stack: error instanceof Error ? error.stack : undefined,
+      });
+    };
+
+    // Wrap transport.send to log error responses for debugging
+    const originalSend = transport.send.bind(transport);
+    transport.send = async (message) => {
+      if ("error" in message && message.error) {
+        logger.error("MCP sending error response", {
+          sessionId,
+          id: message.id,
+          errorCode: message.error.code,
+          errorMessage: message.error.message,
+        });
+      }
+      return originalSend(message);
+    };
 
     await mcpServer.connect(transport);
 
     mcpServer.server.onclose = async () => {
+      connectionClosed = true;
+      controller.signal.removeEventListener("abort", cleanup);
+      sessions.delete(sessionId);
+      logger.info("Session closed", {
+        sessionId,
+        totalSessions: sessions.size,
+      });
       res.end();
     };
   });
 
-  app.post("/message", async (req, res) => {
-    if (!transport) {
-      throw new Error("Server transport not initialized");
+  app.post("/message/:sessionId", async (req, res) => {
+    const session = sessions.get(req.params.sessionId);
+    if (!session) {
+      res.status(404).send("Session not found");
+      return;
     }
 
-    await transport.handlePostMessage(req, res);
+    await session.transport.handlePostMessage(req, res);
   });
 
-  const httpServer = app.listen(flags.port, "0.0.0.0", () => {
+  app.get("/", landingPageExpress);
+
+  const httpServer = app.listen(cliFlags.port, "0.0.0.0", () => {
     const ha = httpServer.address();
     const host = typeof ha === "string" ? ha : `${ha?.address}:${ha?.port}`;
     logger.info("MCP HTTP server started", { host });
@@ -106,10 +184,6 @@ async function startSSE(flags: StartCommandFlags) {
     }
     closing = true;
 
-    logger.info("Shutting down MCP server");
-
-    await mcpServer.close();
-
     logger.info("Shutting down HTTP server");
 
     const timer = setTimeout(() => {

package/src/mcp-server/extensions.ts

@@ -2,16 +2,18 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { ZodRawShape } from "zod";
-import { PromptArgsRawShape, PromptDefinition } from "./prompts.js";
+import { ZodRawShapeCompat } from "@modelcontextprotocol/sdk/server/zod-compat.js";
+import { PromptDefinition } from "./prompts.js";
 import { ResourceDefinition, ResourceTemplateDefinition } from "./resources.js";
 import { ToolDefinition } from "./tools.js";
 
 export type Register = {
-  tool: <A extends ZodRawShape | undefined>(def: ToolDefinition<A>) => void;
+  tool: <A extends ZodRawShapeCompat | undefined>(
+    def: ToolDefinition<A>,
+  ) => void;
   resource: (def: ResourceDefinition) => void;
   resourceTemplate: (def: ResourceTemplateDefinition) => void;
-  prompt: <A extends PromptArgsRawShape | undefined>(
+  prompt: <A extends ZodRawShapeCompat | undefined>(
     prompt: PromptDefinition<A>,
   ) => void;
 };

package/src/mcp-server/flags.ts

@@ -0,0 +1,18 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { SDKOptions } from "../lib/config.js";
+
+/**
+ * Base flags interface for MCP server configuration.
+ * Used by both CLI start command and Gram deployment wrapper.
+ */
+export interface MCPServerFlags {
+  readonly tool?: string[];
+  readonly mode?: "dynamic" | undefined;
+  readonly "tool-annotations"?: string[] | undefined;
+  readonly "bearer-auth"?: string | undefined;
+  readonly "server-url"?: string | undefined;
+  readonly "server-index"?: SDKOptions["serverIdx"];
+}

package/src/mcp-server/mcp-server.ts

@@ -5,11 +5,13 @@
 import { buildApplication, buildRouteMap, run } from "@stricli/core";
 import process from "node:process";
 import { buildContext } from "./cli.js";
+import { serveCommand } from "./cli/serve/command.js";
 import { startCommand } from "./cli/start/command.js";
 
 const routes = buildRouteMap({
   routes: {
     start: startCommand,
+    serve: serveCommand,
   },
   docs: {
     brief: "MCP server CLI",
@@ -19,7 +21,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.3.3",
+    currentVersion: "0.4.0",
   },
 });
 

package/src/mcp-server/prompts.ts

@@ -3,40 +3,30 @@
  */
 
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import {
+  ShapeOutput,
+  ZodRawShapeCompat,
+} from "@modelcontextprotocol/sdk/server/zod-compat.js";
 import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import {
   GetPromptResult,
   ServerNotification,
   ServerRequest,
 } from "@modelcontextprotocol/sdk/types.js";
-import {
-  objectOutputType,
-  ZodOptional,
-  ZodType,
-  ZodTypeAny,
-  ZodTypeDef,
-} from "zod";
 import { SteuerboardCore } from "../core.js";
 import { ConsoleLogger } from "./console-logger.js";
 import { MCPScope } from "./scopes.js";
 
-// '@modelcontextprotocol/sdk' currently does not export this type
-export type PromptArgsRawShape = {
-  [k: string]:
-    | ZodType<string, ZodTypeDef, string>
-    | ZodOptional<ZodType<string, ZodTypeDef, string>>;
-};
-
 export type PromptDefinition<
-  Args extends undefined | PromptArgsRawShape = undefined,
-> = Args extends PromptArgsRawShape ? {
+  Args extends undefined | ZodRawShapeCompat = undefined,
+> = Args extends ZodRawShapeCompat ? {
     name: string;
     description?: string;
     scopes?: MCPScope[];
     args: Args;
     prompt: (
       client: SteuerboardCore,
-      args: objectOutputType<Args, ZodTypeAny>,
+      args: ShapeOutput<Args>,
       extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
     ) => GetPromptResult | Promise<GetPromptResult>;
   }
@@ -71,10 +61,10 @@ export function createRegisterPrompt(
   server: McpServer,
   getSDK: () => SteuerboardCore,
   allowedScopes: Set<MCPScope>,
-): <A extends PromptArgsRawShape | undefined>(
+): <A extends ZodRawShapeCompat | undefined>(
   prompt: PromptDefinition<A>,
 ) => void {
-  return <A extends PromptArgsRawShape | undefined>(
+  return <A extends ZodRawShapeCompat | undefined>(
     prompt: PromptDefinition<A>,
   ): void => {
     const scopes = prompt.scopes ?? [];

package/src/mcp-server/server.ts

@@ -12,7 +12,11 @@ import {
   createRegisterResourceTemplate,
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
-import { createRegisterTool } from "./tools.js";
+import {
+  createRegisterTool,
+  MCPToolAnnotationFilter,
+  registerDynamicTools,
+} from "./tools.js";
 import { tool$adminClientsCreateClient } from "./tools/adminClientsCreateClient.js";
 import { tool$adminClientsGetClient } from "./tools/adminClientsGetClient.js";
 import { tool$adminClientsListClients } from "./tools/adminClientsListClients.js";
@@ -23,11 +27,21 @@ import { tool$adminUsersInviteAccountantUser } from "./tools/adminUsersInviteAcc
 import { tool$adminUsersListAccountantUsers } from "./tools/adminUsersListAccountantUsers.js";
 import { tool$adminUsersUpdateAccountantUser } from "./tools/adminUsersUpdateAccountantUser.js";
 import { tool$authMe } from "./tools/authMe.js";
+import { tool$collectSessionsCompleteCollectSession } from "./tools/collectSessionsCompleteCollectSession.js";
+import { tool$collectSessionsDeleteCollectSubmission } from "./tools/collectSessionsDeleteCollectSubmission.js";
+import { tool$collectSessionsGetcollectSessionByToken } from "./tools/collectSessionsGetcollectSessionByToken.js";
+import { tool$collectSessionsPingCollectSession } from "./tools/collectSessionsPingCollectSession.js";
+import { tool$collectSessionsRequestLinkCollectToken } from "./tools/collectSessionsRequestLinkCollectToken.js";
+import { tool$collectSessionsSubmitCollectBulk } from "./tools/collectSessionsSubmitCollectBulk.js";
+import { tool$collectSessionsSubmitCollectFile } from "./tools/collectSessionsSubmitCollectFile.js";
+import { tool$collectSessionsSubmitCollectFormData } from "./tools/collectSessionsSubmitCollectFormData.js";
 import { tool$filesCreateFile } from "./tools/filesCreateFile.js";
 import { tool$filesDeleteFile } from "./tools/filesDeleteFile.js";
+import { tool$filesDownloadFileContent } from "./tools/filesDownloadFileContent.js";
 import { tool$filesGetFile } from "./tools/filesGetFile.js";
 import { tool$filesListFiles } from "./tools/filesListFiles.js";
 import { tool$filesUpdateFile } from "./tools/filesUpdateFile.js";
+import { tool$healthHealth } from "./tools/healthHealth.js";
 import { tool$healthIndex } from "./tools/healthIndex.js";
 import { tool$healthPing } from "./tools/healthPing.js";
 import { tool$tasksCreateTask } from "./tools/tasksCreateTask.js";
@@ -51,7 +65,9 @@ import { tool$workspacesUpdateWorkspace } from "./tools/workspacesUpdateWorkspac
 export function createMCPServer(deps: {
   logger: ConsoleLogger;
   allowedTools?: string[] | undefined;
+  dynamic?: boolean | undefined;
   scopes?: MCPScope[] | undefined;
+  annotationFilter?: MCPToolAnnotationFilter | undefined;
   getSDK?: () => SteuerboardCore;
   serverURL?: string | undefined;
   security?: SDKOptions["security"] | undefined;
@@ -59,7 +75,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Steuerboard",
-    version: "0.3.3",
+    version: "0.4.0",
   });
 
   const getClient = deps.getSDK || (() =>
@@ -79,12 +95,14 @@ export function createMCPServer(deps: {
   const scopes = new Set(deps.scopes);
 
   const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
-  const tool = createRegisterTool(
+  const [tool, tools, toolMap] = createRegisterTool(
     deps.logger,
     server,
     getClient,
     scopes,
     allowedTools,
+    deps.dynamic,
+    deps.annotationFilter,
   );
   const resource = createRegisterResource(
     deps.logger,
@@ -103,6 +121,7 @@ export function createMCPServer(deps: {
   void register; // suppress unused warnings
 
   tool(tool$healthIndex);
+  tool(tool$healthHealth);
   tool(tool$healthPing);
   tool(tool$authMe);
   tool(tool$adminClientsListClients);
@@ -112,8 +131,16 @@ export function createMCPServer(deps: {
   tool(tool$adminUsersListAccountantUsers);
   tool(tool$adminUsersInviteAccountantUser);
   tool(tool$adminUsersGetAccountantUser);
-  tool(tool$adminUsersUpdateAccountantUser);
   tool(tool$adminUsersDeleteAccountantUser);
+  tool(tool$adminUsersUpdateAccountantUser);
+  tool(tool$collectSessionsGetcollectSessionByToken);
+  tool(tool$collectSessionsPingCollectSession);
+  tool(tool$collectSessionsCompleteCollectSession);
+  tool(tool$collectSessionsRequestLinkCollectToken);
+  tool(tool$collectSessionsSubmitCollectFile);
+  tool(tool$collectSessionsSubmitCollectFormData);
+  tool(tool$collectSessionsSubmitCollectBulk);
+  tool(tool$collectSessionsDeleteCollectSubmission);
   tool(tool$workspacesListWorkspaces);
   tool(tool$workspacesCreateWorkspace);
   tool(tool$workspacesGetWorkspace);
@@ -124,18 +151,23 @@ export function createMCPServer(deps: {
   tool(tool$filesListFiles);
   tool(tool$filesCreateFile);
   tool(tool$filesGetFile);
-  tool(tool$filesUpdateFile);
   tool(tool$filesDeleteFile);
+  tool(tool$filesUpdateFile);
+  tool(tool$filesDownloadFileContent);
   tool(tool$tasksListTasks);
   tool(tool$tasksCreateTask);
   tool(tool$tasksGetTask);
-  tool(tool$tasksUpdateTask);
   tool(tool$tasksDeleteTask);
+  tool(tool$tasksUpdateTask);
   tool(tool$usersListUsers);
   tool(tool$usersInviteUser);
   tool(tool$usersGetUser);
-  tool(tool$usersUpdateUser);
   tool(tool$usersDeleteUser);
+  tool(tool$usersUpdateUser);
+
+  if (deps.dynamic) {
+    registerDynamicTools(deps.logger, server, getClient, toolMap, scopes);
+  }
 
-  return server;
+  return { server, tools };
 }

package/src/mcp-server/tools/adminClientsCreateClient.ts

@@ -7,7 +7,7 @@ import { ClientCreate$zodSchema } from "../../models/clientcreate.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: ClientCreate$zodSchema,
+  request: ClientCreate$zodSchema.describe(`Client create`),
 };
 
 export const tool$adminClientsCreateClient: ToolDefinition<typeof args> = {
@@ -16,6 +16,7 @@ export const tool$adminClientsCreateClient: ToolDefinition<typeof args> = {
 
 Creates a new client for the accountant and returns the created client.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/adminClientsGetClient.ts

@@ -16,6 +16,7 @@ export const tool$adminClientsGetClient: ToolDefinition<typeof args> = {
 
 Returns a single client by ID.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/adminClientsListClients.ts

@@ -16,6 +16,7 @@ export const tool$adminClientsListClients: ToolDefinition<typeof args> = {
 
 Returns a paginated list of clients.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/adminClientsUpdateClient.ts

@@ -16,6 +16,7 @@ export const tool$adminClientsUpdateClient: ToolDefinition<typeof args> = {
 
 Updates a client by ID.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/adminUsersDeleteAccountantUser.ts

@@ -17,6 +17,7 @@ export const tool$adminUsersDeleteAccountantUser: ToolDefinition<typeof args> =
 
 Deletes an accountant user by ID.`,
     annotations: {
+      "title": "",
       "destructiveHint": true,
       "idempotentHint": false,
       "openWorldHint": false,

package/src/mcp-server/tools/adminUsersGetAccountantUser.ts

@@ -16,6 +16,7 @@ export const tool$adminUsersGetAccountantUser: ToolDefinition<typeof args> = {
 
 Returns a single accountant user by ID.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/adminUsersInviteAccountantUser.ts

@@ -7,7 +7,7 @@ import { InviteAccountantUser$zodSchema } from "../../models/inviteaccountantuse
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: InviteAccountantUser$zodSchema,
+  request: InviteAccountantUser$zodSchema.describe(`Invite accountant user`),
 };
 
 export const tool$adminUsersInviteAccountantUser: ToolDefinition<typeof args> =
@@ -17,6 +17,7 @@ export const tool$adminUsersInviteAccountantUser: ToolDefinition<typeof args> =
 
 Invites a new accountant user and returns the created record.`,
     annotations: {
+      "title": "",
       "destructiveHint": false,
       "idempotentHint": false,
       "openWorldHint": false,

package/src/mcp-server/tools/adminUsersListAccountantUsers.ts

@@ -16,6 +16,7 @@ export const tool$adminUsersListAccountantUsers: ToolDefinition<typeof args> = {
 
 Returns a paginated list of accountant users.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/adminUsersUpdateAccountantUser.ts

@@ -17,6 +17,7 @@ export const tool$adminUsersUpdateAccountantUser: ToolDefinition<typeof args> =
 
 Updates an accountant user by ID.`,
     annotations: {
+      "title": "",
       "destructiveHint": false,
       "idempotentHint": false,
       "openWorldHint": false,

package/src/mcp-server/tools/authMe.ts

@@ -11,6 +11,7 @@ export const tool$authMe: ToolDefinition = {
 
 Returns information about the authenticated principal.`,
   annotations: {
+    "title": "",
     "destructiveHint": false,
     "idempotentHint": false,
     "openWorldHint": false,

package/src/mcp-server/tools/collectSessionsCompleteCollectSession.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsCompleteCollectSession } from "../../funcs/collectSessionsCompleteCollectSession.js";
+import { CompleteCollectSessionRequest$zodSchema } from "../../models/completecollectsessionop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CompleteCollectSessionRequest$zodSchema,
+};
+
+export const tool$collectSessionsCompleteCollectSession: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-complete-collect-session",
+  description: `Complete collect session
+
+Marks the session as completed by the client, optionally with a note about missing documents.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsCompleteCollectSession(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};

package/src/mcp-server/tools/collectSessionsDeleteCollectSubmission.ts

@@ -0,0 +1,46 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { collectSessionsDeleteCollectSubmission } from "../../funcs/collectSessionsDeleteCollectSubmission.js";
+import { DeleteCollectSubmissionRequest$zodSchema } from "../../models/deletecollectsubmissionop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: DeleteCollectSubmissionRequest$zodSchema,
+};
+
+export const tool$collectSessionsDeleteCollectSubmission: ToolDefinition<
+  typeof args
+> = {
+  name: "collect-sessions-delete-collect-submission",
+  description: `Delete a collect submission
+
+Deletes a pending submission and its associated file from storage.`,
+  annotations: {
+    "title": "",
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await collectSessionsDeleteCollectSubmission(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    const value = result.value;
+
+    return formatResult(value, apiCall);
+  },
+};