@steuerboard/mcp 0.0.1 → 0.1.0

package/src/funcs/workspacesListWorkspaces.ts

@@ -12,18 +12,18 @@ import { extractSecurity, resolveGlobalSecurity } from "../lib/security.js";
 import { pathToFunc } from "../lib/url.js";
 import { APIError } from "../models/errors/apierror.js";
 import {
-	ConnectionError,
-	InvalidRequestError,
-	RequestAbortedError,
-	RequestTimeoutError,
-	UnexpectedClientError,
+  ConnectionError,
+  InvalidRequestError,
+  RequestAbortedError,
+  RequestTimeoutError,
+  UnexpectedClientError,
 } from "../models/errors/httpclienterrors.js";
 import { SDKValidationError } from "../models/errors/sdkvalidationerror.js";
 import {
-	ListWorkspacesRequest,
-	ListWorkspacesRequest$zodSchema,
-	ListWorkspacesResponse,
-	ListWorkspacesResponse$zodSchema,
+  ListWorkspacesRequest,
+  ListWorkspacesRequest$zodSchema,
+  ListWorkspacesResponse,
+  ListWorkspacesResponse$zodSchema,
 } from "../models/listworkspacesop.js";
 import { APICall, APIPromise } from "../types/async.js";
 import { Result } from "../types/fp.js";
@@ -35,137 +35,147 @@ import { Result } from "../types/fp.js";
  * Returns a paginated list of workspaces.
  */
 export function workspacesListWorkspaces(
-	client$: SteuerboardCore,
-	request: ListWorkspacesRequest,
-	options?: RequestOptions,
+  client$: SteuerboardCore,
+  request: ListWorkspacesRequest,
+  options?: RequestOptions,
 ): APIPromise<
-	Result<
-		ListWorkspacesResponse,
-		| APIError
-		| SDKValidationError
-		| UnexpectedClientError
-		| InvalidRequestError
-		| RequestAbortedError
-		| RequestTimeoutError
-		| ConnectionError
-	>
+  Result<
+    ListWorkspacesResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >
 > {
-	return new APIPromise($do(client$, request, options));
+  return new APIPromise($do(
+    client$,
+    request,
+    options,
+  ));
 }
 
 async function $do(
-	client$: SteuerboardCore,
-	request: ListWorkspacesRequest,
-	options?: RequestOptions,
+  client$: SteuerboardCore,
+  request: ListWorkspacesRequest,
+  options?: RequestOptions,
 ): Promise<
