@polar-sh/sdk 0.26.1 → 0.27.0

package/src/mcp-server/resources.ts

@@ -0,0 +1,96 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { RequestHandlerExtra } from "@modelcontextprotocol/sdk/shared/protocol.js";
+import { Variables } from "@modelcontextprotocol/sdk/shared/uriTemplate.js";
+import { ReadResourceResult } from "@modelcontextprotocol/sdk/types.js";
+import { PolarCore } from "../core.js";
+import { Result } from "../types/fp.js";
+import { MCPScope } from "./scopes.js";
+import { isAsyncIterable, isBinaryData, valueToBase64 } from "./shared.js";
+
+export type ReadResourceCallback = (
+  client: PolarCore,
+  uri: URL,
+  extra: RequestHandlerExtra,
+) => ReadResourceResult | Promise<ReadResourceResult>;
+
+export type ResourceDefinition = {
+  name: string;
+  description: string;
+  scopes?: MCPScope[];
+  resource: string;
+  read: ReadResourceCallback;
+};
+
+export type ReadResourceTemplateCallback = (
+  client: PolarCore,
+  uri: URL,
+  vars: Variables,
+  extra: RequestHandlerExtra,
+) => ReadResourceResult | Promise<ReadResourceResult>;
+
+export type ResourceTemplateDefinition = {
+  name: string;
+  description: string;
+  scopes?: MCPScope[];
+  resource: ResourceTemplate;
+  read: ReadResourceTemplateCallback;
+};
+
+export async function formatResult(
+  result: Result<unknown, Error>,
+  uri: URL,
+  init: { response?: Response | undefined },
+): Promise<ReadResourceResult> {
+  if (!result.ok) {
+    throw result.error;
+  }
+
+  const { value } = result;
+  if (typeof value === "undefined") {
+    return { contents: [] };
+  }
+
+  const { response } = init;
+  const mimeType = response?.headers.get("content-type") ?? "";
+  let contents: ReadResourceResult["contents"] = [];
+
+  if (mimeType.search(/\bjson\b/g)) {
+    contents = [{ uri: uri.toString(), mimeType, text: JSON.stringify(value) }];
+  } else if (
+    mimeType.startsWith("text/event-stream")
+    && isAsyncIterable(value)
+  ) {
+    contents = [
+      {
+        uri: uri.toString(),
+        mimeType: "application/json",
+        text: await stringifySSEToJSON(value),
+      },
+    ];
+  } else if (mimeType.startsWith("text/") && typeof value === "string") {
+    contents = [{ uri: uri.toString(), mimeType, text: value }];
+  } else if (isBinaryData(value)) {
+    const blob = await valueToBase64(value);
+    contents = blob == null ? [] : [{ uri: uri.toString(), blob, mimeType }];
+  } else {
+    throw new Error(`Unsupported content type: "${mimeType}"`);
+  }
+
+  return { contents };
+}
+
+async function stringifySSEToJSON(
+  value: AsyncIterable<unknown>,
+): Promise<string> {
+  const payloads = [];
+
+  for await (const chunk of value) {
+    payloads.push(chunk);
+  }
+
+  return JSON.stringify(payloads);
+}

package/src/mcp-server/scopes.ts

@@ -0,0 +1,7 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+export const mcpScopes = [] as const;
+
+export type MCPScope = (typeof mcpScopes)[number];

package/src/mcp-server/server.ts

