@novu/api 0.7.0 → 1.1.0

package/src/lib/config.ts

@@ -54,8 +54,8 @@ export function serverURLFromOptions(options: SDKOptions): URL | null {
 
 export const SDK_METADATA = {
   language: "typescript",
-  openapiDocVersion: "2.1.13",
-  sdkVersion: "0.7.0",
-  genVersion: "2.597.9",
-  userAgent: "speakeasy-sdk/typescript 0.7.0 2.597.9 2.1.13 @novu/api",
+  openapiDocVersion: "2.2.0",
+  sdkVersion: "1.1.0",
+  genVersion: "2.605.6",
+  userAgent: "speakeasy-sdk/typescript 1.1.0 2.605.6 2.2.0 @novu/api",
 } as const;

package/src/mcp-server/cli/start/impl.ts

@@ -50,7 +50,7 @@ async function startStdio(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     scopes: flags.scope,
-    ...{ secretKey: flags["secret-key"] },
+    ...{ secretKey: flags["secret-key"] ?? "" },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });
@@ -71,7 +71,7 @@ async function startSSE(flags: StartCommandFlags) {
     logger,
     allowedTools: flags.tool,
     scopes: flags.scope,
-    ...{ secretKey: flags["secret-key"] },
+    ...{ secretKey: flags["secret-key"] ?? "" },
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });

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

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

package/src/mcp-server/server.ts

@@ -20,23 +20,17 @@ import { tool$integrationsList } from "./tools/integrationsList.js";
 import { tool$integrationsListActive } from "./tools/integrationsListActive.js";
 import { tool$integrationsSetAsPrimary } from "./tools/integrationsSetAsPrimary.js";
 import { tool$integrationsUpdate } from "./tools/integrationsUpdate.js";
-import { tool$integrationsWebhooksRetrieve } from "./tools/integrationsWebhooksRetrieve.js";
 import { tool$messagesDelete } from "./tools/messagesDelete.js";
 import { tool$messagesDeleteByTransactionId } from "./tools/messagesDeleteByTransactionId.js";
 import { tool$messagesRetrieve } from "./tools/messagesRetrieve.js";
 import { tool$notificationsList } from "./tools/notificationsList.js";
 import { tool$notificationsRetrieve } from "./tools/notificationsRetrieve.js";
-import { tool$notificationsStatsGraph } from "./tools/notificationsStatsGraph.js";
-import { tool$notificationsStatsRetrieve } from "./tools/notificationsStatsRetrieve.js";
-import { tool$subscribersAuthenticationChatAccessOauth } from "./tools/subscribersAuthenticationChatAccessOauth.js";
-import { tool$subscribersAuthenticationChatAccessOauthCallBack } from "./tools/subscribersAuthenticationChatAccessOauthCallBack.js";
 import { tool$subscribersCreate } from "./tools/subscribersCreate.js";
 import { tool$subscribersCreateBulk } from "./tools/subscribersCreateBulk.js";
 import { tool$subscribersCredentialsAppend } from "./tools/subscribersCredentialsAppend.js";
 import { tool$subscribersCredentialsDelete } from "./tools/subscribersCredentialsDelete.js";
 import { tool$subscribersCredentialsUpdate } from "./tools/subscribersCredentialsUpdate.js";
 import { tool$subscribersDelete } from "./tools/subscribersDelete.js";
-import { tool$subscribersList } from "./tools/subscribersList.js";
 import { tool$subscribersMessagesMarkAll } from "./tools/subscribersMessagesMarkAll.js";
 import { tool$subscribersMessagesMarkAllAs } from "./tools/subscribersMessagesMarkAllAs.js";
 import { tool$subscribersMessagesUpdateAsSeen } from "./tools/subscribersMessagesUpdateAsSeen.js";
