@steuerboard/mcp 0.0.1 → 0.0.7

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

@@ -7,33 +7,31 @@ import { ListClientsRequest$zodSchema } from "../../models/listclientsop.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-	request: ListClientsRequest$zodSchema.optional(),
+  request: ListClientsRequest$zodSchema.optional(),
 };
 
 export const tool$adminClientsListClients: ToolDefinition<typeof args> = {
-	name: "admin-clients-list-clients",
-	description: `List clients
+  name: "admin-clients-list-clients",
+  description: `List clients
 
 Returns a list of clients.`,
-	args,
-	tool: async (client, args, ctx) => {
-		const [result, apiCall] = await adminClientsListClients(
-			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;
-
-		const formattedResult = await formatResult(value, apiCall);
-
-		return formattedResult;
-	},
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await adminClientsListClients(
+      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/healthCheckGetV1Ping.ts

@@ -7,7 +7,7 @@ import { formatResult, ToolDefinition } from "../tools.js";
 
 export const tool$healthCheckGetV1Ping: ToolDefinition = {
   name: "health-check-get-v1-ping",
-  description: `Ping`,
+  description: `Ping Pong`,
   tool: async (client, ctx) => {
     const [result, apiCall] = await healthCheckGetV1Ping(
       client,

package/src/mcp-server/tools.ts

@@ -5,9 +5,9 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
 import {
-	CallToolResult,
-	ServerNotification,
-	ServerRequest,
+  CallToolResult,
+  ServerNotification,
+  ServerRequest,
 } from "@modelcontextprotocol/sdk/types.js";
 import { objectOutputType, ZodRawShape, ZodTypeAny } from "zod";
 import { SteuerboardCore } from "../core.js";
@@ -16,120 +16,118 @@ 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>;
-			};
+  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 },
+  value: unknown,
+  init: { response?: Response | undefined },
 ): Promise<CallToolResult> {
-	if (typeof value === "undefined") {
-		return { content: [] };
-	}
+  if (typeof value === "undefined") {
+    return { content: [] };
+  }
 
-	const { response } = init;
-	const contentType = response?.headers.get("content-type") ?? "";
-	let content: CallToolResult["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,
-		};
-	}
+  if (contentType.search(/\bjson\b/g)) {
+    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 };
+  return { content };
 }
 
 async function consumeSSE(
-	value: AsyncIterable<unknown>,
+  value: AsyncIterable<unknown>,
 ): Promise<CallToolResult["content"]> {
-	const content: 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) });
-		}
-	}
+  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;
+  return content;
 }
 
 export function createRegisterTool(
-	logger: ConsoleLogger,
-	server: McpServer,
-	getSDK: () => SteuerboardCore,
-	allowedScopes: Set<MCPScope>,
-	allowedTools?: Set<string>,
+  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;
-		}
+  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;
-		}
+    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 (
+      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);
-			});
-		}
+    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 });
-	};
+    logger.debug("Registered tool", { name: tool.name });
+  };
 }

package/src/models/client.ts

@@ -5,21 +5,23 @@
 import * as z from "zod";
 
 /**
- * The type of the client
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
  */
-export const Type$zodSchema = z.enum([
+export const ClientType$zodSchema = z.enum([
   "natural_person",
   "individual_enterprise",
   "legal_person",
-]).describe("The type of the client");
+]).describe(
+  "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+);
 
-export type Type = z.infer<typeof Type$zodSchema>;
+export type ClientType = z.infer<typeof ClientType$zodSchema>;
 
 export type Client = {
   id: string;
   name: string;
   slug: string;
-  type: Type;
+  type: ClientType;
   customId: string | null;
   legalName: string | null;
   archivedAt: string | null;
@@ -38,6 +40,6 @@ export const Client$zodSchema: z.ZodType<Client, z.ZodTypeDef, unknown> = z
     legalName: z.string().nullable(),
     name: z.string(),
     slug: z.string(),
-    type: Type$zodSchema,
+    type: ClientType$zodSchema,
     updatedAt: z.string(),
   });

package/src/models/clientcreate.ts

@@ -0,0 +1,56 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+
+/**
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
+ */
+export const ClientCreateType$zodSchema = z.enum([
+  "natural_person",
+  "individual_enterprise",
+  "legal_person",
+]).describe(
+  "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+);
+
+export type ClientCreateType = z.infer<typeof ClientCreateType$zodSchema>;
+
+/**
+ * The address of the client
+ */
+export type Address = {
+  line1: string;
+  line2?: string | undefined;
+  city: string;
+  postalCode: string;
+  countryCode?: string | undefined;
+};
+
+export const Address$zodSchema: z.ZodType<Address, z.ZodTypeDef, unknown> = z
+  .object({
+    city: z.string(),
+    countryCode: z.string().default("DE"),
+    line1: z.string(),
+    line2: z.string().optional(),
+    postalCode: z.string(),
+  }).describe("The address of the client");
+
+export type ClientCreate = {
+  name: string;
+  type: ClientCreateType;
+  customId?: string | undefined;
+  address?: Address | undefined;
+};
+
+export const ClientCreate$zodSchema: z.ZodType<
+  ClientCreate,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  address: z.lazy(() => Address$zodSchema).optional(),
+  customId: z.string().optional(),
+  name: z.string(),
+  type: ClientCreateType$zodSchema,
+});

package/src/models/createclientop.ts

@@ -0,0 +1,112 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { Client, Client$zodSchema } from "./client.js";
+
+/**
+ * Rate limit exceeded. Slow down requests or retry after the time specified in the rate limit response headers
+ */
+export type CreateClientTooManyRequestsResponseBody = { message: string };
+
+export const CreateClientTooManyRequestsResponseBody$zodSchema: z.ZodType<
+  CreateClientTooManyRequestsResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  message: z.string(),
+}).describe(
+  "Rate limit exceeded. Slow down requests or retry after the time specified in the rate limit response headers",
+);
+
+export type CreateClientPath = string | number;
+
+export const CreateClientPath$zodSchema: z.ZodType<
+  CreateClientPath,
+  z.ZodTypeDef,
+  unknown
+> = z.union([
+  z.string(),
+  z.number(),
+]);
+
+export type CreateClientIssue = {
+  code: string;
+  path: Array<string | number>;
+  message?: string | undefined;
+};
+
+export const CreateClientIssue$zodSchema: z.ZodType<
+  CreateClientIssue,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  code: z.string(),
+  message: z.string().optional(),
+  path: z.array(z.union([
+    z.string(),
+    z.number(),
+  ])),
+});
+
+export type CreateClientError = {
+  issues: Array<CreateClientIssue>;
+  name: string;
+};
+
+export const CreateClientError$zodSchema: z.ZodType<
+  CreateClientError,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  issues: z.array(z.lazy(() => CreateClientIssue$zodSchema)),
+  name: z.string(),
+});
+
+/**
+ * The validation error(s)
+ */
+export type CreateClientUnprocessableEntityResponseBody = {
+  success: boolean;
+  error: CreateClientError;
+};
+
+export const CreateClientUnprocessableEntityResponseBody$zodSchema: z.ZodType<
+  CreateClientUnprocessableEntityResponseBody,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  error: z.lazy(() => CreateClientError$zodSchema),
+  success: z.boolean(),
+}).describe("The validation error(s)");
+
+export type CreateClientResponse = {
+  ContentType: string;
+  StatusCode: number;
+  RawResponse: Response;
+  Client?: Client | undefined;
+  fourHundredAndTwentyTwoApplicationJsonObject?:
+    | CreateClientUnprocessableEntityResponseBody
+    | undefined;
+  fourHundredAndTwentyNineApplicationJsonObject?:
+    | CreateClientTooManyRequestsResponseBody
+    | undefined;
+};
+
+export const CreateClientResponse$zodSchema: z.ZodType<
+  CreateClientResponse,
+  z.ZodTypeDef,
+  unknown
+> = z.object({
+  Client: Client$zodSchema.optional(),
+  ContentType: z.string(),
+  RawResponse: z.instanceof(Response),
+  StatusCode: z.number().int(),
+  fourHundredAndTwentyNineApplicationJsonObject: z.lazy(() =>
+    CreateClientTooManyRequestsResponseBody$zodSchema
+  ).optional(),
+  fourHundredAndTwentyTwoApplicationJsonObject: z.lazy(() =>
+    CreateClientUnprocessableEntityResponseBody$zodSchema
+  ).optional(),
+});

package/src/models/getv1meop.ts

@@ -10,10 +10,11 @@ import * as z from "zod";
 export type GetV1MeResponseBody = {
   type: string;
   accountantId: string;
-  clientId?: string | undefined;
+  clientId: string | null;
   apiKeyId: string;
   rateLimitMax: number;
   rateLimitTimeWindow: number;
+  permissions: Array<string>;
 };
 
 export const GetV1MeResponseBody$zodSchema: z.ZodType<
@@ -23,7 +24,8 @@ export const GetV1MeResponseBody$zodSchema: z.ZodType<
 > = z.object({
   accountantId: z.string(),
   apiKeyId: z.string(),
-  clientId: z.string().optional(),
+  clientId: z.string().nullable(),
+  permissions: z.array(z.string()),
   rateLimitMax: z.number(),
   rateLimitTimeWindow: z.number(),
   type: z.string(),

package/src/models/listclientsop.ts

@@ -17,13 +17,15 @@ export const Archived$zodSchema = z.enum([
 export type Archived = z.infer<typeof Archived$zodSchema>;
 
 /**
- * The type of the client
+ * The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.
  */
 export const ListClientsType$zodSchema = z.enum([
   "natural_person",
   "individual_enterprise",
   "legal_person",
-]).describe("The type of the client");
+]).describe(
+  "The type of the client. 'natural_person' for individuals, 'legal_person' for companies like UG, GmbH, AG, Ltd., Inc., etc. and 'individual_enterprise' for sole proprietorships.",
+);
 
 export type ListClientsType = z.infer<typeof ListClientsType$zodSchema>;
 

package/src/models/listtasksop.ts

@@ -9,7 +9,6 @@ import { Task, Task$zodSchema } from "./task.js";
 export type ListTasksRequest = {
   limit?: number | undefined;
   cursor?: string | undefined;
-  clientId?: string | undefined;
   workspaceId?: string | undefined;
 };
 
@@ -18,7 +17,6 @@ export const ListTasksRequest$zodSchema: z.ZodType<
   z.ZodTypeDef,
   unknown
 > = z.object({
-  clientId: z.string().optional(),
   cursor: z.string().optional(),
   limit: z.number().default(20),
   workspaceId: z.string().optional(),