@@ -0,0 +1,222 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { PolarCore } from "../core.js";
+import { SDKOptions } from "../lib/config.js";
+import type { ConsoleLogger } from "./console-logger.js";
+import { MCPScope, mcpScopes } from "./scopes.js";
+import { createRegisterTool } from "./tools.js";
+import { tool$advertisementsGet } from "./tools/advertisementsGet.js";
+import { tool$advertisementsList } from "./tools/advertisementsList.js";
+import { tool$benefitsCreate } from "./tools/benefitsCreate.js";
+import { tool$benefitsDelete } from "./tools/benefitsDelete.js";
+import { tool$benefitsGet } from "./tools/benefitsGet.js";
+import { tool$benefitsGrants } from "./tools/benefitsGrants.js";
+import { tool$benefitsList } from "./tools/benefitsList.js";
+import { tool$benefitsUpdate } from "./tools/benefitsUpdate.js";
+import { tool$checkoutLinksCreate } from "./tools/checkoutLinksCreate.js";
+import { tool$checkoutLinksDelete } from "./tools/checkoutLinksDelete.js";
+import { tool$checkoutLinksGet } from "./tools/checkoutLinksGet.js";
+import { tool$checkoutLinksList } from "./tools/checkoutLinksList.js";
+import { tool$checkoutLinksUpdate } from "./tools/checkoutLinksUpdate.js";
+import { tool$checkoutsClientConfirm } from "./tools/checkoutsClientConfirm.js";
+import { tool$checkoutsClientGet } from "./tools/checkoutsClientGet.js";
+import { tool$checkoutsClientUpdate } from "./tools/checkoutsClientUpdate.js";
+import { tool$checkoutsCreate } from "./tools/checkoutsCreate.js";
+import { tool$checkoutsGet } from "./tools/checkoutsGet.js";
+import { tool$checkoutsList } from "./tools/checkoutsList.js";
+import { tool$checkoutsUpdate } from "./tools/checkoutsUpdate.js";
+import { tool$customerPortalDownloadablesGet } from "./tools/customerPortalDownloadablesGet.js";
+import { tool$customerPortalLicenseKeysActivate } from "./tools/customerPortalLicenseKeysActivate.js";
+import { tool$customerPortalLicenseKeysDeactivate } from "./tools/customerPortalLicenseKeysDeactivate.js";
+import { tool$customerPortalLicenseKeysValidate } from "./tools/customerPortalLicenseKeysValidate.js";
+import { tool$customerPortalOrganizationsGet } from "./tools/customerPortalOrganizationsGet.js";
+import { tool$customersCreate } from "./tools/customersCreate.js";
+import { tool$customersDelete } from "./tools/customersDelete.js";
+import { tool$customerSessionsCreate } from "./tools/customerSessionsCreate.js";
+import { tool$customersGet } from "./tools/customersGet.js";
+import { tool$customersList } from "./tools/customersList.js";
+import { tool$customersUpdate } from "./tools/customersUpdate.js";
+import { tool$customFieldsCreate } from "./tools/customFieldsCreate.js";
+import { tool$customFieldsDelete } from "./tools/customFieldsDelete.js";
+import { tool$customFieldsGet } from "./tools/customFieldsGet.js";
+import { tool$customFieldsList } from "./tools/customFieldsList.js";
+import { tool$customFieldsUpdate } from "./tools/customFieldsUpdate.js";
+import { tool$discountsCreate } from "./tools/discountsCreate.js";
+import { tool$discountsDelete } from "./tools/discountsDelete.js";
+import { tool$discountsGet } from "./tools/discountsGet.js";
+import { tool$discountsList } from "./tools/discountsList.js";
+import { tool$discountsUpdate } from "./tools/discountsUpdate.js";
+import { tool$eventsGet } from "./tools/eventsGet.js";
+import { tool$eventsIngest } from "./tools/eventsIngest.js";
+import { tool$eventsList } from "./tools/eventsList.js";
+import { tool$externalOrganizationsList } from "./tools/externalOrganizationsList.js";
+import { tool$filesCreate } from "./tools/filesCreate.js";
+import { tool$filesDelete } from "./tools/filesDelete.js";
+import { tool$filesList } from "./tools/filesList.js";
+import { tool$filesUpdate } from "./tools/filesUpdate.js";
+import { tool$filesUploaded } from "./tools/filesUploaded.js";
+import { tool$licenseKeysGet } from "./tools/licenseKeysGet.js";
+import { tool$licenseKeysGetActivation } from "./tools/licenseKeysGetActivation.js";
+import { tool$licenseKeysList } from "./tools/licenseKeysList.js";
+import { tool$licenseKeysUpdate } from "./tools/licenseKeysUpdate.js";
+import { tool$metersCreate } from "./tools/metersCreate.js";
+import { tool$metersEvents } from "./tools/metersEvents.js";
+import { tool$metersGet } from "./tools/metersGet.js";
+import { tool$metersList } from "./tools/metersList.js";
+import { tool$metersQuantities } from "./tools/metersQuantities.js";
+import { tool$metersUpdate } from "./tools/metersUpdate.js";
+import { tool$metricsGet } from "./tools/metricsGet.js";
+import { tool$metricsLimits } from "./tools/metricsLimits.js";
+import { tool$oauth2Authorize } from "./tools/oauth2Authorize.js";
+import { tool$oauth2ClientsCreate } from "./tools/oauth2ClientsCreate.js";
+import { tool$oauth2ClientsDelete } from "./tools/oauth2ClientsDelete.js";
+import { tool$oauth2ClientsGet } from "./tools/oauth2ClientsGet.js";
+import { tool$oauth2ClientsList } from "./tools/oauth2ClientsList.js";
+import { tool$oauth2ClientsUpdate } from "./tools/oauth2ClientsUpdate.js";
+import { tool$oauth2Introspect } from "./tools/oauth2Introspect.js";
+import { tool$oauth2Revoke } from "./tools/oauth2Revoke.js";
+import { tool$oauth2Token } from "./tools/oauth2Token.js";
+import { tool$oauth2Userinfo } from "./tools/oauth2Userinfo.js";
+import { tool$ordersGet } from "./tools/ordersGet.js";
+import { tool$ordersInvoice } from "./tools/ordersInvoice.js";
+import { tool$ordersList } from "./tools/ordersList.js";
+import { tool$organizationsCreate } from "./tools/organizationsCreate.js";
+import { tool$organizationsGet } from "./tools/organizationsGet.js";
+import { tool$organizationsList } from "./tools/organizationsList.js";
+import { tool$organizationsUpdate } from "./tools/organizationsUpdate.js";
+import { tool$productsCreate } from "./tools/productsCreate.js";
+import { tool$productsGet } from "./tools/productsGet.js";
+import { tool$productsList } from "./tools/productsList.js";
+import { tool$productsUpdate } from "./tools/productsUpdate.js";
+import { tool$productsUpdateBenefits } from "./tools/productsUpdateBenefits.js";
+import { tool$refundsCreate } from "./tools/refundsCreate.js";
+import { tool$refundsList } from "./tools/refundsList.js";
+import { tool$repositoriesGet } from "./tools/repositoriesGet.js";
+import { tool$repositoriesList } from "./tools/repositoriesList.js";
+import { tool$repositoriesUpdate } from "./tools/repositoriesUpdate.js";
+import { tool$subscriptionsExport } from "./tools/subscriptionsExport.js";
+import { tool$subscriptionsGet } from "./tools/subscriptionsGet.js";
+import { tool$subscriptionsList } from "./tools/subscriptionsList.js";
+import { tool$subscriptionsRevoke } from "./tools/subscriptionsRevoke.js";
+import { tool$subscriptionsUpdate } from "./tools/subscriptionsUpdate.js";
+
+export function createMCPServer(deps: {
+  logger: ConsoleLogger;
+  scopes?: MCPScope[] | undefined;
+  serverURL?: string | undefined;
+  accessToken?: SDKOptions["accessToken"] | undefined;
+  server?: SDKOptions["server"] | undefined;
+}) {
+  const server = new McpServer({
+    name: "Polar",
+    version: "0.27.0",
+  });
+
+  const client = new PolarCore({
+    accessToken: deps.accessToken,
+    serverURL: deps.serverURL,
+    server: deps.server,
+  });
+  const scopes = new Set(deps.scopes ?? mcpScopes);
+  const tool = createRegisterTool(deps.logger, server, client, scopes);
+
+  tool(tool$externalOrganizationsList);
+  tool(tool$repositoriesList);
+  tool(tool$repositoriesGet);
+  tool(tool$repositoriesUpdate);
+  tool(tool$organizationsList);
+  tool(tool$organizationsCreate);
+  tool(tool$organizationsGet);
+  tool(tool$organizationsUpdate);
+  tool(tool$subscriptionsList);
+  tool(tool$subscriptionsExport);
+  tool(tool$subscriptionsGet);
+  tool(tool$subscriptionsUpdate);
+  tool(tool$subscriptionsRevoke);
+  tool(tool$advertisementsList);
+  tool(tool$advertisementsGet);
+  tool(tool$oauth2Authorize);
+  tool(tool$oauth2Token);
+  tool(tool$oauth2Revoke);
+  tool(tool$oauth2Introspect);
+  tool(tool$oauth2Userinfo);
+  tool(tool$benefitsList);
+  tool(tool$benefitsCreate);
+  tool(tool$benefitsGet);
+  tool(tool$benefitsUpdate);
+  tool(tool$benefitsDelete);
+  tool(tool$benefitsGrants);
+  tool(tool$productsList);
+  tool(tool$productsCreate);
+  tool(tool$productsGet);
+  tool(tool$productsUpdate);
+  tool(tool$productsUpdateBenefits);
+  tool(tool$ordersList);
+  tool(tool$ordersGet);
+  tool(tool$ordersInvoice);
+  tool(tool$refundsList);
+  tool(tool$refundsCreate);
+  tool(tool$checkoutsList);
+  tool(tool$checkoutsCreate);
+  tool(tool$checkoutsGet);
+  tool(tool$checkoutsUpdate);
+  tool(tool$checkoutsClientGet);
+  tool(tool$checkoutsClientUpdate);
+  tool(tool$checkoutsClientConfirm);
+  tool(tool$filesList);
+  tool(tool$filesCreate);
+  tool(tool$filesUploaded);
+  tool(tool$filesUpdate);
+  tool(tool$filesDelete);
+  tool(tool$metricsGet);
+  tool(tool$metricsLimits);
+  tool(tool$licenseKeysList);
+  tool(tool$licenseKeysGet);
+  tool(tool$licenseKeysUpdate);
+  tool(tool$licenseKeysGetActivation);
+  tool(tool$checkoutLinksList);
+  tool(tool$checkoutLinksCreate);
+  tool(tool$checkoutLinksGet);
+  tool(tool$checkoutLinksUpdate);
+  tool(tool$checkoutLinksDelete);
+  tool(tool$customFieldsList);
+  tool(tool$customFieldsCreate);
+  tool(tool$customFieldsGet);
+  tool(tool$customFieldsUpdate);
+  tool(tool$customFieldsDelete);
+  tool(tool$discountsList);
+  tool(tool$discountsCreate);
+  tool(tool$discountsGet);
+  tool(tool$discountsUpdate);
+  tool(tool$discountsDelete);
+  tool(tool$customersList);
+  tool(tool$customersCreate);
+  tool(tool$customersGet);
+  tool(tool$customersUpdate);
+  tool(tool$customersDelete);
+  tool(tool$customerSessionsCreate);
+  tool(tool$eventsList);
+  tool(tool$eventsGet);
+  tool(tool$eventsIngest);
+  tool(tool$metersList);
+  tool(tool$metersCreate);
+  tool(tool$metersGet);
+  tool(tool$metersUpdate);
+  tool(tool$metersEvents);
+  tool(tool$metersQuantities);
+  tool(tool$oauth2ClientsList);
+  tool(tool$oauth2ClientsCreate);
+  tool(tool$oauth2ClientsGet);
+  tool(tool$oauth2ClientsUpdate);
+  tool(tool$oauth2ClientsDelete);
+  tool(tool$customerPortalDownloadablesGet);
+  tool(tool$customerPortalLicenseKeysValidate);
+  tool(tool$customerPortalLicenseKeysActivate);
+  tool(tool$customerPortalLicenseKeysDeactivate);
+  tool(tool$customerPortalOrganizationsGet);
+
+  return server;
+}