@@ -48,15 +42,16 @@ import { tool$subscribersPreferencesUpdate } from "./tools/subscribersPreference
 import { tool$subscribersPropertiesUpdateOnlineFlag } from "./tools/subscribersPropertiesUpdateOnlineFlag.js";
 import { tool$subscribersRetrieve } from "./tools/subscribersRetrieve.js";
 import { tool$subscribersSearch } from "./tools/subscribersSearch.js";
-import { tool$subscribersUpsert } from "./tools/subscribersUpsert.js";
+import { tool$subscribersTopicsList } from "./tools/subscribersTopicsList.js";
 import { tool$topicsCreate } from "./tools/topicsCreate.js";
 import { tool$topicsDelete } from "./tools/topicsDelete.js";
+import { tool$topicsGet } from "./tools/topicsGet.js";
 import { tool$topicsList } from "./tools/topicsList.js";
-import { tool$topicsRename } from "./tools/topicsRename.js";
-import { tool$topicsRetrieve } from "./tools/topicsRetrieve.js";
-import { tool$topicsSubscribersAssign } from "./tools/topicsSubscribersAssign.js";
-import { tool$topicsSubscribersRemove } from "./tools/topicsSubscribersRemove.js";
 import { tool$topicsSubscribersRetrieve } from "./tools/topicsSubscribersRetrieve.js";
+import { tool$topicsSubscriptionsCreate } from "./tools/topicsSubscriptionsCreate.js";
+import { tool$topicsSubscriptionsDelete } from "./tools/topicsSubscriptionsDelete.js";
+import { tool$topicsSubscriptionsList } from "./tools/topicsSubscriptionsList.js";
+import { tool$topicsUpdate } from "./tools/topicsUpdate.js";
 import { tool$trigger } from "./tools/trigger.js";
 import { tool$triggerBroadcast } from "./tools/triggerBroadcast.js";
 import { tool$triggerBulk } from "./tools/triggerBulk.js";