-	[
-		Result<
-			ListWorkspacesResponse,
-			| APIError
-			| SDKValidationError
-			| UnexpectedClientError
-			| InvalidRequestError
-			| RequestAbortedError
-			| RequestTimeoutError
-			| ConnectionError
-		>,
-		APICall,
-	]
+  [
+    Result<
+      ListWorkspacesResponse,
+      | APIError
+      | SDKValidationError
+      | UnexpectedClientError
+      | InvalidRequestError
+      | RequestAbortedError
+      | RequestTimeoutError
+      | ConnectionError
+    >,
+    APICall,
+  ]
 > {
-	const parsed$ = safeParse(
-		request,
-		(value$) => ListWorkspacesRequest$zodSchema.parse(value$),
-		"Input validation failed",
-	);
-	if (!parsed$.ok) {
-		return [parsed$, { status: "invalid" }];
-	}
-	const payload$ = parsed$.value;
-	const body$ = null;
-	const path$ = pathToFunc("/v1/workspaces")();
-	const query$ = encodeFormQuery({
-		cursor: payload$.cursor,
-		limit: payload$.limit,
-	});
+  const parsed$ = safeParse(
+    request,
+    (value$) => ListWorkspacesRequest$zodSchema.parse(value$),
+    "Input validation failed",
+  );
+  if (!parsed$.ok) {
+    return [parsed$, { status: "invalid" }];
+  }
+  const payload$ = parsed$.value;
+  const body$ = null;
+  const path$ = pathToFunc("/v1/workspaces")();
+  const query$ = encodeFormQuery({
+    "cursor": payload$.cursor,
+    "limit": payload$.limit,
+  });
 
-	const headers$ = new Headers(
-		compactMap({
-			Accept: "application/json",
-			"x-client-id": encodeSimple("x-client-id", payload$.xClientId, {
-				explode: false,
-				charEncoding: "none",
-			}),
-		}),
-	);
-	const securityInput = await extractSecurity(client$._options.security);
-	const requestSecurity = resolveGlobalSecurity(securityInput);
+  const headers$ = new Headers(compactMap({
+    Accept: "application/json",
+    "x-client-id": encodeSimple("x-client-id", payload$.xClientId, {
+      explode: false,
+      charEncoding: "none",
+    }),
+  }));
+  const securityInput = await extractSecurity(client$._options.security);
+  const requestSecurity = resolveGlobalSecurity(securityInput);
 
-	const context = {
-		options: client$._options,
-		baseURL: options?.serverURL ?? client$._baseURL ?? "",
-		operationID: "listWorkspaces",
-		oAuth2Scopes: [],
-		resolvedSecurity: requestSecurity,
-		securitySource: client$._options.security,
-		retryConfig: options?.retries ||
-			client$._options.retryConfig || { strategy: "none" },
-		retryCodes: options?.retryCodes || ["429", "500", "502", "503", "504"],
-	};
+  const context = {
+    options: client$._options,
+    baseURL: options?.serverURL ?? client$._baseURL ?? "",
+    operationID: "listWorkspaces",
+    oAuth2Scopes: [],
+    resolvedSecurity: requestSecurity,
+    securitySource: client$._options.security,
+    retryConfig: options?.retries
+      || client$._options.retryConfig
+      || { strategy: "none" },
+    retryCodes: options?.retryCodes || [
+      "429",
+      "500",
+      "502",
+      "503",
+      "504",
+    ],
+  };
 
-	const requestRes = client$._createRequest(
-		context,
-		{
-			security: requestSecurity,
-			method: "GET",
-			baseURL: options?.serverURL,
-			path: path$,
-			headers: headers$,
-			query: query$,
-			body: body$,
-			userAgent: client$._options.userAgent,
-			timeoutMs: options?.timeoutMs || client$._options.timeoutMs || -1,
-		},
-		options,
-	);
-	if (!requestRes.ok) {
-		return [requestRes, { status: "invalid" }];
-	}
-	const req$ = requestRes.value;
+  const requestRes = client$._createRequest(context, {
+    security: requestSecurity,
+    method: "GET",
+    baseURL: options?.serverURL,
+    path: path$,
+    headers: headers$,
+    query: query$,
+    body: body$,
+    userAgent: client$._options.userAgent,
+    timeoutMs: options?.timeoutMs || client$._options.timeoutMs
+      || -1,
+  }, options);
+  if (!requestRes.ok) {
+    return [requestRes, { status: "invalid" }];
+  }
+  const req$ = requestRes.value;
 
-	const doResult = await client$._do(req$, {
-		context,
-		errorCodes: [],
-		retryConfig: context.retryConfig,
-		retryCodes: context.retryCodes,
-	});
-	if (!doResult.ok) {
-		return [doResult, { status: "request-error", request: req$ }];
-	}
-	const response = doResult.value;
-	const responseFields$ = {
-		HttpMeta: { Response: response, Request: req$ },
-	};
+  const doResult = await client$._do(req$, {
+    context,
+    errorCodes: [],
+    retryConfig: context.retryConfig,
+    retryCodes: context.retryCodes,
+  });
+  if (!doResult.ok) {
+    return [doResult, { status: "request-error", request: req$ }];
+  }
+  const response = doResult.value;
+  const responseFields$ = {
+    HttpMeta: { Response: response, Request: req$ },
+  };
 
-	const [result$] = await M.match<
-		ListWorkspacesResponse,
-		| APIError
-		| SDKValidationError
-		| UnexpectedClientError
-		| InvalidRequestError
-		| RequestAbortedError
-		| RequestTimeoutError
-		| ConnectionError
-	>(
-		M.json(200, ListWorkspacesResponse$zodSchema, {
-			key: "twoHundredApplicationJsonObject",
-		}),
-		M.json(422, ListWorkspacesResponse$zodSchema, {
-			key: "fourHundredAndTwentyTwoApplicationJsonObject",
-		}),
-		M.json(429, ListWorkspacesResponse$zodSchema, {
-			key: "fourHundredAndTwentyNineApplicationJsonObject",
-		}),
-	)(response, req$, { extraFields: responseFields$ });
+  const [result$] = await M.match<
+    ListWorkspacesResponse,
+    | APIError
+    | SDKValidationError
+    | UnexpectedClientError
+    | InvalidRequestError
+    | RequestAbortedError
+    | RequestTimeoutError
+    | ConnectionError
+  >(
+    M.json(200, ListWorkspacesResponse$zodSchema, {
+      key: "PaginatedWorkspaces",
+    }),
+    M.json(400, ListWorkspacesResponse$zodSchema, { key: "bad_request" }),
+    M.json(401, ListWorkspacesResponse$zodSchema, { key: "auth_error" }),
+    M.json(403, ListWorkspacesResponse$zodSchema, {
+      key: "403_application/json_object",
+    }),
+    M.json(422, ListWorkspacesResponse$zodSchema, {
+      key: "422_application/json_object",
+    }),
+    M.json(429, ListWorkspacesResponse$zodSchema, { key: "rate_limit" }),
+    M.nil(500, ListWorkspacesResponse$zodSchema),
+  )(response, req$, { extraFields: responseFields$ });
 
-	return [result$, { status: "complete", request: req$, response }];
+  return [result$, { status: "complete", request: req$, response }];
 }