package/src/mcp-server/shared.ts

@@ -0,0 +1,75 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod";
+import { bytesToBase64 } from "../lib/base64.js";
+
+type BinaryData =
+  | Uint8Array
+  | ArrayBuffer
+  | Blob
+  | ReadableStream
+  | Response
+  | string;
+
+export async function consumeStream(
+  stream: ReadableStream<Uint8Array>,
+): Promise<Uint8Array> {
+  const reader = stream.getReader();
+  const chunks: Uint8Array[] = [];
+
+  try {
+    while (true) {
+      const { done, value } = await reader.read();
+      if (value != null) chunks.push(value);
+      if (done) break;
+    }
+  } finally {
+    reader.releaseLock();
+  }
+
+  return new Uint8Array(await new Blob(chunks).arrayBuffer());
+}
+
+export function isAsyncIterable(
+  value: unknown,
+): value is AsyncIterable<string> {
+  return (
+    typeof value === "object" && value != null && Symbol.asyncIterator in value
+  );
+}
+
+export function isBinaryData(value: unknown): value is BinaryData {
+  return (
+    value instanceof Uint8Array
+    || value instanceof ArrayBuffer
+    || value instanceof Blob
+    || value instanceof ReadableStream
+    || value instanceof Response
+    || typeof value === "string"
+  );
+}
+
+const base64Schema = z.string().base64();
+
+export async function valueToBase64(
+  value: BinaryData | null | undefined,
+): Promise<string | null> {
+  if (value == null) {
+    return null;
+  } else if (value instanceof Uint8Array) {
+    return bytesToBase64(value);
+  } else if (value instanceof ArrayBuffer) {
+    return bytesToBase64(new Uint8Array(value));
+  } else if (value instanceof Response || value instanceof Blob) {
+    return bytesToBase64(new Uint8Array(await value.arrayBuffer()));
+  } else if (value instanceof ReadableStream) {
+    return bytesToBase64(await consumeStream(value));
+  } else if (typeof value === "string") {
+    return base64Schema.parse(value);
+  } else {
+    value satisfies never;
+    throw new Error(`Unsupported image value type: ${typeof value}`);
+  }
+}

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

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { advertisementsGet } from "../../funcs/advertisementsGet.js";
+import { AdvertisementsGetRequest$inboundSchema } from "../../models/operations/advertisementsget.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: AdvertisementsGetRequest$inboundSchema,
+};
+
+export const tool$advertisementsGet: ToolDefinition<typeof args> = {
+  name: "advertisements_get",
+  description: `Get Campaign
+
+Get an advertisement campaign by ID.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await advertisementsGet(
+      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/advertisementsList.ts

@@ -0,0 +1,37 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { advertisementsList } from "../../funcs/advertisementsList.js";
+import { AdvertisementsListRequest$inboundSchema } from "../../models/operations/advertisementslist.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: AdvertisementsListRequest$inboundSchema,
+};
+
+export const tool$advertisementsList: ToolDefinition<typeof args> = {
+  name: "advertisements_list",
+  description: `List Campaigns
+
+List active advertisement campaigns for a benefit.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await advertisementsList(
+      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.result;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { benefitsCreate } from "../../funcs/benefitsCreate.js";
+import { BenefitCreate$inboundSchema } from "../../models/components/benefitcreate.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: BenefitCreate$inboundSchema,
+};
+
+export const tool$benefitsCreate: ToolDefinition<typeof args> = {
+  name: "benefits_create",
+  description: `Create Benefit
+
+Create a benefit.
+
+**Scopes**: \`benefits:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await benefitsCreate(
+      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/benefitsDelete.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { benefitsDelete } from "../../funcs/benefitsDelete.js";
+import { BenefitsDeleteRequest$inboundSchema } from "../../models/operations/benefitsdelete.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: BenefitsDeleteRequest$inboundSchema,
+};
+
+export const tool$benefitsDelete: ToolDefinition<typeof args> = {
+  name: "benefits_delete",
+  description: `Delete Benefit
+
+Delete a benefit.
+
+> [!WARNING]
+> Every grants associated with the benefit will be revoked.
+> Users will lose access to the benefit.
+
+**Scopes**: \`benefits:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await benefitsDelete(
+      client,
+      args.request,
+      { fetchOptions: { signal: ctx.signal } },
+    ).$inspect();
+
+    if (!result.ok) {
+      return {
+        content: [{ type: "text", text: result.error.message }],
+        isError: true,
+      };
+    }
+
+    return formatResult(void 0, apiCall);
+  },
+};

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { benefitsGet } from "../../funcs/benefitsGet.js";
+import { BenefitsGetRequest$inboundSchema } from "../../models/operations/benefitsget.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: BenefitsGetRequest$inboundSchema,
+};
+
+export const tool$benefitsGet: ToolDefinition<typeof args> = {
+  name: "benefits_get",
+  description: `Get Benefit
+
+Get a benefit by ID.
+
+**Scopes**: \`benefits:read\` \`benefits:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await benefitsGet(
+      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/benefitsGrants.ts

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { benefitsGrants } from "../../funcs/benefitsGrants.js";
+import { BenefitsGrantsRequest$inboundSchema } from "../../models/operations/benefitsgrants.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: BenefitsGrantsRequest$inboundSchema,
+};
+
+export const tool$benefitsGrants: ToolDefinition<typeof args> = {
+  name: "benefits_grants",
+  description: `List Benefit Grants
+
+List the individual grants for a benefit.
+
+It's especially useful to check if a user has been granted a benefit.
+
+**Scopes**: \`benefits:read\` \`benefits:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await benefitsGrants(
+      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.result;
+
+    return formatResult(value, apiCall);
+  },
+};

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { benefitsList } from "../../funcs/benefitsList.js";
+import { BenefitsListRequest$inboundSchema } from "../../models/operations/benefitslist.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: BenefitsListRequest$inboundSchema,
+};
+
+export const tool$benefitsList: ToolDefinition<typeof args> = {
+  name: "benefits_list",
+  description: `List Benefits
+
+List benefits.
+
+**Scopes**: \`benefits:read\` \`benefits:write\``,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await benefitsList(
+      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.result;
+
+    return formatResult(value, apiCall);
+  },
+};