@@ -71,7 +66,7 @@ export function createMCPServer(deps: {
 }) {
   const server = new McpServer({
     name: "Novu",
-    version: "0.7.0",
+    version: "1.1.0",
   });
 
   const client = new NovuCore({
@@ -110,9 +105,12 @@ export function createMCPServer(deps: {
   tool(tool$subscribersRetrieve);
   tool(tool$subscribersPatch);
   tool(tool$subscribersDelete);
-  tool(tool$subscribersList);
-  tool(tool$subscribersUpsert);
   tool(tool$subscribersCreateBulk);
+  tool(tool$topicsList);
+  tool(tool$topicsCreate);
+  tool(tool$topicsGet);
+  tool(tool$topicsUpdate);
+  tool(tool$topicsDelete);
   tool(tool$integrationsList);
   tool(tool$integrationsCreate);
   tool(tool$integrationsUpdate);
@@ -124,30 +122,22 @@ export function createMCPServer(deps: {
   tool(tool$messagesDeleteByTransactionId);
   tool(tool$notificationsList);
   tool(tool$notificationsRetrieve);
-  tool(tool$topicsCreate);
-  tool(tool$topicsList);
-  tool(tool$topicsDelete);
-  tool(tool$topicsRetrieve);
-  tool(tool$topicsRename);
   tool(tool$subscribersPreferencesList);
   tool(tool$subscribersPreferencesUpdate);
+  tool(tool$subscribersTopicsList);
   tool(tool$subscribersCredentialsUpdate);
   tool(tool$subscribersCredentialsAppend);
   tool(tool$subscribersCredentialsDelete);
-  tool(tool$subscribersAuthenticationChatAccessOauth);
-  tool(tool$subscribersAuthenticationChatAccessOauthCallBack);
   tool(tool$subscribersMessagesUpdateAsSeen);
   tool(tool$subscribersMessagesMarkAll);
   tool(tool$subscribersMessagesMarkAllAs);
   tool(tool$subscribersNotificationsFeed);
   tool(tool$subscribersNotificationsUnseenCount);
   tool(tool$subscribersPropertiesUpdateOnlineFlag);
-  tool(tool$integrationsWebhooksRetrieve);
-  tool(tool$notificationsStatsGraph);
-  tool(tool$notificationsStatsRetrieve);
-  tool(tool$topicsSubscribersAssign);
+  tool(tool$topicsSubscriptionsList);
+  tool(tool$topicsSubscriptionsCreate);
+  tool(tool$topicsSubscriptionsDelete);
   tool(tool$topicsSubscribersRetrieve);
-  tool(tool$topicsSubscribersRemove);
 
   return server;
 }

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

@@ -15,9 +15,10 @@ const args = {
 
 export const tool$integrationsCreate: ToolDefinition<typeof args> = {
   name: "integrations-create",
-  description: `Create integration
+  description: `Create an integration
 
-Create an integration for the current environment the user is based on the API key provided`,
+Create an integration for the current environment the user is based on the API key provided. 
+    Each provider supports different credentials, check the provider documentation for more details.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await integrationsCreate(

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

@@ -13,7 +13,10 @@ const args = {
 
 export const tool$integrationsDelete: ToolDefinition<typeof args> = {
   name: "integrations-delete",
-  description: `Delete integration`,
+  description: `Delete an integration
+
+Delete an integration by its unique key identifier **integrationId**. 
+    This action is irreversible.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await integrationsDelete(

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

@@ -12,9 +12,9 @@ const args = {
 
 export const tool$integrationsList: ToolDefinition<typeof args> = {
   name: "integrations-list",
-  description: `Get integrations
+  description: `List all integrations
 
-Return all the integrations the user has created for that organization. Review v.0.17.0 changelog for a breaking change`,
+List all the channels integrations created in the organization`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await integrationsList(

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

@@ -12,9 +12,9 @@ const args = {
 
 export const tool$integrationsListActive: ToolDefinition<typeof args> = {
   name: "integrations-list-active",
-  description: `Get active integrations
+  description: `List active integrations
 
-Return all the active integrations the user has created for that organization. Review v.0.17.0 changelog for a breaking change`,
+List all the active integrations created in the organization`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await integrationsListActive(

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

@@ -13,7 +13,11 @@ const args = {
 
 export const tool$integrationsSetAsPrimary: ToolDefinition<typeof args> = {
   name: "integrations-set-as-primary",
-  description: `Set integration as primary`,
+  description: `Update integration as primary
+
+Update an integration as **primary** by its unique key identifier **integrationId**. 
+    This API will set the integration as primary for that channel in the current environment. 
+    Primary integration is used to deliver notification for sms and email channels in the workflow.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await integrationsSetAsPrimary(

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

@@ -16,7 +16,10 @@ const args = {
 
 export const tool$integrationsUpdate: ToolDefinition<typeof args> = {
   name: "integrations-update",
-  description: `Update integration`,
+  description: `Update an integration
+
+Update an integration by its unique key identifier **integrationId**. 
+    Each provider supports different credentials, check the provider documentation for more details.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await integrationsUpdate(

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

@@ -13,9 +13,10 @@ const args = {
 
 export const tool$messagesDelete: ToolDefinition<typeof args> = {
   name: "messages-delete",
-  description: `Delete message
+  description: `Delete a message
 
-Deletes a message entity from the Novu platform`,
+Delete a message entity from the Novu platform by **messageId**. 
+    This action is irreversible. **messageId** is required and of mongodbId type.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await messagesDelete(

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

@@ -17,7 +17,8 @@ export const tool$messagesDeleteByTransactionId: ToolDefinition<typeof args> = {
   name: "messages-delete-by-transaction-id",
   description: `Delete messages by transactionId
 
-Deletes messages entity from the Novu platform using TransactionId of message`,
+Delete multiple messages from the Novu platform using **transactionId** of triggered event. 
+    This API supports filtering by **channel** and delete all messages associated with the **transactionId**.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await messagesDeleteByTransactionId(

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

@@ -12,9 +12,11 @@ const args = {
 
 export const tool$messagesRetrieve: ToolDefinition<typeof args> = {
   name: "messages-retrieve",
-  description: `Get messages
+  description: `List all messages
 
-Returns a list of messages, could paginate using the \`page\` query parameter`,
+List all messages for the current environment. 
+    This API supports filtering by **channel**, **subscriberId**, and **transactionId**. 
+    This API returns a paginated list of messages.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await messagesRetrieve(

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

@@ -13,7 +13,12 @@ const args = {
 
 export const tool$notificationsList: ToolDefinition<typeof args> = {
   name: "notifications-list",
-  description: `Get notifications`,
+  description: `List all events
+
+List all notification events (triggered events) for the current environment. 
+    This API supports filtering by **channels**, **templates**, **emails**, **subscriberIds**, **transactionId**, **topicKey**. 
+    Checkout all available filters in the query section.
+    This API returns event triggers, to list each channel notifications, check messages APIs.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await notificationsList(

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

@@ -13,7 +13,11 @@ const args = {
 
 export const tool$notificationsRetrieve: ToolDefinition<typeof args> = {
   name: "notifications-retrieve",
-  description: `Get notification`,
+  description: `Retrieve an event
+
+Retrieve an event by its unique key identifier **notificationId**. 
+    Here **notificationId** is of mongodbId type. 
+    This API returns the event details - execution logs, status, actual notification (message) generated by each workflow step.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await notificationsRetrieve(

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

@@ -15,9 +15,10 @@ const args = {
 
 export const tool$subscribersCreate: ToolDefinition<typeof args> = {
   name: "subscribers-create",
-  description: `Create subscriber
+  description: `Create a subscriber
 
-Create subscriber with the given data`,
+Create a subscriber with the subscriber attributes. 
+      **subscriberId** is a required field, rest other fields are optional, if the subscriber already exists, it will be updated`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersCreate(

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

@@ -17,8 +17,7 @@ export const tool$subscribersCreateBulk: ToolDefinition<typeof args> = {
   description: `Bulk create subscribers
 
 
-      Using this endpoint you can create multiple subscribers at once, to avoid multiple calls to the API.
-      The bulk API is limited to 500 subscribers per request.
+      Using this endpoint multiple subscribers can be created at once. The bulk API is limited to 500 subscribers per request.
     `,
   args,
   tool: async (client, args, ctx) => {

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

@@ -16,10 +16,10 @@ const args = {
 
 export const tool$subscribersCredentialsAppend: ToolDefinition<typeof args> = {
   name: "subscribers-credentials-append",
-  description: `Modify subscriber credentials
+  description: `Upsert provider credentials
 
-Subscriber credentials associated to the delivery methods such as slack and push tokens.
-    This endpoint appends provided credentials and deviceTokens to the existing ones.`,
+Update credentials for a provider such as **slack** and **FCM**. 
+      **providerId** is required field. This API replaces the existing deviceTokens with the provided ones.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersCredentialsAppend(

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

@@ -14,9 +14,10 @@ const args = {
 
 export const tool$subscribersCredentialsDelete: ToolDefinition<typeof args> = {
   name: "subscribers-credentials-delete",
-  description: `Delete subscriber credentials by providerId
+  description: `Delete provider credentials
 
-Delete subscriber credentials such as slack and expo tokens.`,
+Delete subscriber credentials for a provider such as **slack** and **FCM** by **providerId**. 
+    This action is irreversible and will remove the credentials for the provider for particular **subscriberId**.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersCredentialsDelete(

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

@@ -16,9 +16,10 @@ const args = {
 
 export const tool$subscribersCredentialsUpdate: ToolDefinition<typeof args> = {
   name: "subscribers-credentials-update",
-  description: `Update subscriber credentials
+  description: `Update provider credentials
 
-Subscriber credentials associated to the delivery methods such as slack and push tokens.`,
+Update credentials for a provider such as slack and push tokens. 
+      **providerId** is required field. This API appends the **deviceTokens** to the existing ones.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersCredentialsUpdate(

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

@@ -15,7 +15,7 @@ export const tool$subscribersDelete: ToolDefinition<typeof args> = {
   name: "subscribers-delete",
   description: `Delete subscriber
 
-Deletes a subscriber entity from the Novu platform`,
+Deletes a subscriber entity from the Novu platform along with associated messages, preferences, and topic subscriptions`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersDelete(

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

@@ -16,8 +16,9 @@ const args = {
 
 export const tool$subscribersMessagesMarkAll: ToolDefinition<typeof args> = {
   name: "subscribers-messages-mark-all",
-  description:
-    `Marks all the subscriber messages as read, unread, seen or unseen. Optionally you can pass feed id (or array) to mark messages of a particular feed.`,
+  description: `Update all notifications state
+
+Update all subscriber in-app (inbox) notifications state such as read, unread, seen or unseen by **subscriberId**.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersMessagesMarkAll(

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

@@ -15,7 +15,10 @@ const args = {
 
 export const tool$subscribersMessagesMarkAllAs: ToolDefinition<typeof args> = {
   name: "subscribers-messages-mark-all-as",
-  description: `Mark a subscriber messages as seen, read, unseen or unread`,
+  description: `Update notifications state
+
+Update subscriber's multiple in-app (inbox) notifications state such as seen, read, unseen or unread by **subscriberId**. 
+      **messageId** is of type mongodbId of notifications`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersMessagesMarkAllAs(

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

@@ -14,7 +14,10 @@ const args = {
 export const tool$subscribersMessagesUpdateAsSeen: ToolDefinition<typeof args> =
   {
     name: "subscribers-messages-update-as-seen",
-    description: `Mark message action as seen`,
+    description: `Update notification action status
+
+Update in-app (inbox) notification's action status by its unique key identifier **messageId** and type field **type**. 
+      **type** field can be **primary** or **secondary**`,
     args,
     tool: async (client, args, ctx) => {
       const [result, apiCall] = await subscribersMessagesUpdateAsSeen(

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

@@ -13,7 +13,9 @@ const args = {
 
 export const tool$subscribersNotificationsFeed: ToolDefinition<typeof args> = {
   name: "subscribers-notifications-feed",
-  description: `Get in-app notification feed for a particular subscriber`,
+  description: `Retrieve subscriber notifications
+
+Retrieve subscriber in-app (inbox) notifications by its unique key identifier **subscriberId**.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersNotificationsFeed(

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

@@ -15,7 +15,9 @@ export const tool$subscribersNotificationsUnseenCount: ToolDefinition<
   typeof args
 > = {
   name: "subscribers-notifications-unseen-count",
-  description: `Get the unseen in-app notifications count for subscribers feed`,
+  description: `Retrieve unseen notifications count
+
+Retrieve unseen in-app (inbox) notifications count for a subscriber by its unique key identifier **subscriberId**.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersNotificationsUnseenCount(

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

@@ -15,9 +15,10 @@ const args = {
 
 export const tool$subscribersPatch: ToolDefinition<typeof args> = {
   name: "subscribers-patch",
-  description: `Patch subscriber
+  description: `Update a subscriber
 
-Patch subscriber by your internal id used to identify the subscriber`,
+Update a subscriber by its unique key identifier **subscriberId**. 
+    **subscriberId** is a required field, rest other fields are optional`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersPatch(

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

@@ -13,9 +13,10 @@ const args = {
 
 export const tool$subscribersPreferencesList: ToolDefinition<typeof args> = {
   name: "subscribers-preferences-list",
-  description: `Get subscriber preferences
+  description: `Retrieve subscriber preferences
 
-Get subscriber global and workflow specific preferences`,
+Retrieve subscriber channel preferences by its unique key identifier **subscriberId**. 
+    This API returns all five channels preferences for all workflows and global preferences.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersPreferencesList(

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

@@ -16,9 +16,11 @@ const args = {
 
 export const tool$subscribersPreferencesUpdate: ToolDefinition<typeof args> = {
   name: "subscribers-preferences-update",
-  description: `Update subscriber global or workflow specific preferences
+  description: `Update subscriber preferences
 
-Update subscriber global or workflow specific preferences`,
+Update subscriber preferences by its unique key identifier **subscriberId**. 
+    **workflowId** is optional field, if provided, this API will update that workflow preference, 
+    otherwise it will update global preferences`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersPreferencesUpdate(

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

@@ -20,7 +20,7 @@ export const tool$subscribersPropertiesUpdateOnlineFlag: ToolDefinition<
   name: "subscribers-properties-update-online-flag",
   description: `Update subscriber online status
 
-Used to update the subscriber isOnline flag.`,
+Update the subscriber online status by its unique key identifier **subscriberId**`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersPropertiesUpdateOnlineFlag(

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

@@ -13,9 +13,10 @@ const args = {
 
 export const tool$subscribersRetrieve: ToolDefinition<typeof args> = {
   name: "subscribers-retrieve",
-  description: `Get subscriber
+  description: `Retrieve a subscriber
 
-Get subscriber by your internal id used to identify the subscriber`,
+Retrive a subscriber by its unique key identifier **subscriberId**. 
+    **subscriberId** field is required.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersRetrieve(

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

@@ -13,7 +13,10 @@ const args = {
 
 export const tool$subscribersSearch: ToolDefinition<typeof args> = {
   name: "subscribers-search",
-  description: `Search for subscribers`,
+  description: `Search subscribers
+
+Search subscribers by their **email**, **phone**, **subscriberId** and **name**. 
+    The search is case sensitive and supports pagination.Checkout all available filters in the query section.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await subscribersSearch(

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

@@ -0,0 +1,39 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { subscribersTopicsList } from "../../funcs/subscribersTopicsList.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request:
+    operations.SubscribersControllerListSubscriberTopicsRequest$inboundSchema,
+};
+
+export const tool$subscribersTopicsList: ToolDefinition<typeof args> = {
+  name: "subscribers-topics-list",
+  description: `Retrieve subscriber subscriptions
+
+Retrieve subscriber's topic subscriptions by its unique key identifier **subscriberId**. 
+    Checkout all available filters in the query section.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await subscribersTopicsList(
+      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/topicsCreate.ts

@@ -8,20 +8,21 @@ import * as components from "../../models/components/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  createTopicRequestDto: components.CreateTopicRequestDto$inboundSchema,
+  createUpdateTopicRequestDto:
+    components.CreateUpdateTopicRequestDto$inboundSchema,
   idempotencyKey: z.string().optional(),
 };
 
 export const tool$topicsCreate: ToolDefinition<typeof args> = {
   name: "topics-create",
-  description: `Topic creation
+  description: `Create a topic
 
-Create a topic`,
+Creates a new topic if it does not exist, or updates an existing topic if it already exists`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await topicsCreate(
       client,
-      args.createTopicRequestDto,
+      args.createUpdateTopicRequestDto,
       args.idempotencyKey,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();

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

@@ -13,9 +13,10 @@ const args = {
 
 export const tool$topicsDelete: ToolDefinition<typeof args> = {
   name: "topics-delete",
-  description: `Delete topic
+  description: `Delete a topic
 
-Delete a topic by its topic key if it has no subscribers`,
+Delete a topic by its unique key identifier **topicKey**. 
+    This action is irreversible and will remove all subscriptions to the topic.`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await topicsDelete(
@@ -32,6 +33,8 @@ Delete a topic by its topic key if it has no subscribers`,
       };
     }
 
-    return formatResult(void 0, apiCall);
+    const value = result.value.result;
+
+    return formatResult(value, apiCall);
   },
 };