@steuerboard/mcp 0.0.1

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { filesGetFile } from "../../funcs/filesGetFile.js";
+import { GetFileRequest$zodSchema } from "../../models/getfileop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: GetFileRequest$zodSchema,
+};
+
+export const tool$filesGetFile: ToolDefinition<typeof args> = {
+  name: "files-get-file",
+  description: `Get a file
+
+Returns a single file object by ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await filesGetFile(
+      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/filesListFiles.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { filesListFiles } from "../../funcs/filesListFiles.js";
+import { ListFilesRequest$zodSchema } from "../../models/listfilesop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ListFilesRequest$zodSchema,
+};
+
+export const tool$filesListFiles: ToolDefinition<typeof args> = {
+  name: "files-list-files",
+  description: `List files
+
+Returns a paginated list of files. Optionally you can filter by workspace.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await filesListFiles(
+      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/filesUpdateFile.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { filesUpdateFile } from "../../funcs/filesUpdateFile.js";
+import { UpdateFileRequest$zodSchema } from "../../models/updatefileop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: UpdateFileRequest$zodSchema,
+};
+
+export const tool$filesUpdateFile: ToolDefinition<typeof args> = {
+  name: "files-update-file",
+  description: `Update a file
+
+Updates a file object.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await filesUpdateFile(
+      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/healthCheckGetV1.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { healthCheckGetV1 } from "../../funcs/healthCheckGetV1.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+export const tool$healthCheckGetV1: ToolDefinition = {
+  name: "health-check-get-v1",
+  description: `Index`,
+  tool: async (client, ctx) => {
+    const [result, apiCall] = await healthCheckGetV1(
+      client,
+      { 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/healthCheckGetV1Ping.ts

@@ -0,0 +1,28 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { healthCheckGetV1Ping } from "../../funcs/healthCheckGetV1Ping.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+export const tool$healthCheckGetV1Ping: ToolDefinition = {
+  name: "health-check-get-v1-ping",
+  description: `Ping`,
+  tool: async (client, ctx) => {
+    const [result, apiCall] = await healthCheckGetV1Ping(
+      client,
+      { 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/tasksCreateTask.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tasksCreateTask } from "../../funcs/tasksCreateTask.js";
+import { CreateTaskRequest$zodSchema } from "../../models/createtaskop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: CreateTaskRequest$zodSchema,
+};
+
+export const tool$tasksCreateTask: ToolDefinition<typeof args> = {
+  name: "tasks-create-task",
+  description: `Create a task
+
+Creates a new task and returns the created task object.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await tasksCreateTask(
+      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/tasksDeleteTask.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tasksDeleteTask } from "../../funcs/tasksDeleteTask.js";
+import { DeleteTaskRequest$zodSchema } from "../../models/deletetaskop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: DeleteTaskRequest$zodSchema,
+};
+
+export const tool$tasksDeleteTask: ToolDefinition<typeof args> = {
+  name: "tasks-delete-task",
+  description: `Delete a task
+
+Deletes a task by ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await tasksDeleteTask(
+      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/tasksGetTask.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tasksGetTask } from "../../funcs/tasksGetTask.js";
+import { GetTaskRequest$zodSchema } from "../../models/gettaskop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: GetTaskRequest$zodSchema,
+};
+
+export const tool$tasksGetTask: ToolDefinition<typeof args> = {
+  name: "tasks-get-task",
+  description: `Get a task
+
+Returns a single task object by ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await tasksGetTask(
+      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/tasksListTasks.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tasksListTasks } from "../../funcs/tasksListTasks.js";
+import { ListTasksRequest$zodSchema } from "../../models/listtasksop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ListTasksRequest$zodSchema.optional(),
+};
+
+export const tool$tasksListTasks: ToolDefinition<typeof args> = {
+  name: "tasks-list-tasks",
+  description: `List tasks
+
+Returns a paginated list of tasks. Optionally you can filter by client or workspace.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await tasksListTasks(
+      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/tasksUpdateTask.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { tasksUpdateTask } from "../../funcs/tasksUpdateTask.js";
+import { UpdateTaskRequest$zodSchema } from "../../models/updatetaskop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: UpdateTaskRequest$zodSchema,
+};
+
+export const tool$tasksUpdateTask: ToolDefinition<typeof args> = {
+  name: "tasks-update-task",
+  description: `Update a task
+
+Updates an existing task object.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await tasksUpdateTask(
+      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/workspacesGetWorkspace.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { workspacesGetWorkspace } from "../../funcs/workspacesGetWorkspace.js";
+import { GetWorkspaceRequest$zodSchema } from "../../models/getworkspaceop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: GetWorkspaceRequest$zodSchema,
+};
+
+export const tool$workspacesGetWorkspace: ToolDefinition<typeof args> = {
+  name: "workspaces-get-workspace",
+  description: `Get a workspace
+
+Returns a single workspace object by ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await workspacesGetWorkspace(
+      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/workspacesListWorkspaces.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { workspacesListWorkspaces } from "../../funcs/workspacesListWorkspaces.js";
+import { ListWorkspacesRequest$zodSchema } from "../../models/listworkspacesop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ListWorkspacesRequest$zodSchema,
+};
+
+export const tool$workspacesListWorkspaces: ToolDefinition<typeof args> = {
+  name: "workspaces-list-workspaces",
+  description: `List workspaces
+
+Returns a paginated list of workspaces.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await workspacesListWorkspaces(
+      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.ts

@@ -0,0 +1,135 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import {
+	CallToolResult,
+	ServerNotification,
+	ServerRequest,
+} from "@modelcontextprotocol/sdk/types.js";
+import { objectOutputType, ZodRawShape, ZodTypeAny } from "zod";
+import { SteuerboardCore } from "../core.js";
+import { ConsoleLogger } from "./console-logger.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
+	Args extends ZodRawShape
+		? {
+				name: string;
+				description: string;
+				scopes?: MCPScope[];
+				args: Args;
+				tool: (
+					client: SteuerboardCore,
+					args: objectOutputType<Args, ZodTypeAny>,
+					extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
+				) => CallToolResult | Promise<CallToolResult>;
+			}
+		: {
+				name: string;
+				description: string;
+				scopes?: MCPScope[];
+				args?: undefined;
+				tool: (
+					client: SteuerboardCore,
+					extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
+				) => CallToolResult | Promise<CallToolResult>;
+			};
+
+// Optional function to assist with formatting tool results
+export async function formatResult(
+	value: unknown,
+	init: { response?: Response | undefined },
+): Promise<CallToolResult> {
+	if (typeof value === "undefined") {
+		return { content: [] };
+	}
+
+	const { response } = init;
+	const contentType = response?.headers.get("content-type") ?? "";
+	let content: CallToolResult["content"] = [];
+
+	if (/\bjson\b/i.test(contentType)) {
+		content = [{ type: "text", text: JSON.stringify(value) }];
+	} else if (
+		contentType.startsWith("text/event-stream") &&
+		isAsyncIterable(value)
+	) {
+		content = await consumeSSE(value);
+	} else if (contentType.startsWith("text/") && typeof value === "string") {
+		content = [{ type: "text", text: value }];
+	} else if (isBinaryData(value) && contentType.startsWith("image/")) {
+		const data = await valueToBase64(value);
+		content =
+			data == null ? [] : [{ type: "image", data, mimeType: contentType }];
+	} else {
+		return {
+			content: [
+				{
+					type: "text",
+					text: `Unsupported content type: "${contentType}"`,
+				},
+			],
+			isError: true,
+		};
+	}
+
+	return { content };
+}
+
+async function consumeSSE(
+	value: AsyncIterable<unknown>,
+): Promise<CallToolResult["content"]> {
+	const content: CallToolResult["content"] = [];
+
+	for await (const chunk of value) {
+		if (typeof chunk === "string") {
+			content.push({ type: "text", text: chunk });
+		} else {
+			content.push({ type: "text", text: JSON.stringify(chunk) });
+		}
+	}
+
+	return content;
+}
+
+export function createRegisterTool(
+	logger: ConsoleLogger,
+	server: McpServer,
+	getSDK: () => SteuerboardCore,
+	allowedScopes: Set<MCPScope>,
+	allowedTools?: Set<string>,
+): <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>) => void {
+	return <A extends ZodRawShape | undefined>(tool: ToolDefinition<A>): void => {
+		if (allowedTools && !allowedTools.has(tool.name)) {
+			return;
+		}
+
+		const scopes = tool.scopes ?? [];
+		if (allowedScopes.size > 0 && scopes.length === 0) {
+			return;
+		}
+
+		if (
+			allowedScopes.size > 0 &&
+			!scopes.every((s: MCPScope) => allowedScopes.has(s))
+		) {
+			return;
+		}
+
+		if (tool.args) {
+			server.tool(tool.name, tool.description, tool.args, async (args, ctx) => {
+				return tool.tool(getSDK(), args, ctx);
+			});
+		} else {
+			server.tool(tool.name, tool.description, async (ctx) => {
+				return tool.tool(getSDK(), ctx);
+			});
+		}
+
+		logger.debug("Registered tool", { name: tool.name });
+	};
+}

package/src/models/client.ts

@@ -0,0 +1,43 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * The type of the client
+ */
+export const Type$zodSchema = z.enum([
+  "natural_person",
+  "individual_enterprise",
+  "legal_person",
+]).describe("The type of the client");
+
+export type Type = z.infer<typeof Type$zodSchema>;
+
+export type Client = {
+  id: string;
+  name: string;
+  slug: string;
+  type: Type;
+  customId: string | null;
+  legalName: string | null;
+  archivedAt: string | null;
+  datevClientId: string | null;
+  createdAt: string;
+  updatedAt: string;
+};
+
+export const Client$zodSchema: z.ZodType<Client, z.ZodTypeDef, unknown> = z
+  .object({
+    archivedAt: z.string().nullable(),
+    createdAt: z.string(),
+    customId: z.string().nullable(),
+    datevClientId: z.string().nullable(),
+    id: z.string(),
+    legalName: z.string().nullable(),
+    name: z.string(),
+    slug: z.string(),
+    type: Type$zodSchema,
+    updatedAt: z.string(),
+  });