@hookdeck/outpost-sdk 0.6.0 → 0.8.0

package/src/lib/security.ts

@@ -197,8 +197,7 @@ export function resolveSecurity(
         applyBearer(state, spec);
         break;
       default:
-        spec satisfies never;
-        throw SecurityError.unrecognizedType(type);
+        throw SecurityError.unrecognizedType((spec satisfies never, type));
     }
   });
 
@@ -246,14 +245,7 @@ export function resolveGlobalSecurity(
       {
         fieldName: "Authorization",
         type: "http:bearer",
-        value: security?.adminApiKey,
-      },
-    ],
-    [
-      {
-        fieldName: "Authorization",
-        type: "http:bearer",
-        value: security?.tenantJwt,
+        value: security?.apiKey,
       },
     ],
   );

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

@@ -35,26 +35,9 @@ export const startCommand = buildCommand({
           return z.string().parse(value);
         },
       },
-      "admin-api-key": {
+      "api-key": {
         kind: "parsed",
-        brief: "Sets the adminApiKey auth field for the API",
-        optional: true,
-        parse: (value) => {
-          return z.string().parse(value);
-        },
-      },
-      "tenant-jwt": {
-        kind: "parsed",
-        brief: "Sets the tenantJwt auth field for the API",
-        optional: true,
-        parse: (value) => {
-          return z.string().parse(value);
-        },
-      },
-      "tenant-id": {
-        kind: "parsed",
-        brief:
-          "Allows setting the tenantId parameter for all supported operations",
+        brief: "Sets the apiKey auth field for the API",
         optional: true,
         parse: (value) => {
           return z.string().parse(value);

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

@@ -17,9 +17,7 @@ interface StartCommandFlags {
   readonly transport: "stdio" | "sse";
   readonly port: number;
   readonly tool?: string[];
-  readonly "admin-api-key"?: string | undefined;
-  readonly "tenant-jwt"?: string | undefined;
-  readonly "tenant-id"?: SDKOptions["tenantId"] | undefined;
+  readonly "api-key"?: string | undefined;
   readonly "server-url"?: string;
   readonly "server-index"?: SDKOptions["serverIdx"];
   readonly "log-level": ConsoleLoggerLevel;
@@ -49,11 +47,8 @@ async function startStdio(flags: StartCommandFlags) {
   const server = createMCPServer({
     logger,
     allowedTools: flags.tool,
-    security: {
-      adminApiKey: flags["admin-api-key"] ?? "",
-      tenantJwt: flags["tenant-jwt"] ?? "",
-    },
-    tenantId: flags["tenant-id"],
+    apiKey: flags["api-key"] ?? "",
+
     serverURL: flags["server-url"],
     serverIdx: flags["server-index"],
   });
@@ -73,11 +68,8 @@ async function startSSE(flags: StartCommandFlags) {
   const mcpServer = createMCPServer({
     logger,
     allowedTools: flags.tool,
-    security: {
-      adminApiKey: flags["admin-api-key"] ?? "",
-      tenantJwt: flags["tenant-jwt"] ?? "",
-    },
-    tenantId: flags["tenant-id"],
+    apiKey: flags["api-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.6.0",
+    currentVersion: "0.8.0",
   },
 });
 

package/src/mcp-server/server.ts

@@ -13,25 +13,24 @@ import {
 } from "./resources.js";
 import { MCPScope } from "./scopes.js";
 import { createRegisterTool } from "./tools.js";
+import { tool$attemptsGet } from "./tools/attemptsGet.js";
+import { tool$attemptsList } from "./tools/attemptsList.js";
+import { tool$attemptsRetry } from "./tools/attemptsRetry.js";
 import { tool$destinationsCreate } from "./tools/destinationsCreate.js";
 import { tool$destinationsDelete } from "./tools/destinationsDelete.js";
 import { tool$destinationsDisable } from "./tools/destinationsDisable.js";
 import { tool$destinationsEnable } from "./tools/destinationsEnable.js";
 import { tool$destinationsGet } from "./tools/destinationsGet.js";
+import { tool$destinationsGetAttempt } from "./tools/destinationsGetAttempt.js";
 import { tool$destinationsList } from "./tools/destinationsList.js";
+import { tool$destinationsListAttempts } from "./tools/destinationsListAttempts.js";
 import { tool$destinationsUpdate } from "./tools/destinationsUpdate.js";
 import { tool$eventsGet } from "./tools/eventsGet.js";
-import { tool$eventsGetByDestination } from "./tools/eventsGetByDestination.js";
 import { tool$eventsList } from "./tools/eventsList.js";
-import { tool$eventsListByDestination } from "./tools/eventsListByDestination.js";
-import { tool$eventsListDeliveries } from "./tools/eventsListDeliveries.js";
-import { tool$eventsRetry } from "./tools/eventsRetry.js";
 import { tool$healthCheck } from "./tools/healthCheck.js";
 import { tool$publishEvent } from "./tools/publishEvent.js";
-import { tool$schemasGet } from "./tools/schemasGet.js";
-import { tool$schemasGetDestinationTypeJwt } from "./tools/schemasGetDestinationTypeJwt.js";
-import { tool$schemasListDestinationTypesJwt } from "./tools/schemasListDestinationTypesJwt.js";
-import { tool$schemasListTenantDestinationTypes } from "./tools/schemasListTenantDestinationTypes.js";
+import { tool$schemasGetDestinationType } from "./tools/schemasGetDestinationType.js";
+import { tool$schemasListDestinationTypes } from "./tools/schemasListDestinationTypes.js";
 import { tool$tenantsDelete } from "./tools/tenantsDelete.js";
 import { tool$tenantsGet } from "./tools/tenantsGet.js";
 import { tool$tenantsGetPortalUrl } from "./tools/tenantsGetPortalUrl.js";
@@ -39,25 +38,22 @@ import { tool$tenantsGetToken } from "./tools/tenantsGetToken.js";
 import { tool$tenantsListTenants } from "./tools/tenantsListTenants.js";
 import { tool$tenantsUpsert } from "./tools/tenantsUpsert.js";
 import { tool$topicsList } from "./tools/topicsList.js";
-import { tool$topicsListJwt } from "./tools/topicsListJwt.js";
 
 export function createMCPServer(deps: {
   logger: ConsoleLogger;
   allowedTools?: string[] | undefined;
   scopes?: MCPScope[] | undefined;
   serverURL?: string | undefined;
-  security?: SDKOptions["security"] | undefined;
-  tenantId?: SDKOptions["tenantId"] | undefined;
+  apiKey?: SDKOptions["apiKey"] | undefined;
   serverIdx?: SDKOptions["serverIdx"] | undefined;
 }) {
   const server = new McpServer({
     name: "Outpost",
-    version: "0.6.0",
+    version: "0.8.0",
   });
 
   const client = new OutpostCore({
-    security: deps.security,
-    tenantId: deps.tenantId,
+    apiKey: deps.apiKey,
     serverURL: deps.serverURL,
     serverIdx: deps.serverIdx,
   });
@@ -90,6 +86,11 @@ export function createMCPServer(deps: {
   tool(tool$tenantsDelete);
   tool(tool$tenantsGetPortalUrl);
   tool(tool$tenantsGetToken);
+  tool(tool$eventsList);
+  tool(tool$eventsGet);
+  tool(tool$attemptsList);
+  tool(tool$attemptsGet);
+  tool(tool$attemptsRetry);
   tool(tool$destinationsList);
   tool(tool$destinationsCreate);
   tool(tool$destinationsGet);
@@ -97,19 +98,12 @@ export function createMCPServer(deps: {
   tool(tool$destinationsDelete);
   tool(tool$destinationsEnable);
   tool(tool$destinationsDisable);
+  tool(tool$destinationsListAttempts);
+  tool(tool$destinationsGetAttempt);
   tool(tool$publishEvent);
-  tool(tool$schemasListTenantDestinationTypes);
-  tool(tool$schemasGet);
-  tool(tool$schemasListDestinationTypesJwt);
-  tool(tool$schemasGetDestinationTypeJwt);
+  tool(tool$schemasListDestinationTypes);
+  tool(tool$schemasGetDestinationType);
   tool(tool$topicsList);
-  tool(tool$topicsListJwt);
-  tool(tool$eventsList);
-  tool(tool$eventsGet);
-  tool(tool$eventsListDeliveries);
-  tool(tool$eventsListByDestination);
-  tool(tool$eventsGetByDestination);
-  tool(tool$eventsRetry);
 
   return server;
 }

package/src/mcp-server/shared.ts

@@ -16,12 +16,12 @@ export async function consumeStream(
   stream: ReadableStream<Uint8Array>,
 ): Promise<Uint8Array> {
   const reader = stream.getReader();
-  const chunks: Uint8Array[] = [];
+  const chunks: ArrayBuffer[] = [];
 
   try {
     while (true) {
       const { done, value } = await reader.read();
-      if (value != null) chunks.push(value);
+      if (value != null) chunks.push(new Uint8Array(value).buffer);
       if (done) break;
     }
   } finally {

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

@@ -0,0 +1,44 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { attemptsGet } from "../../funcs/attemptsGet.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  attemptId: z.string(),
+  include: operations.GetAttemptInclude$inboundSchema.optional(),
+};
+
+export const tool$attemptsGet: ToolDefinition<typeof args> = {
+  name: "attempts-get",
+  description: `Get Attempt
+
+Retrieves details for a specific attempt.
+
+When authenticated with a Tenant JWT, only attempts belonging to that tenant can be accessed.
+When authenticated with Admin API Key, attempts from any tenant can be accessed.
+`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await attemptsGet(
+      client,
+      args.attemptId,
+      args.include,
+      { 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/{eventsGetByDestination.ts → attemptsList.ts}

@@ -2,22 +2,26 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { eventsGetByDestination } from "../../funcs/eventsGetByDestination.js";
+import { attemptsList } from "../../funcs/attemptsList.js";
 import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.GetTenantEventByDestinationRequest$inboundSchema,
+  request: operations.ListAttemptsRequest$inboundSchema,
 };
 
-export const tool$eventsGetByDestination: ToolDefinition<typeof args> = {
-  name: "events-get-by-destination",
-  description: `Get Event by Destination
+export const tool$attemptsList: ToolDefinition<typeof args> = {
+  name: "attempts-list",
+  description: `List Attempts
 
-Retrieves a specific event associated with a specific destination for the tenant.`,
+Retrieves a paginated list of attempts.
+
+When authenticated with a Tenant JWT, returns only attempts belonging to that tenant.
+When authenticated with Admin API Key, returns attempts across all tenants. Use \`tenant_id\` query parameter to filter by tenant.
+`,
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await eventsGetByDestination(
+    const [result, apiCall] = await attemptsList(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },

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

@@ -0,0 +1,41 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import { attemptsRetry } from "../../funcs/attemptsRetry.js";
+import * as components from "../../models/components/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  request: components.RetryRequest$inboundSchema,
+};
+
+export const tool$attemptsRetry: ToolDefinition<typeof args> = {
+  name: "attempts-retry",
+  description: `Retry Event Delivery
+
+Triggers a retry for delivering an event to a destination. The event must exist and the destination must be enabled and match the event's topic.
+
+When authenticated with a Tenant JWT, only events belonging to that tenant can be retried.
+When authenticated with Admin API Key, events from any tenant can be retried.
+`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await attemptsRetry(
+      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/destinationsCreate.ts

@@ -2,12 +2,14 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsCreate } from "../../funcs/destinationsCreate.js";
-import * as operations from "../../models/operations/index.js";
+import * as components from "../../models/components/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.CreateTenantDestinationRequest$inboundSchema,
+  tenantId: z.string(),
+  params: components.DestinationCreate$inboundSchema,
 };
 
 export const tool$destinationsCreate: ToolDefinition<typeof args> = {
@@ -19,7 +21,8 @@ Creates a new destination for the tenant. The request body structure depends on
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsCreate(
       client,
-      args.request,
+      args.tenantId,
+      args.params,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -2,12 +2,13 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsDelete } from "../../funcs/destinationsDelete.js";
-import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DeleteTenantDestinationRequest$inboundSchema,
+  tenantId: z.string(),
+  destinationId: z.string(),
 };
 
 export const tool$destinationsDelete: ToolDefinition<typeof args> = {
@@ -19,7 +20,8 @@ Deletes a specific destination.`,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsDelete(
       client,
-      args.request,
+      args.tenantId,
+      args.destinationId,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -2,12 +2,13 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsDisable } from "../../funcs/destinationsDisable.js";
-import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.DisableTenantDestinationRequest$inboundSchema,
+  tenantId: z.string(),
+  destinationId: z.string(),
 };
 
 export const tool$destinationsDisable: ToolDefinition<typeof args> = {
@@ -19,7 +20,8 @@ Disables a previously enabled destination.`,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsDisable(
       client,
-      args.request,
+      args.tenantId,
+      args.destinationId,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -2,12 +2,13 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsEnable } from "../../funcs/destinationsEnable.js";
-import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.EnableTenantDestinationRequest$inboundSchema,
+  tenantId: z.string(),
+  destinationId: z.string(),
 };
 
 export const tool$destinationsEnable: ToolDefinition<typeof args> = {
@@ -19,7 +20,8 @@ Enables a previously disabled destination.`,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsEnable(
       client,
-      args.request,
+      args.tenantId,
+      args.destinationId,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -2,12 +2,13 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsGet } from "../../funcs/destinationsGet.js";
-import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.GetTenantDestinationRequest$inboundSchema,
+  tenantId: z.string(),
+  destinationId: z.string(),
 };
 
 export const tool$destinationsGet: ToolDefinition<typeof args> = {
@@ -19,7 +20,8 @@ Retrieves details for a specific destination.`,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsGet(
       client,
-      args.request,
+      args.tenantId,
+      args.destinationId,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -0,0 +1,45 @@
+/*
+ * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
+ */
+
+import * as z from "zod/v3";
+import { destinationsGetAttempt } from "../../funcs/destinationsGetAttempt.js";
+import * as operations from "../../models/operations/index.js";
+import { formatResult, ToolDefinition } from "../tools.js";
+
+const args = {
+  tenantId: z.string(),
+  destinationId: z.string(),
+  attemptId: z.string(),
+  include: operations.GetTenantDestinationAttemptInclude$inboundSchema
+    .optional(),
+};
+
+export const tool$destinationsGetAttempt: ToolDefinition<typeof args> = {
+  name: "destinations-get-attempt",
+  description: `Get Destination Attempt
+
+Retrieves details for a specific attempt scoped to a destination.`,
+  args,
+  tool: async (client, args, ctx) => {
+    const [result, apiCall] = await destinationsGetAttempt(
+      client,
+      args.tenantId,
+      args.destinationId,
+      args.attemptId,
+      args.include,
+      { 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/destinationsList.ts

@@ -2,12 +2,15 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsList } from "../../funcs/destinationsList.js";
 import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.ListTenantDestinationsRequest$inboundSchema,
+  tenantId: z.string(),
+  type: operations.ListTenantDestinationsType$inboundSchema.optional(),
+  topics: operations.Topics$inboundSchema.optional(),
 };
 
 export const tool$destinationsList: ToolDefinition<typeof args> = {
@@ -19,7 +22,9 @@ Return a list of the destinations for the tenant. The endpoint is not paged.`,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsList(
       client,
-      args.request,
+      args.tenantId,
+      args.type,
+      args.topics,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

package/src/mcp-server/tools/{eventsListByDestination.ts → destinationsListAttempts.ts}

@@ -2,22 +2,22 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
-import { eventsListByDestination } from "../../funcs/eventsListByDestination.js";
+import { destinationsListAttempts } from "../../funcs/destinationsListAttempts.js";
 import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.ListTenantEventsByDestinationRequest$inboundSchema,
+  request: operations.ListTenantDestinationAttemptsRequest$inboundSchema,
 };
 
-export const tool$eventsListByDestination: ToolDefinition<typeof args> = {
-  name: "events-list-by-destination",
-  description: `List Events by Destination
+export const tool$destinationsListAttempts: ToolDefinition<typeof args> = {
+  name: "destinations-list-attempts",
+  description: `List Destination Attempts
 
-Retrieves events associated with a specific destination for the tenant.`,
+Retrieves a paginated list of attempts scoped to a specific destination.`,
   args,
   tool: async (client, args, ctx) => {
-    const [result, apiCall] = await eventsListByDestination(
+    const [result, apiCall] = await destinationsListAttempts(
       client,
       args.request,
       { fetchOptions: { signal: ctx.signal } },

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

@@ -2,12 +2,15 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { destinationsUpdate } from "../../funcs/destinationsUpdate.js";
-import * as operations from "../../models/operations/index.js";
+import * as components from "../../models/components/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.UpdateTenantDestinationRequest$inboundSchema,
+  tenantId: z.string(),
+  destinationId: z.string(),
+  params: components.DestinationUpdate$inboundSchema,
 };
 
 export const tool$destinationsUpdate: ToolDefinition<typeof args> = {
@@ -19,7 +22,9 @@ Updates the configuration of an existing destination. The request body structure
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await destinationsUpdate(
       client,
-      args.request,
+      args.tenantId,
+      args.destinationId,
+      args.params,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -2,24 +2,28 @@
  * Code generated by Speakeasy (https://speakeasy.com). DO NOT EDIT.
  */
 
+import * as z from "zod/v3";
 import { eventsGet } from "../../funcs/eventsGet.js";
-import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.GetTenantEventRequest$inboundSchema,
+  eventId: z.string(),
 };
 
 export const tool$eventsGet: ToolDefinition<typeof args> = {
   name: "events-get",
   description: `Get Event
 
-Retrieves details for a specific event.`,
+Retrieves details for a specific event.
+
+When authenticated with a Tenant JWT, only events belonging to that tenant can be accessed.
+When authenticated with Admin API Key, events from any tenant can be accessed.
+`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await eventsGet(
       client,
-      args.request,
+      args.eventId,
       { fetchOptions: { signal: ctx.signal } },
     ).$inspect();
 

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

@@ -7,14 +7,18 @@ import * as operations from "../../models/operations/index.js";
 import { formatResult, ToolDefinition } from "../tools.js";
 
 const args = {
-  request: operations.ListTenantEventsRequest$inboundSchema,
+  request: operations.ListEventsRequest$inboundSchema,
 };
 
 export const tool$eventsList: ToolDefinition<typeof args> = {
   name: "events-list",
   description: `List Events
 
-Retrieves a list of events for the tenant, supporting cursor navigation (details TBD) and filtering.`,
+Retrieves a list of events.
+
+When authenticated with a Tenant JWT, returns only events belonging to that tenant.
+When authenticated with Admin API Key, returns events across all tenants. Use \`tenant_id\` query parameter to filter by tenant.
+`,
   args,
   tool: async (client, args, ctx) => {
     const [result, apiCall] = await eventsList(