@steuerboard/mcp 0.1.0 → 0.2.0

package/src/mcp-server/server.ts

@@ -8,14 +8,20 @@ import { SDKOptions } from "../lib/config.js";
 import type { ConsoleLogger } from "./console-logger.js";
 import { createRegisterPrompt } from "./prompts.js";
 import {
-	createRegisterResource,
-	createRegisterResourceTemplate,
+  createRegisterResource,
+  createRegisterResourceTemplate,
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
 import { createRegisterTool } from "./tools.js";
 import { tool$adminClientsCreateClient } from "./tools/adminClientsCreateClient.js";
 import { tool$adminClientsGetClient } from "./tools/adminClientsGetClient.js";
 import { tool$adminClientsListClients } from "./tools/adminClientsListClients.js";
+import { tool$adminClientsUpdateClient } from "./tools/adminClientsUpdateClient.js";
+import { tool$adminUsersDeleteAccountantUser } from "./tools/adminUsersDeleteAccountantUser.js";
+import { tool$adminUsersGetAccountantUser } from "./tools/adminUsersGetAccountantUser.js";
+import { tool$adminUsersInviteAccountantUser } from "./tools/adminUsersInviteAccountantUser.js";
+import { tool$adminUsersListAccountantUsers } from "./tools/adminUsersListAccountantUsers.js";
+import { tool$adminUsersUpdateAccountantUser } from "./tools/adminUsersUpdateAccountantUser.js";
 import { tool$authMe } from "./tools/authMe.js";
 import { tool$filesCreateFile } from "./tools/filesCreateFile.js";
 import { tool$filesDeleteFile } from "./tools/filesDeleteFile.js";
@@ -29,86 +35,107 @@ import { tool$tasksDeleteTask } from "./tools/tasksDeleteTask.js";
 import { tool$tasksGetTask } from "./tools/tasksGetTask.js";
 import { tool$tasksListTasks } from "./tools/tasksListTasks.js";
 import { tool$tasksUpdateTask } from "./tools/tasksUpdateTask.js";
+import { tool$usersDeleteUser } from "./tools/usersDeleteUser.js";
+import { tool$usersGetUser } from "./tools/usersGetUser.js";
+import { tool$usersInviteUser } from "./tools/usersInviteUser.js";
+import { tool$usersListUsers } from "./tools/usersListUsers.js";
+import { tool$usersUpdateUser } from "./tools/usersUpdateUser.js";
+import { tool$workspaceMembersCreateWorkspaceMember } from "./tools/workspaceMembersCreateWorkspaceMember.js";
+import { tool$workspaceMembersListWorkspaceMembers } from "./tools/workspaceMembersListWorkspaceMembers.js";
+import { tool$workspaceMembersRemoveWorkspaceMember } from "./tools/workspaceMembersRemoveWorkspaceMember.js";
 import { tool$workspacesCreateWorkspace } from "./tools/workspacesCreateWorkspace.js";
 import { tool$workspacesGetWorkspace } from "./tools/workspacesGetWorkspace.js";
 import { tool$workspacesListWorkspaces } from "./tools/workspacesListWorkspaces.js";
+import { tool$workspacesUpdateWorkspace } from "./tools/workspacesUpdateWorkspace.js";
 
 export function createMCPServer(deps: {
-	logger: ConsoleLogger;
-	allowedTools?: string[] | undefined;
-	scopes?: MCPScope[] | undefined;
-	getSDK?: () => SteuerboardCore;
-	serverURL?: string | undefined;
-	security?: SDKOptions["security"] | undefined;
-	serverIdx?: SDKOptions["serverIdx"] | undefined;
+  logger: ConsoleLogger;
+  allowedTools?: string[] | undefined;
+  scopes?: MCPScope[] | undefined;
+  getSDK?: () => SteuerboardCore;
+  serverURL?: string | undefined;
+  security?: SDKOptions["security"] | undefined;
+  serverIdx?: SDKOptions["serverIdx"] | undefined;
 }) {
-	const server = new McpServer({
-		name: "Steuerboard",
-		version: "0.1.0",
-	});
+  const server = new McpServer({
+    name: "Steuerboard",
+    version: "0.2.0",
+  });
 
-	const getClient =
-		deps.getSDK ||
-		(() =>
-			new SteuerboardCore({
-				security: deps.security,
-				serverURL: deps.serverURL,
-				serverIdx: deps.serverIdx,
-				debugLogger:
-					deps.logger.level === "debug"
-						? {
-								log: (...args) => console.log(...args),
-								group: (...args) => console.group(...args),
-								groupEnd: (...args) => console.groupEnd(...args),
-							}
-						: undefined,
-			}));
+  const getClient = deps.getSDK || (() =>
+    new SteuerboardCore({
+      security: deps.security,
+      serverURL: deps.serverURL,
+      serverIdx: deps.serverIdx,
+      debugLogger: deps.logger.level === "debug"
+        ? {
+          log: (...args) => console.log(...args),
+          group: (...args) => console.group(...args),
+          groupEnd: (...args) => console.groupEnd(...args),
+        }
+        : undefined,
+    }));
 
-	const scopes = new Set(deps.scopes);
+  const scopes = new Set(deps.scopes);
 
-	const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
-	const tool = createRegisterTool(
-		deps.logger,
-		server,
-		getClient,
-		scopes,
-		allowedTools,
-	);
-	const resource = createRegisterResource(
-		deps.logger,
-		server,
-		getClient,
-		scopes,
-	);
-	const resourceTemplate = createRegisterResourceTemplate(
-		deps.logger,
-		server,
-		getClient,
-		scopes,
-	);
-	const prompt = createRegisterPrompt(deps.logger, server, getClient, scopes);
-	const register = { tool, resource, resourceTemplate, prompt };
-	void register; // suppress unused warnings
+  const allowedTools = deps.allowedTools && new Set(deps.allowedTools);
+  const tool = createRegisterTool(
+    deps.logger,
+    server,
+    getClient,
+    scopes,
+    allowedTools,
+  );
+  const resource = createRegisterResource(
+    deps.logger,
+    server,
+    getClient,
+    scopes,
+  );
+  const resourceTemplate = createRegisterResourceTemplate(
+    deps.logger,
+    server,
+    getClient,
+    scopes,
+  );
+  const prompt = createRegisterPrompt(deps.logger, server, getClient, scopes);
+  const register = { tool, resource, resourceTemplate, prompt };
+  void register; // suppress unused warnings
 
-	tool(tool$healthIndex);
-	tool(tool$healthPing);
-	tool(tool$authMe);
-	tool(tool$adminClientsListClients);
-	tool(tool$adminClientsCreateClient);
-	tool(tool$adminClientsGetClient);
-	tool(tool$workspacesListWorkspaces);
-	tool(tool$workspacesCreateWorkspace);
-	tool(tool$workspacesGetWorkspace);
-	tool(tool$filesListFiles);
-	tool(tool$filesCreateFile);
-	tool(tool$filesGetFile);
-	tool(tool$filesUpdateFile);
-	tool(tool$filesDeleteFile);
-	tool(tool$tasksListTasks);
-	tool(tool$tasksCreateTask);
-	tool(tool$tasksGetTask);
-	tool(tool$tasksUpdateTask);
-	tool(tool$tasksDeleteTask);
+  tool(tool$healthIndex);
+  tool(tool$healthPing);
+  tool(tool$authMe);
+  tool(tool$adminClientsListClients);
+  tool(tool$adminClientsCreateClient);
+  tool(tool$adminClientsGetClient);
+  tool(tool$adminClientsUpdateClient);
+  tool(tool$adminUsersListAccountantUsers);
+  tool(tool$adminUsersInviteAccountantUser);
+  tool(tool$adminUsersGetAccountantUser);
+  tool(tool$adminUsersUpdateAccountantUser);
+  tool(tool$adminUsersDeleteAccountantUser);
+  tool(tool$workspacesListWorkspaces);
+  tool(tool$workspacesCreateWorkspace);
+  tool(tool$workspacesGetWorkspace);
+  tool(tool$workspacesUpdateWorkspace);
+  tool(tool$workspaceMembersListWorkspaceMembers);
+  tool(tool$workspaceMembersCreateWorkspaceMember);
+  tool(tool$workspaceMembersRemoveWorkspaceMember);
+  tool(tool$filesListFiles);
+  tool(tool$filesCreateFile);
+  tool(tool$filesGetFile);
+  tool(tool$filesUpdateFile);
+  tool(tool$filesDeleteFile);
+  tool(tool$tasksListTasks);
+  tool(tool$tasksCreateTask);
+  tool(tool$tasksGetTask);
+  tool(tool$tasksUpdateTask);
+  tool(tool$tasksDeleteTask);
+  tool(tool$usersListUsers);
+  tool(tool$usersInviteUser);
+  tool(tool$usersGetUser);
+  tool(tool$usersUpdateUser);
+  tool(tool$usersDeleteUser);
 
-	return server;
+  return server;
 }

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

@@ -14,7 +14,7 @@ export const tool$adminClientsCreateClient: ToolDefinition<typeof args> = {
   name: "admin-clients-create-client",
   description: `Create a client
 
-Creates a new client for the accountant and returns the created client object.`,
+Creates a new client for the accountant and returns the created client.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsCreateClient(

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

@@ -14,7 +14,7 @@ export const tool$adminClientsGetClient: ToolDefinition<typeof args> = {
   name: "admin-clients-get-client",
   description: `Get a client
 
-Returns a single client object by ID.`,
+Returns a single client by ID.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsGetClient(

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

@@ -14,7 +14,7 @@ export const tool$adminClientsListClients: ToolDefinition<typeof args> = {
   name: "admin-clients-list-clients",
   description: `List clients
 
-Returns a list of clients.`,
+Returns a paginated list of clients.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsListClients(

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

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { adminUsersDeleteAccountantUser } from "../../funcs/adminUsersDeleteAccountantUser.js";
+import { DeleteAccountantUserRequest$zodSchema } from "../../models/deleteaccountantuserop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: DeleteAccountantUserRequest$zodSchema,
+};
+
+export const tool$adminUsersDeleteAccountantUser: ToolDefinition<typeof args> =
+  {
+    name: "admin-users-delete-accountant-user",
+    description: `Delete an accountant user
+
+Deletes an accountant user by ID.`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await adminUsersDeleteAccountantUser(
+        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/adminUsersGetAccountantUser.ts

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { adminUsersInviteAccountantUser } from "../../funcs/adminUsersInviteAccountantUser.js";
+import { InviteAccountantUser$zodSchema } from "../../models/inviteaccountantuser.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: InviteAccountantUser$zodSchema,
+};
+
+export const tool$adminUsersInviteAccountantUser: ToolDefinition<typeof args> =
+  {
+    name: "admin-users-invite-accountant-user",
+    description: `Invite an accountant user
+
+Invites a new accountant user and returns the created record.`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await adminUsersInviteAccountantUser(
+        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/adminUsersListAccountantUsers.ts

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

@@ -0,0 +1,38 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { adminUsersUpdateAccountantUser } from "../../funcs/adminUsersUpdateAccountantUser.js";
+import { UpdateAccountantUserRequest$zodSchema } from "../../models/updateaccountantuserop.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: UpdateAccountantUserRequest$zodSchema,
+};
+
+export const tool$adminUsersUpdateAccountantUser: ToolDefinition<typeof args> =
+  {
+    name: "admin-users-update-accountant-user",
+    description: `Update an accountant user
+
+Updates an accountant user by ID.`,
+    args,
+    tool: async (client, args, ctx) => {
+      const [result, apiCall] = await adminUsersUpdateAccountantUser(
+        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/authMe.ts

@@ -7,7 +7,9 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 export const tool$authMe: ToolDefinition = {
   name: "auth-me",
-  description: `Me`,
+  description: `Me
+
+Returns information about the authenticated principal.`,
   tool: async (client, ctx) => {
     const [result, apiCall] = await authMe(
       client,

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

@@ -14,7 +14,7 @@ export const tool$filesGetFile: ToolDefinition<typeof args> = {
   name: "files-get-file",
   description: `Get a file
 
-Returns a single file object by ID.`,
+Returns a single file by ID.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesGetFile(

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

@@ -14,7 +14,7 @@ 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.`,
+Returns a paginated list of files with optional workspace filters.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesListFiles(

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

@@ -14,7 +14,7 @@ export const tool$filesUpdateFile: ToolDefinition<typeof args> = {
   name: "files-update-file",
   description: `Update a file
 
-Updates a file object.`,
+Updates a file by ID.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesUpdateFile(

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

@@ -7,7 +7,9 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 export const tool$healthIndex: ToolDefinition = {
   name: "health-index",
-  description: `Index`,
+  description: `Get API index
+
+Returns API information.`,
   tool: async (client, ctx) => {
     const [result, apiCall] = await healthIndex(
       client,

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

@@ -7,7 +7,9 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 export const tool$healthPing: ToolDefinition = {
   name: "health-ping",
-  description: `Ping Pong`,
+  description: `Ping Pong
+
+Returns a pong response for health checks.`,
   tool: async (client, ctx) => {
     const [result, apiCall] = await healthPing(
       client,

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

@@ -14,7 +14,7 @@ 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.`,
+Creates a new task and returns the created task.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksCreateTask(

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

@@ -14,7 +14,7 @@ export const tool$tasksGetTask: ToolDefinition<typeof args> = {
   name: "tasks-get-task",
   description: `Get a task
 
-Returns a single task object by ID.`,
+Returns a single task by ID.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksGetTask(

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

@@ -14,7 +14,7 @@ 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.`,
+Returns a paginated list of tasks with optional client and workspace filters.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksListTasks(

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

@@ -14,7 +14,7 @@ export const tool$tasksUpdateTask: ToolDefinition<typeof args> = {
   name: "tasks-update-task",
   description: `Update a task
 
-Updates an existing task object.`,
+Updates a task by ID.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksUpdateTask(

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

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

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