@steuerboard/mcp 0.2.0 → 0.3.0

package/esm/src/models/updateaccountantuser.js.map

@@ -1 +1 @@
-{"version":3,"file":"updateaccountantuser.js","sourceRoot":"","sources":["../../../src/models/updateaccountantuser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAIzB,MAAM,CAAC,MAAM,8BAA8B,GAIvC,CAAC,CAAC,MAAM,CAAC;IACX,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE;CACnB,CAAC,CAAC"}
+{"version":3,"file":"updateaccountantuser.js","sourceRoot":"","sources":["../../../src/models/updateaccountantuser.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;AAEzB,MAAM,CAAC,MAAM,sCAAsC,GAAG,CAAC,CAAC,IAAI,CAAC;IAC3D,OAAO;IACP,MAAM;CACP,CAAC,CAAC;AAaH,MAAM,CAAC,MAAM,uCAAuC,GAIhD,CAAC,CAAC,KAAK,CAAC;IACV,sCAAsC;IACtC,CAAC,CAAC,MAAM,EAAE;CACX,CAAC,CAAC,QAAQ,CACT,0EAA0E,CAC3E,CAAC;AAMF,MAAM,CAAC,MAAM,8BAA8B,GAIvC,CAAC,CAAC,MAAM,CAAC;IACX,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC;QACZ,sCAAsC;QACtC,CAAC,CAAC,MAAM,EAAE;KACX,CAAC;CACH,CAAC,CAAC"}

package/manifest.json

@@ -1,7 +1,7 @@
 {
   "dxt_version": "0.1",
   "name": "@steuerboard/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "description": "",
   "long_description": "",
   "author": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@steuerboard/mcp",
-  "version": "0.2.0",
+  "version": "0.3.0",
   "author": "Steuerboard",
   "type": "module",
   "sideEffects": false,

package/src/lib/config.ts

@@ -62,8 +62,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 export const SDK_METADATA = {
   language: "typescript",
   openapiDocVersion: "0.1.0",
-  sdkVersion: "0.2.0",
-  genVersion: "2.716.16",
+  sdkVersion: "0.3.0",
+  genVersion: "2.721.3",
   userAgent:
-    "speakeasy-sdk/mcp-typescript 0.2.0 2.716.16 0.1.0 @steuerboard/mcp",
+    "speakeasy-sdk/mcp-typescript 0.3.0 2.721.3 0.1.0 @steuerboard/mcp",
 } as const;

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

@@ -19,7 +19,7 @@ const routes = buildRouteMap({
 export const app = buildApplication(routes, {
   name: "mcp",
   versionInfo: {
-    currentVersion: "0.2.0",
+    currentVersion: "0.3.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -59,7 +59,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Steuerboard",
-    version: "0.2.0",
+    version: "0.3.0",
   });
 
   const getClient = deps.getSDK || (() =>

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

@@ -15,6 +15,12 @@ export const tool$adminClientsCreateClient: ToolDefinition<typeof args> = {
   description: `Create a client
 
 Creates a new client for the accountant and returns the created client.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsCreateClient(

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

@@ -15,6 +15,12 @@ export const tool$adminClientsGetClient: ToolDefinition<typeof args> = {
   description: `Get a client
 
 Returns a single client by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsGetClient(

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

@@ -15,6 +15,12 @@ export const tool$adminClientsListClients: ToolDefinition<typeof args> = {
   description: `List clients
 
 Returns a paginated list of clients.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsListClients(

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

@@ -15,6 +15,12 @@ export const tool$adminClientsUpdateClient: ToolDefinition<typeof args> = {
   description: `Update a client
 
 Updates a client by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminClientsUpdateClient(

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

@@ -16,6 +16,12 @@ export const tool$adminUsersDeleteAccountantUser: ToolDefinition<typeof args> =
     description: `Delete an accountant user
 
 Deletes an accountant user by ID.`,
+    annotations: {
+      "destructiveHint": true,
+      "idempotentHint": false,
+      "openWorldHint": false,
+      "readOnlyHint": false,
+    },
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await adminUsersDeleteAccountantUser(

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

@@ -15,6 +15,12 @@ export const tool$adminUsersGetAccountantUser: ToolDefinition<typeof args> = {
   description: `Get an accountant user
 
 Returns a single accountant user by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminUsersGetAccountantUser(

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

@@ -16,6 +16,12 @@ export const tool$adminUsersInviteAccountantUser: ToolDefinition<typeof args> =
     description: `Invite an accountant user
 
 Invites a new accountant user and returns the created record.`,
+    annotations: {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false,
+      "readOnlyHint": false,
+    },
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await adminUsersInviteAccountantUser(

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

@@ -15,6 +15,12 @@ export const tool$adminUsersListAccountantUsers: ToolDefinition<typeof args> = {
   description: `List accountant users
 
 Returns a paginated list of accountant users.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await adminUsersListAccountantUsers(

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

@@ -16,6 +16,12 @@ export const tool$adminUsersUpdateAccountantUser: ToolDefinition<typeof args> =
     description: `Update an accountant user
 
 Updates an accountant user by ID.`,
+    annotations: {
+      "destructiveHint": false,
+      "idempotentHint": false,
+      "openWorldHint": false,
+      "readOnlyHint": false,
+    },
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await adminUsersUpdateAccountantUser(

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

@@ -10,6 +10,12 @@ export const tool$authMe: ToolDefinition = {
   description: `Me
 
 Returns information about the authenticated principal.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   tool: async (client, ctx) => {
     const [result, apiCall] = await authMe(
       client,

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

@@ -15,6 +15,12 @@ export const tool$filesCreateFile: ToolDefinition<typeof args> = {
   description: `Upload a file
 
 Uploads a new file. Maximum file size is 500MB.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesCreateFile(

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

@@ -15,6 +15,12 @@ export const tool$filesDeleteFile: ToolDefinition<typeof args> = {
   description: `Delete a file
 
 Deletes a file by ID.`,
+  annotations: {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesDeleteFile(

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

@@ -15,6 +15,12 @@ export const tool$filesGetFile: ToolDefinition<typeof args> = {
   description: `Get a file
 
 Returns a single file by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesGetFile(

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

@@ -15,6 +15,12 @@ export const tool$filesListFiles: ToolDefinition<typeof args> = {
   description: `List files
 
 Returns a paginated list of files with optional workspace filters.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesListFiles(

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

@@ -15,6 +15,12 @@ export const tool$filesUpdateFile: ToolDefinition<typeof args> = {
   description: `Update a file
 
 Updates a file by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await filesUpdateFile(

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

@@ -10,6 +10,12 @@ export const tool$healthIndex: ToolDefinition = {
   description: `Get API index
 
 Returns API information.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   tool: async (client, ctx) => {
     const [result, apiCall] = await healthIndex(
       client,

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

@@ -10,6 +10,12 @@ export const tool$healthPing: ToolDefinition = {
   description: `Ping Pong
 
 Returns a pong response for health checks.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   tool: async (client, ctx) => {
     const [result, apiCall] = await healthPing(
       client,

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

@@ -15,6 +15,12 @@ export const tool$tasksCreateTask: ToolDefinition<typeof args> = {
   description: `Create a task
 
 Creates a new task and returns the created task.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksCreateTask(

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

@@ -15,6 +15,12 @@ export const tool$tasksDeleteTask: ToolDefinition<typeof args> = {
   description: `Delete a task
 
 Deletes a task by ID.`,
+  annotations: {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksDeleteTask(

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

@@ -15,6 +15,12 @@ export const tool$tasksGetTask: ToolDefinition<typeof args> = {
   description: `Get a task
 
 Returns a single task by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksGetTask(

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

@@ -15,6 +15,12 @@ export const tool$tasksListTasks: ToolDefinition<typeof args> = {
   description: `List tasks
 
 Returns a paginated list of tasks with optional client and workspace filters.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksListTasks(

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

@@ -15,6 +15,12 @@ export const tool$tasksUpdateTask: ToolDefinition<typeof args> = {
   description: `Update a task
 
 Updates a task by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await tasksUpdateTask(

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

@@ -15,6 +15,12 @@ export const tool$usersDeleteUser: ToolDefinition<typeof args> = {
   description: `Delete a user
 
 Deletes a client user from the client by ID.`,
+  annotations: {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await usersDeleteUser(

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

@@ -15,6 +15,12 @@ export const tool$usersGetUser: ToolDefinition<typeof args> = {
   description: `Get a user
 
 Returns a single client user by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await usersGetUser(

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

@@ -15,6 +15,12 @@ export const tool$usersInviteUser: ToolDefinition<typeof args> = {
   description: `Invite a user
 
 Invites a new client user and returns the created record.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await usersInviteUser(

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

@@ -15,6 +15,12 @@ export const tool$usersListUsers: ToolDefinition<typeof args> = {
   description: `List users
 
 Returns a paginated list of client users.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await usersListUsers(

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

@@ -15,6 +15,12 @@ export const tool$usersUpdateUser: ToolDefinition<typeof args> = {
   description: `Update a user
 
 Updates a client user by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await usersUpdateUser(

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

@@ -17,6 +17,12 @@ export const tool$workspaceMembersCreateWorkspaceMember: ToolDefinition<
   description: `Create a workspace member
 
 Creates a new workspace member.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspaceMembersCreateWorkspaceMember(

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

@@ -17,6 +17,12 @@ export const tool$workspaceMembersListWorkspaceMembers: ToolDefinition<
   description: `List workspace members
 
 Returns workspace members for a workspace.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspaceMembersListWorkspaceMembers(

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

@@ -17,6 +17,12 @@ export const tool$workspaceMembersRemoveWorkspaceMember: ToolDefinition<
   description: `Remove a workspace member
 
 Removes a workspace member from a workspace.`,
+  annotations: {
+    "destructiveHint": true,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspaceMembersRemoveWorkspaceMember(

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

@@ -15,6 +15,12 @@ export const tool$workspacesCreateWorkspace: ToolDefinition<typeof args> = {
   description: `Create a workspace
 
 Creates a new workspace and returns the created workspace.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesCreateWorkspace(

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

@@ -15,6 +15,12 @@ export const tool$workspacesGetWorkspace: ToolDefinition<typeof args> = {
   description: `Get a workspace
 
 Returns a single workspace by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesGetWorkspace(

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

@@ -15,6 +15,12 @@ export const tool$workspacesListWorkspaces: ToolDefinition<typeof args> = {
   description: `List workspaces
 
 Returns a paginated list of workspaces.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": true,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesListWorkspaces(

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

@@ -15,6 +15,12 @@ export const tool$workspacesUpdateWorkspace: ToolDefinition<typeof args> = {
   description: `Update a workspace
 
 Updates a workspace by ID.`,
+  annotations: {
+    "destructiveHint": false,
+    "idempotentHint": false,
+    "openWorldHint": false,
+    "readOnlyHint": false,
+  },
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await workspacesUpdateWorkspace(

package/src/mcp-server/tools.ts

@@ -21,6 +21,12 @@ export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
       description: string;
       scopes?: MCPScope[];
       args: Args;
+      annotations: {
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        readOnlyHint: boolean;
+      };
       tool: (
         client: SteuerboardCore,
         args: objectOutputType<Args, ZodTypeAny>,
@@ -32,6 +38,12 @@ export type ToolDefinition<Args extends undefined | ZodRawShape = undefined> =
       description: string;
       scopes?: MCPScope[];
       args?: undefined;
+      annotations: {
+        destructiveHint: boolean;
+        idempotentHint: boolean;
+        openWorldHint: boolean;
+        readOnlyHint: boolean;
+      };
       tool: (
         client: SteuerboardCore,
         extra: RequestHandlerExtra<ServerRequest, ServerNotification>,
@@ -119,13 +131,24 @@ export function createRegisterTool(
     }
 
     if (tool.args) {
-      server.tool(tool.name, tool.description, tool.args, async (args, ctx) => {
-        return tool.tool(getSDK(), args, ctx);
-      });
+      server.tool(
+        tool.name,
+        tool.description,
+        tool.args,
+        tool.annotations,
+        async (args, ctx) => {
+          return tool.tool(getSDK(), args, ctx);
+        },
+      );
     } else {
-      server.tool(tool.name, tool.description, async (ctx) => {
-        return tool.tool(getSDK(), ctx);
-      });
+      server.tool(
+        tool.name,
+        tool.description,
+        tool.annotations,
+        async (_, ctx) => {
+          return tool.tool(getSDK(), ctx);
+        },
+      );
     }
 
     logger.debug("Registered tool", { name: tool.name });

package/src/models/inviteaccountantuser.ts

@@ -4,7 +4,37 @@
 
 import * as z from "zod";
 
-export type InviteAccountantUser = { email: string; roleId: string };
+export const InviteAccountantUserRoleEnum$zodSchema = z.enum([
+  "admin",
+  "user",
+]);
+
+export type InviteAccountantUserRoleEnum = z.infer<
+  typeof InviteAccountantUserRoleEnum$zodSchema
+>;
+
+/**
+ * Role to assign to the invited user. Can be 'admin', 'user', or a custom role ID.
+ */
+export type InviteAccountantUserRoleUnion =
+  | InviteAccountantUserRoleEnum
+  | string;
+
+export const InviteAccountantUserRoleUnion$zodSchema: z.ZodType<
+  InviteAccountantUserRoleUnion,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  InviteAccountantUserRoleEnum$zodSchema,
+  z.string(),
+]).describe(
+  "Role to assign to the invited user. Can be 'admin', 'user', or a custom role ID.",
+);
+
+export type InviteAccountantUser = {
+  email: string;
+  role: InviteAccountantUserRoleEnum | string;
+};
 
 export const InviteAccountantUser$zodSchema: z.ZodType<
   InviteAccountantUser,
@@ -12,5 +42,8 @@ export const InviteAccountantUser$zodSchema: z.ZodType<
   unknown
 > = z.object({
   email: z.string(),
-  roleId: z.string(),
+  role: z.union([
+    InviteAccountantUserRoleEnum$zodSchema,
+    z.string(),
+  ]),
 });