package/src/lib/config.ts

@@ -11,58 +11,57 @@ import { Params, pathToFunc } from "./url.js";
 /**
  * Contains the list of servers available to the SDK
  */
-export const ServerList = [
-  "https://api.steuerboard.com",
-] as const;
+export const ServerList = ["https://api.steuerboard.com"] as const;
 
 export type SDKOptions = {
-  /**
-   * The security details required to authenticate the SDK
-   */
-  security?: Security | (() => Promise<Security>) | undefined;
+	/**
+	 * The security details required to authenticate the SDK
+	 */
+	security?: Security | (() => Promise<Security>) | undefined;
 
-  httpClient?: HTTPClient;
-  /**
-   * Allows overriding the default server used by the SDK
-   */
-  serverIdx?: number | undefined;
-  /**
-   * Allows overriding the default server URL used by the SDK
-   */
-  serverURL?: string | undefined;
-  /**
-   * Allows overriding the default user agent used by the SDK
-   */
-  userAgent?: string | undefined;
-  /**
-   * Allows overriding the default retry config used by the SDK
-   */
-  retryConfig?: RetryConfig;
-  timeoutMs?: number;
-  debugLogger?: Logger | undefined;
+	httpClient?: HTTPClient;
+	/**
+	 * Allows overriding the default server used by the SDK
+	 */
+	serverIdx?: number | undefined;
+	/**
+	 * Allows overriding the default server URL used by the SDK
+	 */
+	serverURL?: string | undefined;
+	/**
+	 * Allows overriding the default user agent used by the SDK
+	 */
+	userAgent?: string | undefined;
+	/**
+	 * Allows overriding the default retry config used by the SDK
+	 */
+	retryConfig?: RetryConfig;
+	timeoutMs?: number;
+	debugLogger?: Logger | undefined;
 };
 
 export function serverURLFromOptions(options: SDKOptions): URL | null {
-  let serverURL = options.serverURL;
+	let serverURL = options.serverURL;
 
-  const params: Params = {};
+	const params: Params = {};
 
-  if (!serverURL) {
-    const serverIdx = options.serverIdx ?? 0;
-    if (serverIdx < 0 || serverIdx >= ServerList.length) {
-      throw new Error(`Invalid server index ${serverIdx}`);
-    }
-    serverURL = ServerList[serverIdx] || "";
-  }
+	if (!serverURL) {
+		const serverIdx = options.serverIdx ?? 0;
+		if (serverIdx < 0 || serverIdx >= ServerList.length) {
+			throw new Error(`Invalid server index ${serverIdx}`);
+		}
+		serverURL = ServerList[serverIdx] || "";
+	}
 
-  const u = pathToFunc(serverURL)(params);
-  return new URL(u);
+	const u = pathToFunc(serverURL)(params);
+	return new URL(u);
 }
 
 export const SDK_METADATA = {
-  language: "typescript",
-  openapiDocVersion: "0.1.0",
-  sdkVersion: "0.0.1",
-  genVersion: "2.698.4",
-  userAgent: "speakeasy-sdk/mcp-typescript 0.0.1 2.698.4 0.1.0 steuerboard",
+	language: "typescript",
+	openapiDocVersion: "0.1.0",
+	sdkVersion: "0.1.0",
+	genVersion: "2.709.0",
+	userAgent:
+		"speakeasy-sdk/mcp-typescript 0.1.0 2.709.0 0.1.0 @steuerboard/mcp",
 } as const;

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

@@ -8,19 +8,19 @@ import { buildContext } from "./cli.js";
 import { startCommand } from "./cli/start/command.js";
 
 const routes = buildRouteMap({
-  routes: {
-    start: startCommand,
-  },
-  docs: {
-    brief: "MCP server CLI",
-  },
+	routes: {
+		start: startCommand,
+	},
+	docs: {
+		brief: "MCP server CLI",
+	},
 });
 
 export const app = buildApplication(routes, {
-  name: "mcp",
-  versionInfo: {
-    currentVersion: "0.0.1",
-  },
+	name: "mcp",
+	versionInfo: {
+		currentVersion: "0.1.0",
+	},
 });
 
 run(app, process.argv.slice(2), buildContext(process));

package/src/mcp-server/server.ts

@@ -8,100 +8,107 @@ 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$authGetV1Me } from "./tools/authGetV1Me.js";
+import { tool$authMe } from "./tools/authMe.js";
 import { tool$filesCreateFile } from "./tools/filesCreateFile.js";
 import { tool$filesDeleteFile } from "./tools/filesDeleteFile.js";
 import { tool$filesGetFile } from "./tools/filesGetFile.js";
 import { tool$filesListFiles } from "./tools/filesListFiles.js";
 import { tool$filesUpdateFile } from "./tools/filesUpdateFile.js";
-import { tool$healthCheckGetV1 } from "./tools/healthCheckGetV1.js";
-import { tool$healthCheckGetV1Ping } from "./tools/healthCheckGetV1Ping.js";
+import { tool$healthIndex } from "./tools/healthIndex.js";
+import { tool$healthPing } from "./tools/healthPing.js";
 import { tool$tasksCreateTask } from "./tools/tasksCreateTask.js";
 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$workspacesCreateWorkspace } from "./tools/workspacesCreateWorkspace.js";
 import { tool$workspacesGetWorkspace } from "./tools/workspacesGetWorkspace.js";
 import { tool$workspacesListWorkspaces } from "./tools/workspacesListWorkspaces.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.0.1",
-  });
+	const server = new McpServer({
+		name: "Steuerboard",
+		version: "0.1.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$healthCheckGetV1);
-  tool(tool$healthCheckGetV1Ping);
-  tool(tool$authGetV1Me);
-  tool(tool$adminClientsListClients);
-  tool(tool$adminClientsGetClient);
-  tool(tool$workspacesListWorkspaces);
-  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$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);
 
-  return server;
+	return server;
 }

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { adminClientsCreateClient } from "../../funcs/adminClientsCreateClient.js";
+import { ClientCreate$zodSchema } from "../../models/clientcreate.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: ClientCreate$zodSchema,
+};
+
+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.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await adminClientsCreateClient(
+      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);
+  },
+};