@zavudev/sdk-mcp 0.14.0

package/src/tools/broadcasts/cancel-broadcasts.ts

@@ -0,0 +1,52 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/broadcasts/{broadcastId}/cancel',
+  operationId: 'cancelBroadcast',
+};
+
+export const tool: Tool = {
+  name: 'cancel_broadcasts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCancel a broadcast. Pending contacts will be skipped, but already queued messages may still be delivered.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/broadcast_cancel_response',\n  $defs: {\n    broadcast_cancel_response: {\n      type: 'object',\n      properties: {\n        broadcast: {\n          $ref: '#/$defs/broadcast'\n        }\n      },\n      required: [        'broadcast'\n      ]\n    },\n    broadcast: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/broadcast_channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/broadcast_message_type'\n        },\n        name: {\n          type: 'string'\n        },\n        status: {\n          $ref: '#/$defs/broadcast_status'\n        },\n        totalContacts: {\n          type: 'integer',\n          description: 'Total number of contacts in the broadcast.'\n        },\n        actualCost: {\n          type: 'number',\n          description: 'Actual cost so far in USD.'\n        },\n        completedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        content: {\n          $ref: '#/$defs/broadcast_content'\n        },\n        deliveredCount: {\n          type: 'integer'\n        },\n        emailSubject: {\n          type: 'string'\n        },\n        estimatedCost: {\n          type: 'number',\n          description: 'Estimated total cost in USD.'\n        },\n        failedCount: {\n          type: 'integer'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        pendingCount: {\n          type: 'integer'\n        },\n        reservedAmount: {\n          type: 'number',\n          description: 'Amount reserved from balance in USD.'\n        },\n        scheduledAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        senderId: {\n          type: 'string'\n        },\n        sendingCount: {\n          type: 'integer'\n        },\n        startedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        text: {\n          type: 'string'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'name',\n        'status',\n        'totalContacts'\n      ]\n    },\n    broadcast_channel: {\n      type: 'string',\n      description: 'Broadcast delivery channel.',\n      enum: [        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    broadcast_message_type: {\n      type: 'string',\n      description: 'Type of message for broadcast.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'template'\n      ]\n    },\n    broadcast_status: {\n      type: 'string',\n      description: 'Current status of the broadcast.',\n      enum: [        'draft',\n        'scheduled',\n        'sending',\n        'paused',\n        'completed',\n        'cancelled',\n        'failed'\n      ]\n    },\n    broadcast_content: {\n      type: 'object',\n      description: 'Content for non-text broadcast message types.',\n      properties: {\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'Media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file.'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Default template variables (can be overridden per contact).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['broadcastId'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { broadcastId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.broadcasts.cancel(broadcastId)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/contacts/add-broadcasts-contacts.ts

@@ -0,0 +1,73 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts.contacts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/broadcasts/{broadcastId}/contacts',
+  operationId: 'addBroadcastContacts',
+};
+
+export const tool: Tool = {
+  name: 'add_broadcasts_contacts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nAdd contacts to a broadcast in batch. Maximum 1000 contacts per request.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contact_add_response',\n  $defs: {\n    contact_add_response: {\n      type: 'object',\n      properties: {\n        added: {\n          type: 'integer',\n          description: 'Number of contacts successfully added.'\n        },\n        duplicates: {\n          type: 'integer',\n          description: 'Number of duplicate contacts skipped.'\n        },\n        invalid: {\n          type: 'integer',\n          description: 'Number of invalid contacts rejected.'\n        },\n        errors: {\n          type: 'array',\n          description: 'Details about invalid contacts.',\n          items: {\n            type: 'object',\n            properties: {\n              reason: {\n                type: 'string'\n              },\n              recipient: {\n                type: 'string'\n              }\n            }\n          }\n        }\n      },\n      required: [        'added',\n        'duplicates',\n        'invalid'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+      contacts: {
+        type: 'array',
+        description: 'List of contacts to add (max 1000 per request).',
+        items: {
+          type: 'object',
+          properties: {
+            recipient: {
+              type: 'string',
+              description: 'Phone number (E.164) or email address.',
+            },
+            templateVariables: {
+              type: 'object',
+              description: 'Per-contact template variables to personalize the message.',
+              additionalProperties: true,
+            },
+          },
+          required: ['recipient'],
+        },
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['broadcastId', 'contacts'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { broadcastId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(
+      await maybeFilter(jq_filter, await client.broadcasts.contacts.add(broadcastId, body)),
+    );
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/contacts/list-broadcasts-contacts.ts

@@ -0,0 +1,71 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts.contacts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/broadcasts/{broadcastId}/contacts',
+  operationId: 'listBroadcastContacts',
+};
+
+export const tool: Tool = {
+  name: 'list_broadcasts_contacts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nList contacts in a broadcast with optional status filter.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/broadcast_contact'\n      }\n    },\n    nextCursor: {\n      type: 'string'\n    }\n  },\n  required: [    'items'\n  ],\n  $defs: {\n    broadcast_contact: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        recipient: {\n          type: 'string'\n        },\n        recipientType: {\n          type: 'string',\n          enum: [            'phone',\n            'email'\n          ]\n        },\n        status: {\n          $ref: '#/$defs/broadcast_contact_status'\n        },\n        cost: {\n          type: 'number'\n        },\n        errorCode: {\n          type: 'string'\n        },\n        errorMessage: {\n          type: 'string'\n        },\n        messageId: {\n          type: 'string',\n          description: 'Associated message ID after processing.'\n        },\n        processedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        templateVariables: {\n          type: 'object',\n          additionalProperties: true\n        }\n      },\n      required: [        'id',\n        'createdAt',\n        'recipient',\n        'recipientType',\n        'status'\n      ]\n    },\n    broadcast_contact_status: {\n      type: 'string',\n      description: 'Status of a contact within a broadcast.',\n      enum: [        'pending',\n        'queued',\n        'sending',\n        'delivered',\n        'failed',\n        'skipped'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+      cursor: {
+        type: 'string',
+      },
+      limit: {
+        type: 'integer',
+      },
+      status: {
+        $ref: '#/$defs/broadcast_contact_status',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['broadcastId'],
+    $defs: {
+      broadcast_contact_status: {
+        type: 'string',
+        description: 'Status of a contact within a broadcast.',
+        enum: ['pending', 'queued', 'sending', 'delivered', 'failed', 'skipped'],
+      },
+    },
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { broadcastId, jq_filter, ...body } = args as any;
+  const response = await client.broadcasts.contacts.list(broadcastId, body).asResponse();
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/contacts/remove-broadcasts-contacts.ts

@@ -0,0 +1,43 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts.contacts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/v1/broadcasts/{broadcastId}/contacts/{contactId}',
+  operationId: 'removeBroadcastContact',
+};
+
+export const tool: Tool = {
+  name: 'remove_broadcasts_contacts',
+  description: 'Remove a contact from a broadcast in draft status.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+      contactId: {
+        type: 'string',
+      },
+    },
+    required: ['broadcastId', 'contactId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { contactId, ...body } = args as any;
+  const response = await client.broadcasts.contacts.remove(contactId, body).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/create-broadcasts.ts

@@ -0,0 +1,134 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/broadcasts',
+  operationId: 'createBroadcast',
+};
+
+export const tool: Tool = {
+  name: 'create_broadcasts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nCreate a new broadcast campaign. Add contacts after creation, then send.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/broadcast_create_response',\n  $defs: {\n    broadcast_create_response: {\n      type: 'object',\n      properties: {\n        broadcast: {\n          $ref: '#/$defs/broadcast'\n        }\n      },\n      required: [        'broadcast'\n      ]\n    },\n    broadcast: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/broadcast_channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/broadcast_message_type'\n        },\n        name: {\n          type: 'string'\n        },\n        status: {\n          $ref: '#/$defs/broadcast_status'\n        },\n        totalContacts: {\n          type: 'integer',\n          description: 'Total number of contacts in the broadcast.'\n        },\n        actualCost: {\n          type: 'number',\n          description: 'Actual cost so far in USD.'\n        },\n        completedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        content: {\n          $ref: '#/$defs/broadcast_content'\n        },\n        deliveredCount: {\n          type: 'integer'\n        },\n        emailSubject: {\n          type: 'string'\n        },\n        estimatedCost: {\n          type: 'number',\n          description: 'Estimated total cost in USD.'\n        },\n        failedCount: {\n          type: 'integer'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        pendingCount: {\n          type: 'integer'\n        },\n        reservedAmount: {\n          type: 'number',\n          description: 'Amount reserved from balance in USD.'\n        },\n        scheduledAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        senderId: {\n          type: 'string'\n        },\n        sendingCount: {\n          type: 'integer'\n        },\n        startedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        text: {\n          type: 'string'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'name',\n        'status',\n        'totalContacts'\n      ]\n    },\n    broadcast_channel: {\n      type: 'string',\n      description: 'Broadcast delivery channel.',\n      enum: [        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    broadcast_message_type: {\n      type: 'string',\n      description: 'Type of message for broadcast.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'template'\n      ]\n    },\n    broadcast_status: {\n      type: 'string',\n      description: 'Current status of the broadcast.',\n      enum: [        'draft',\n        'scheduled',\n        'sending',\n        'paused',\n        'completed',\n        'cancelled',\n        'failed'\n      ]\n    },\n    broadcast_content: {\n      type: 'object',\n      description: 'Content for non-text broadcast message types.',\n      properties: {\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'Media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file.'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Default template variables (can be overridden per contact).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      channel: {
+        $ref: '#/$defs/broadcast_channel',
+      },
+      name: {
+        type: 'string',
+        description: 'Name of the broadcast campaign.',
+      },
+      content: {
+        $ref: '#/$defs/broadcast_content',
+      },
+      emailHtmlBody: {
+        type: 'string',
+        description: 'HTML body for email broadcasts.',
+      },
+      emailSubject: {
+        type: 'string',
+        description: 'Email subject line. Required for email broadcasts.',
+      },
+      idempotencyKey: {
+        type: 'string',
+        description: 'Idempotency key to prevent duplicate broadcasts.',
+      },
+      messageType: {
+        $ref: '#/$defs/broadcast_message_type',
+      },
+      metadata: {
+        type: 'object',
+        additionalProperties: true,
+      },
+      scheduledAt: {
+        type: 'string',
+        description: 'Schedule the broadcast for future delivery.',
+        format: 'date-time',
+      },
+      senderId: {
+        type: 'string',
+        description: 'Sender profile ID. Uses default sender if omitted.',
+      },
+      text: {
+        type: 'string',
+        description: 'Text content or caption. Supports template variables: {{name}}, {{1}}, etc.',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['channel', 'name'],
+    $defs: {
+      broadcast_channel: {
+        type: 'string',
+        description: 'Broadcast delivery channel.',
+        enum: ['sms', 'whatsapp', 'email'],
+      },
+      broadcast_content: {
+        type: 'object',
+        description: 'Content for non-text broadcast message types.',
+        properties: {
+          filename: {
+            type: 'string',
+            description: 'Filename for documents.',
+          },
+          mediaId: {
+            type: 'string',
+            description: 'Media ID if already uploaded.',
+          },
+          mediaUrl: {
+            type: 'string',
+            description: 'URL of the media file.',
+          },
+          mimeType: {
+            type: 'string',
+            description: 'MIME type of the media.',
+          },
+          templateId: {
+            type: 'string',
+            description: 'Template ID for template messages.',
+          },
+          templateVariables: {
+            type: 'object',
+            description: 'Default template variables (can be overridden per contact).',
+            additionalProperties: true,
+          },
+        },
+      },
+      broadcast_message_type: {
+        type: 'string',
+        description: 'Type of message for broadcast.',
+        enum: ['text', 'image', 'video', 'audio', 'document', 'template'],
+      },
+    },
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.broadcasts.create(body)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/delete-broadcasts.ts

@@ -0,0 +1,40 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/v1/broadcasts/{broadcastId}',
+  operationId: 'deleteBroadcast',
+};
+
+export const tool: Tool = {
+  name: 'delete_broadcasts',
+  description: 'Delete a broadcast in draft status.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+    },
+    required: ['broadcastId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { broadcastId, ...body } = args as any;
+  const response = await client.broadcasts.delete(broadcastId).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/list-broadcasts.ts

@@ -0,0 +1,68 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/broadcasts',
+  operationId: 'listBroadcasts',
+};
+
+export const tool: Tool = {
+  name: 'list_broadcasts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nList broadcasts for this project.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/broadcast'\n      }\n    },\n    nextCursor: {\n      type: 'string'\n    }\n  },\n  required: [    'items'\n  ],\n  $defs: {\n    broadcast: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/broadcast_channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/broadcast_message_type'\n        },\n        name: {\n          type: 'string'\n        },\n        status: {\n          $ref: '#/$defs/broadcast_status'\n        },\n        totalContacts: {\n          type: 'integer',\n          description: 'Total number of contacts in the broadcast.'\n        },\n        actualCost: {\n          type: 'number',\n          description: 'Actual cost so far in USD.'\n        },\n        completedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        content: {\n          $ref: '#/$defs/broadcast_content'\n        },\n        deliveredCount: {\n          type: 'integer'\n        },\n        emailSubject: {\n          type: 'string'\n        },\n        estimatedCost: {\n          type: 'number',\n          description: 'Estimated total cost in USD.'\n        },\n        failedCount: {\n          type: 'integer'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        pendingCount: {\n          type: 'integer'\n        },\n        reservedAmount: {\n          type: 'number',\n          description: 'Amount reserved from balance in USD.'\n        },\n        scheduledAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        senderId: {\n          type: 'string'\n        },\n        sendingCount: {\n          type: 'integer'\n        },\n        startedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        text: {\n          type: 'string'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'name',\n        'status',\n        'totalContacts'\n      ]\n    },\n    broadcast_channel: {\n      type: 'string',\n      description: 'Broadcast delivery channel.',\n      enum: [        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    broadcast_message_type: {\n      type: 'string',\n      description: 'Type of message for broadcast.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'template'\n      ]\n    },\n    broadcast_status: {\n      type: 'string',\n      description: 'Current status of the broadcast.',\n      enum: [        'draft',\n        'scheduled',\n        'sending',\n        'paused',\n        'completed',\n        'cancelled',\n        'failed'\n      ]\n    },\n    broadcast_content: {\n      type: 'object',\n      description: 'Content for non-text broadcast message types.',\n      properties: {\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'Media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file.'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Default template variables (can be overridden per contact).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      cursor: {
+        type: 'string',
+      },
+      limit: {
+        type: 'integer',
+      },
+      status: {
+        $ref: '#/$defs/broadcast_status',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: [],
+    $defs: {
+      broadcast_status: {
+        type: 'string',
+        description: 'Current status of the broadcast.',
+        enum: ['draft', 'scheduled', 'sending', 'paused', 'completed', 'cancelled', 'failed'],
+      },
+    },
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { jq_filter, ...body } = args as any;
+  const response = await client.broadcasts.list(body).asResponse();
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await response.json()));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/progress-broadcasts.ts

@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/broadcasts/{broadcastId}/progress',
+  operationId: 'getBroadcastProgress',
+};
+
+export const tool: Tool = {
+  name: 'progress_broadcasts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet real-time progress of a broadcast including delivery counts and estimated completion time.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/broadcast_progress',\n  $defs: {\n    broadcast_progress: {\n      type: 'object',\n      properties: {\n        broadcastId: {\n          type: 'string'\n        },\n        delivered: {\n          type: 'integer',\n          description: 'Successfully delivered.'\n        },\n        failed: {\n          type: 'integer',\n          description: 'Failed to deliver.'\n        },\n        pending: {\n          type: 'integer',\n          description: 'Not yet queued for sending.'\n        },\n        percentComplete: {\n          type: 'number',\n          description: 'Percentage complete (0-100).'\n        },\n        sending: {\n          type: 'integer',\n          description: 'Currently being sent.'\n        },\n        skipped: {\n          type: 'integer',\n          description: 'Skipped (broadcast cancelled).'\n        },\n        status: {\n          $ref: '#/$defs/broadcast_status'\n        },\n        total: {\n          type: 'integer',\n          description: 'Total contacts in broadcast.'\n        },\n        actualCost: {\n          type: 'number',\n          description: 'Actual cost so far in USD.'\n        },\n        estimatedCompletionAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        estimatedCost: {\n          type: 'number',\n          description: 'Estimated total cost in USD.'\n        },\n        reservedAmount: {\n          type: 'number',\n          description: 'Amount reserved from balance in USD.'\n        },\n        startedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'broadcastId',\n        'delivered',\n        'failed',\n        'pending',\n        'percentComplete',\n        'sending',\n        'skipped',\n        'status',\n        'total'\n      ]\n    },\n    broadcast_status: {\n      type: 'string',\n      description: 'Current status of the broadcast.',\n      enum: [        'draft',\n        'scheduled',\n        'sending',\n        'paused',\n        'completed',\n        'cancelled',\n        'failed'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['broadcastId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { broadcastId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.broadcasts.progress(broadcastId)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/broadcasts/retrieve-broadcasts.ts

@@ -0,0 +1,54 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { isJqError, maybeFilter } from '@zavudev/sdk-mcp/filtering';
+import { Metadata, asErrorResult, asTextContentResult } from '@zavudev/sdk-mcp/tools/types';
+
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+import Zavudev from '@zavudev/sdk';
+
+export const metadata: Metadata = {
+  resource: 'broadcasts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/broadcasts/{broadcastId}',
+  operationId: 'getBroadcast',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_broadcasts',
+  description:
+    "When using this tool, always use the `jq_filter` parameter to reduce the response size and improve performance.\n\nOnly omit if you're sure you don't need the data.\n\nGet broadcast\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/broadcast_retrieve_response',\n  $defs: {\n    broadcast_retrieve_response: {\n      type: 'object',\n      properties: {\n        broadcast: {\n          $ref: '#/$defs/broadcast'\n        }\n      },\n      required: [        'broadcast'\n      ]\n    },\n    broadcast: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/broadcast_channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/broadcast_message_type'\n        },\n        name: {\n          type: 'string'\n        },\n        status: {\n          $ref: '#/$defs/broadcast_status'\n        },\n        totalContacts: {\n          type: 'integer',\n          description: 'Total number of contacts in the broadcast.'\n        },\n        actualCost: {\n          type: 'number',\n          description: 'Actual cost so far in USD.'\n        },\n        completedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        content: {\n          $ref: '#/$defs/broadcast_content'\n        },\n        deliveredCount: {\n          type: 'integer'\n        },\n        emailSubject: {\n          type: 'string'\n        },\n        estimatedCost: {\n          type: 'number',\n          description: 'Estimated total cost in USD.'\n        },\n        failedCount: {\n          type: 'integer'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        pendingCount: {\n          type: 'integer'\n        },\n        reservedAmount: {\n          type: 'number',\n          description: 'Amount reserved from balance in USD.'\n        },\n        scheduledAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        senderId: {\n          type: 'string'\n        },\n        sendingCount: {\n          type: 'integer'\n        },\n        startedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        text: {\n          type: 'string'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'name',\n        'status',\n        'totalContacts'\n      ]\n    },\n    broadcast_channel: {\n      type: 'string',\n      description: 'Broadcast delivery channel.',\n      enum: [        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    broadcast_message_type: {\n      type: 'string',\n      description: 'Type of message for broadcast.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'template'\n      ]\n    },\n    broadcast_status: {\n      type: 'string',\n      description: 'Current status of the broadcast.',\n      enum: [        'draft',\n        'scheduled',\n        'sending',\n        'paused',\n        'completed',\n        'cancelled',\n        'failed'\n      ]\n    },\n    broadcast_content: {\n      type: 'object',\n      description: 'Content for non-text broadcast message types.',\n      properties: {\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'Media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file.'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Default template variables (can be overridden per contact).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      broadcastId: {
+        type: 'string',
+      },
+      jq_filter: {
+        type: 'string',
+        title: 'jq Filter',
+        description:
+          'A jq filter to apply to the response to include certain fields. Consult the output schema in the tool description to see the fields that are available.\n\nFor example: to include only the `name` field in every object of a results array, you can provide ".results[].name".\n\nFor more information, see the [jq documentation](https://jqlang.org/manual/).',
+      },
+    },
+    required: ['broadcastId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { broadcastId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.broadcasts.retrieve(broadcastId)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };