@zavudev/sdk-mcp 0.14.0

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

@@ -0,0 +1,78 @@
+// 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: 'messages',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/messages',
+  operationId: 'listMessages',
+};
+
+export const tool: Tool = {
+  name: 'list_messages',
+  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 messages previously sent by this project.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/message'\n      }\n    },\n    nextCursor: {\n      type: 'string'\n    }\n  },\n  required: [    'items'\n  ],\n  $defs: {\n    message: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/message_type'\n        },\n        status: {\n          $ref: '#/$defs/message_status'\n        },\n        to: {\n          type: 'string'\n        },\n        content: {\n          $ref: '#/$defs/message_content'\n        },\n        cost: {\n          type: 'number',\n          description: 'MAU cost in USD (charged for first contact of the month).'\n        },\n        costProvider: {\n          type: 'number',\n          description: 'Provider cost in USD (Telnyx, SES, etc.).'\n        },\n        costTotal: {\n          type: 'number',\n          description: 'Total cost in USD (MAU + provider cost).'\n        },\n        errorCode: {\n          type: 'string'\n        },\n        errorMessage: {\n          type: 'string'\n        },\n        from: {\n          type: 'string'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        providerMessageId: {\n          type: 'string',\n          description: 'Message ID from the delivery provider.'\n        },\n        senderId: {\n          type: 'string'\n        },\n        text: {\n          type: 'string',\n          description: 'Text content or caption.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'status',\n        'to'\n      ]\n    },\n    channel: {\n      type: 'string',\n      description: 'Delivery channel. Use \\'auto\\' for intelligent routing.',\n      enum: [        'auto',\n        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    message_type: {\n      type: 'string',\n      description: 'Type of message. Non-text types are WhatsApp only.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'sticker',\n        'location',\n        'contact',\n        'buttons',\n        'list',\n        'reaction',\n        'template'\n      ]\n    },\n    message_status: {\n      type: 'string',\n      enum: [        'queued',\n        'sending',\n        'delivered',\n        'failed',\n        'received'\n      ]\n    },\n    message_content: {\n      type: 'object',\n      description: 'Content for non-text message types (WhatsApp only).',\n      properties: {\n        buttons: {\n          type: 'array',\n          description: 'Interactive buttons (max 3).',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              title: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'title'\n            ]\n          }\n        },\n        contacts: {\n          type: 'array',\n          description: 'Contact cards for contact messages.',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string'\n              },\n              phones: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              }\n            }\n          }\n        },\n        emoji: {\n          type: 'string',\n          description: 'Emoji for reaction messages.'\n        },\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        latitude: {\n          type: 'number',\n          description: 'Latitude for location messages.'\n        },\n        listButton: {\n          type: 'string',\n          description: 'Button text for list messages.'\n        },\n        locationAddress: {\n          type: 'string',\n          description: 'Address of the location.'\n        },\n        locationName: {\n          type: 'string',\n          description: 'Name of the location.'\n        },\n        longitude: {\n          type: 'number',\n          description: 'Longitude for location messages.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'WhatsApp media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file (for image, video, audio, document, sticker).'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        reactToMessageId: {\n          type: 'string',\n          description: 'Message ID to react to.'\n        },\n        sections: {\n          type: 'array',\n          description: 'Sections for list messages.',\n          items: {\n            type: 'object',\n            properties: {\n              rows: {\n                type: 'array',\n                items: {\n                  type: 'object',\n                  properties: {\n                    id: {\n                      type: 'string'\n                    },\n                    title: {\n                      type: 'string'\n                    },\n                    description: {\n                      type: 'string'\n                    }\n                  },\n                  required: [                    'id',\n                    'title'\n                  ]\n                }\n              },\n              title: {\n                type: 'string'\n              }\n            },\n            required: [              'rows',\n              'title'\n            ]\n          }\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Variables for template rendering. Keys are variable positions (1, 2, 3...).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      channel: {
+        $ref: '#/$defs/channel',
+      },
+      cursor: {
+        type: 'string',
+      },
+      limit: {
+        type: 'integer',
+      },
+      status: {
+        $ref: '#/$defs/message_status',
+      },
+      to: {
+        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: [],
+    $defs: {
+      channel: {
+        type: 'string',
+        description: "Delivery channel. Use 'auto' for intelligent routing.",
+        enum: ['auto', 'sms', 'whatsapp', 'email'],
+      },
+      message_status: {
+        type: 'string',
+        enum: ['queued', 'sending', 'delivered', 'failed', 'received'],
+      },
+    },
+  },
+  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.messages.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/messages/react-messages.ts

@@ -0,0 +1,59 @@
+// 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: 'messages',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/messages/{messageId}/reactions',
+  operationId: 'sendReaction',
+};
+
+export const tool: Tool = {
+  name: 'react_messages',
+  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\nSend an emoji reaction to an existing WhatsApp message. Reactions are only supported for WhatsApp messages.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/message_response',\n  $defs: {\n    message_response: {\n      type: 'object',\n      properties: {\n        message: {\n          $ref: '#/$defs/message'\n        }\n      },\n      required: [        'message'\n      ]\n    },\n    message: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/message_type'\n        },\n        status: {\n          $ref: '#/$defs/message_status'\n        },\n        to: {\n          type: 'string'\n        },\n        content: {\n          $ref: '#/$defs/message_content'\n        },\n        cost: {\n          type: 'number',\n          description: 'MAU cost in USD (charged for first contact of the month).'\n        },\n        costProvider: {\n          type: 'number',\n          description: 'Provider cost in USD (Telnyx, SES, etc.).'\n        },\n        costTotal: {\n          type: 'number',\n          description: 'Total cost in USD (MAU + provider cost).'\n        },\n        errorCode: {\n          type: 'string'\n        },\n        errorMessage: {\n          type: 'string'\n        },\n        from: {\n          type: 'string'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        providerMessageId: {\n          type: 'string',\n          description: 'Message ID from the delivery provider.'\n        },\n        senderId: {\n          type: 'string'\n        },\n        text: {\n          type: 'string',\n          description: 'Text content or caption.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'status',\n        'to'\n      ]\n    },\n    channel: {\n      type: 'string',\n      description: 'Delivery channel. Use \\'auto\\' for intelligent routing.',\n      enum: [        'auto',\n        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    message_type: {\n      type: 'string',\n      description: 'Type of message. Non-text types are WhatsApp only.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'sticker',\n        'location',\n        'contact',\n        'buttons',\n        'list',\n        'reaction',\n        'template'\n      ]\n    },\n    message_status: {\n      type: 'string',\n      enum: [        'queued',\n        'sending',\n        'delivered',\n        'failed',\n        'received'\n      ]\n    },\n    message_content: {\n      type: 'object',\n      description: 'Content for non-text message types (WhatsApp only).',\n      properties: {\n        buttons: {\n          type: 'array',\n          description: 'Interactive buttons (max 3).',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              title: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'title'\n            ]\n          }\n        },\n        contacts: {\n          type: 'array',\n          description: 'Contact cards for contact messages.',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string'\n              },\n              phones: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              }\n            }\n          }\n        },\n        emoji: {\n          type: 'string',\n          description: 'Emoji for reaction messages.'\n        },\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        latitude: {\n          type: 'number',\n          description: 'Latitude for location messages.'\n        },\n        listButton: {\n          type: 'string',\n          description: 'Button text for list messages.'\n        },\n        locationAddress: {\n          type: 'string',\n          description: 'Address of the location.'\n        },\n        locationName: {\n          type: 'string',\n          description: 'Name of the location.'\n        },\n        longitude: {\n          type: 'number',\n          description: 'Longitude for location messages.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'WhatsApp media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file (for image, video, audio, document, sticker).'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        reactToMessageId: {\n          type: 'string',\n          description: 'Message ID to react to.'\n        },\n        sections: {\n          type: 'array',\n          description: 'Sections for list messages.',\n          items: {\n            type: 'object',\n            properties: {\n              rows: {\n                type: 'array',\n                items: {\n                  type: 'object',\n                  properties: {\n                    id: {\n                      type: 'string'\n                    },\n                    title: {\n                      type: 'string'\n                    },\n                    description: {\n                      type: 'string'\n                    }\n                  },\n                  required: [                    'id',\n                    'title'\n                  ]\n                }\n              },\n              title: {\n                type: 'string'\n              }\n            },\n            required: [              'rows',\n              'title'\n            ]\n          }\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Variables for template rendering. Keys are variable positions (1, 2, 3...).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      messageId: {
+        type: 'string',
+      },
+      emoji: {
+        type: 'string',
+        description: 'Single emoji character to react with.',
+      },
+      'Zavu-Sender': {
+        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: ['messageId', 'emoji'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { messageId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.messages.react(messageId, body)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/messages/retrieve-messages.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: 'messages',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/messages/{messageId}',
+  operationId: 'getMessage',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_messages',
+  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 message by ID\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/message_response',\n  $defs: {\n    message_response: {\n      type: 'object',\n      properties: {\n        message: {\n          $ref: '#/$defs/message'\n        }\n      },\n      required: [        'message'\n      ]\n    },\n    message: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        channel: {\n          $ref: '#/$defs/channel'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        messageType: {\n          $ref: '#/$defs/message_type'\n        },\n        status: {\n          $ref: '#/$defs/message_status'\n        },\n        to: {\n          type: 'string'\n        },\n        content: {\n          $ref: '#/$defs/message_content'\n        },\n        cost: {\n          type: 'number',\n          description: 'MAU cost in USD (charged for first contact of the month).'\n        },\n        costProvider: {\n          type: 'number',\n          description: 'Provider cost in USD (Telnyx, SES, etc.).'\n        },\n        costTotal: {\n          type: 'number',\n          description: 'Total cost in USD (MAU + provider cost).'\n        },\n        errorCode: {\n          type: 'string'\n        },\n        errorMessage: {\n          type: 'string'\n        },\n        from: {\n          type: 'string'\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        providerMessageId: {\n          type: 'string',\n          description: 'Message ID from the delivery provider.'\n        },\n        senderId: {\n          type: 'string'\n        },\n        text: {\n          type: 'string',\n          description: 'Text content or caption.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'channel',\n        'createdAt',\n        'messageType',\n        'status',\n        'to'\n      ]\n    },\n    channel: {\n      type: 'string',\n      description: 'Delivery channel. Use \\'auto\\' for intelligent routing.',\n      enum: [        'auto',\n        'sms',\n        'whatsapp',\n        'email'\n      ]\n    },\n    message_type: {\n      type: 'string',\n      description: 'Type of message. Non-text types are WhatsApp only.',\n      enum: [        'text',\n        'image',\n        'video',\n        'audio',\n        'document',\n        'sticker',\n        'location',\n        'contact',\n        'buttons',\n        'list',\n        'reaction',\n        'template'\n      ]\n    },\n    message_status: {\n      type: 'string',\n      enum: [        'queued',\n        'sending',\n        'delivered',\n        'failed',\n        'received'\n      ]\n    },\n    message_content: {\n      type: 'object',\n      description: 'Content for non-text message types (WhatsApp only).',\n      properties: {\n        buttons: {\n          type: 'array',\n          description: 'Interactive buttons (max 3).',\n          items: {\n            type: 'object',\n            properties: {\n              id: {\n                type: 'string'\n              },\n              title: {\n                type: 'string'\n              }\n            },\n            required: [              'id',\n              'title'\n            ]\n          }\n        },\n        contacts: {\n          type: 'array',\n          description: 'Contact cards for contact messages.',\n          items: {\n            type: 'object',\n            properties: {\n              name: {\n                type: 'string'\n              },\n              phones: {\n                type: 'array',\n                items: {\n                  type: 'string'\n                }\n              }\n            }\n          }\n        },\n        emoji: {\n          type: 'string',\n          description: 'Emoji for reaction messages.'\n        },\n        filename: {\n          type: 'string',\n          description: 'Filename for documents.'\n        },\n        latitude: {\n          type: 'number',\n          description: 'Latitude for location messages.'\n        },\n        listButton: {\n          type: 'string',\n          description: 'Button text for list messages.'\n        },\n        locationAddress: {\n          type: 'string',\n          description: 'Address of the location.'\n        },\n        locationName: {\n          type: 'string',\n          description: 'Name of the location.'\n        },\n        longitude: {\n          type: 'number',\n          description: 'Longitude for location messages.'\n        },\n        mediaId: {\n          type: 'string',\n          description: 'WhatsApp media ID if already uploaded.'\n        },\n        mediaUrl: {\n          type: 'string',\n          description: 'URL of the media file (for image, video, audio, document, sticker).'\n        },\n        mimeType: {\n          type: 'string',\n          description: 'MIME type of the media.'\n        },\n        reactToMessageId: {\n          type: 'string',\n          description: 'Message ID to react to.'\n        },\n        sections: {\n          type: 'array',\n          description: 'Sections for list messages.',\n          items: {\n            type: 'object',\n            properties: {\n              rows: {\n                type: 'array',\n                items: {\n                  type: 'object',\n                  properties: {\n                    id: {\n                      type: 'string'\n                    },\n                    title: {\n                      type: 'string'\n                    },\n                    description: {\n                      type: 'string'\n                    }\n                  },\n                  required: [                    'id',\n                    'title'\n                  ]\n                }\n              },\n              title: {\n                type: 'string'\n              }\n            },\n            required: [              'rows',\n              'title'\n            ]\n          }\n        },\n        templateId: {\n          type: 'string',\n          description: 'Template ID for template messages.'\n        },\n        templateVariables: {\n          type: 'object',\n          description: 'Variables for template rendering. Keys are variable positions (1, 2, 3...).',\n          additionalProperties: true\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      messageId: {
+        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: ['messageId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { messageId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.messages.retrieve(messageId)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/messages/send-messages.ts

@@ -0,0 +1,233 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+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: 'messages',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/messages',
+  operationId: 'sendMessage',
+};
+
+export const tool: Tool = {
+  name: 'send_messages',
+  description:
+    'Send a message to a recipient via SMS or WhatsApp.\n\n**Channel selection:**\n- If `channel` is omitted and `messageType` is `text`, defaults to SMS\n- If `messageType` is anything other than `text`, WhatsApp is used automatically\n\n**WhatsApp 24-hour window:**\n- Free-form messages (non-template) require an open 24h window\n- Window opens when the user messages you first\n- Use template messages to initiate conversations outside the window',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      to: {
+        type: 'string',
+        description: 'Recipient phone number in E.164 format or email address.',
+      },
+      channel: {
+        $ref: '#/$defs/channel',
+      },
+      content: {
+        $ref: '#/$defs/message_content',
+      },
+      htmlBody: {
+        type: 'string',
+        description:
+          'HTML body for email messages. If provided, email will be sent as multipart with both text and HTML.',
+      },
+      idempotencyKey: {
+        type: 'string',
+        description: 'Optional idempotency key to avoid duplicate sends.',
+      },
+      messageType: {
+        $ref: '#/$defs/message_type',
+      },
+      metadata: {
+        type: 'object',
+        description: 'Arbitrary metadata to associate with the message.',
+        additionalProperties: true,
+      },
+      replyTo: {
+        type: 'string',
+        description: 'Reply-To email address for email messages.',
+      },
+      subject: {
+        type: 'string',
+        description: "Email subject line. Required when channel is 'email' or recipient is an email address.",
+      },
+      text: {
+        type: 'string',
+        description: 'Text body for text messages or caption for media messages.',
+      },
+      'Zavu-Sender': {
+        type: 'string',
+      },
+    },
+    required: ['to'],
+    $defs: {
+      channel: {
+        type: 'string',
+        description: "Delivery channel. Use 'auto' for intelligent routing.",
+        enum: ['auto', 'sms', 'whatsapp', 'email'],
+      },
+      message_content: {
+        type: 'object',
+        description: 'Content for non-text message types (WhatsApp only).',
+        properties: {
+          buttons: {
+            type: 'array',
+            description: 'Interactive buttons (max 3).',
+            items: {
+              type: 'object',
+              properties: {
+                id: {
+                  type: 'string',
+                },
+                title: {
+                  type: 'string',
+                },
+              },
+              required: ['id', 'title'],
+            },
+          },
+          contacts: {
+            type: 'array',
+            description: 'Contact cards for contact messages.',
+            items: {
+              type: 'object',
+              properties: {
+                name: {
+                  type: 'string',
+                },
+                phones: {
+                  type: 'array',
+                  items: {
+                    type: 'string',
+                  },
+                },
+              },
+            },
+          },
+          emoji: {
+            type: 'string',
+            description: 'Emoji for reaction messages.',
+          },
+          filename: {
+            type: 'string',
+            description: 'Filename for documents.',
+          },
+          latitude: {
+            type: 'number',
+            description: 'Latitude for location messages.',
+          },
+          listButton: {
+            type: 'string',
+            description: 'Button text for list messages.',
+          },
+          locationAddress: {
+            type: 'string',
+            description: 'Address of the location.',
+          },
+          locationName: {
+            type: 'string',
+            description: 'Name of the location.',
+          },
+          longitude: {
+            type: 'number',
+            description: 'Longitude for location messages.',
+          },
+          mediaId: {
+            type: 'string',
+            description: 'WhatsApp media ID if already uploaded.',
+          },
+          mediaUrl: {
+            type: 'string',
+            description: 'URL of the media file (for image, video, audio, document, sticker).',
+          },
+          mimeType: {
+            type: 'string',
+            description: 'MIME type of the media.',
+          },
+          reactToMessageId: {
+            type: 'string',
+            description: 'Message ID to react to.',
+          },
+          sections: {
+            type: 'array',
+            description: 'Sections for list messages.',
+            items: {
+              type: 'object',
+              properties: {
+                rows: {
+                  type: 'array',
+                  items: {
+                    type: 'object',
+                    properties: {
+                      id: {
+                        type: 'string',
+                      },
+                      title: {
+                        type: 'string',
+                      },
+                      description: {
+                        type: 'string',
+                      },
+                    },
+                    required: ['id', 'title'],
+                  },
+                },
+                title: {
+                  type: 'string',
+                },
+              },
+              required: ['rows', 'title'],
+            },
+          },
+          templateId: {
+            type: 'string',
+            description: 'Template ID for template messages.',
+          },
+          templateVariables: {
+            type: 'object',
+            description: 'Variables for template rendering. Keys are variable positions (1, 2, 3...).',
+            additionalProperties: true,
+          },
+        },
+      },
+      message_type: {
+        type: 'string',
+        description: 'Type of message. Non-text types are WhatsApp only.',
+        enum: [
+          'text',
+          'image',
+          'video',
+          'audio',
+          'document',
+          'sticker',
+          'location',
+          'contact',
+          'buttons',
+          'list',
+          'reaction',
+          'template',
+        ],
+      },
+    },
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const body = args as any;
+  try {
+    return asTextContentResult(await client.messages.send(body));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/phone-numbers/list-phone-numbers.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: 'phone_numbers',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/phone-numbers',
+  operationId: 'listPhoneNumbers',
+};
+
+export const tool: Tool = {
+  name: 'list_phone_numbers',
+  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 all phone numbers owned by this project.\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/owned_phone_number'\n      }\n    },\n    nextCursor: {\n      type: 'string'\n    }\n  },\n  required: [    'items'\n  ],\n  $defs: {\n    owned_phone_number: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        capabilities: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        phoneNumber: {\n          type: 'string'\n        },\n        pricing: {\n          $ref: '#/$defs/owned_phone_number_pricing'\n        },\n        status: {\n          $ref: '#/$defs/phone_number_status'\n        },\n        name: {\n          type: 'string',\n          description: 'Optional custom name for the phone number.'\n        },\n        nextRenewalDate: {\n          type: 'string',\n          format: 'date-time'\n        },\n        senderId: {\n          type: 'string',\n          description: 'Sender ID if the phone number is assigned to a sender.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'capabilities',\n        'createdAt',\n        'phoneNumber',\n        'pricing',\n        'status'\n      ]\n    },\n    owned_phone_number_pricing: {\n      type: 'object',\n      properties: {\n        isFreeNumber: {\n          type: 'boolean',\n          description: 'Whether this is a free number.'\n        },\n        monthlyCost: {\n          type: 'number',\n          description: 'Monthly cost in cents.'\n        },\n        monthlyPrice: {\n          type: 'number',\n          description: 'Monthly price in USD.'\n        },\n        upfrontCost: {\n          type: 'number',\n          description: 'One-time purchase cost in cents.'\n        }\n      }\n    },\n    phone_number_status: {\n      type: 'string',\n      enum: [        'active',\n        'suspended',\n        'pending'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      cursor: {
+        type: 'string',
+        description: 'Pagination cursor.',
+      },
+      limit: {
+        type: 'integer',
+      },
+      status: {
+        $ref: '#/$defs/phone_number_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: {
+      phone_number_status: {
+        type: 'string',
+        enum: ['active', 'suspended', 'pending'],
+      },
+    },
+  },
+  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.phoneNumbers.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/phone-numbers/purchase-phone-numbers.ts

@@ -0,0 +1,57 @@
+// 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: 'phone_numbers',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/phone-numbers',
+  operationId: 'purchasePhoneNumber',
+};
+
+export const tool: Tool = {
+  name: 'purchase_phone_numbers',
+  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\nPurchase an available phone number. The first US phone number is free for each team.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/phone_number_purchase_response',\n  $defs: {\n    phone_number_purchase_response: {\n      type: 'object',\n      properties: {\n        phoneNumber: {\n          $ref: '#/$defs/owned_phone_number'\n        }\n      },\n      required: [        'phoneNumber'\n      ]\n    },\n    owned_phone_number: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        capabilities: {\n          type: 'array',\n          items: {\n            type: 'string'\n          }\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        phoneNumber: {\n          type: 'string'\n        },\n        pricing: {\n          $ref: '#/$defs/owned_phone_number_pricing'\n        },\n        status: {\n          $ref: '#/$defs/phone_number_status'\n        },\n        name: {\n          type: 'string',\n          description: 'Optional custom name for the phone number.'\n        },\n        nextRenewalDate: {\n          type: 'string',\n          format: 'date-time'\n        },\n        senderId: {\n          type: 'string',\n          description: 'Sender ID if the phone number is assigned to a sender.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        }\n      },\n      required: [        'id',\n        'capabilities',\n        'createdAt',\n        'phoneNumber',\n        'pricing',\n        'status'\n      ]\n    },\n    owned_phone_number_pricing: {\n      type: 'object',\n      properties: {\n        isFreeNumber: {\n          type: 'boolean',\n          description: 'Whether this is a free number.'\n        },\n        monthlyCost: {\n          type: 'number',\n          description: 'Monthly cost in cents.'\n        },\n        monthlyPrice: {\n          type: 'number',\n          description: 'Monthly price in USD.'\n        },\n        upfrontCost: {\n          type: 'number',\n          description: 'One-time purchase cost in cents.'\n        }\n      }\n    },\n    phone_number_status: {\n      type: 'string',\n      enum: [        'active',\n        'suspended',\n        'pending'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      phoneNumber: {
+        type: 'string',
+        description: 'Phone number in E.164 format.',
+      },
+      name: {
+        type: 'string',
+        description: 'Optional custom name for the phone number.',
+      },
+      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: ['phoneNumber'],
+  },
+  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.phoneNumbers.purchase(body)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/phone-numbers/release-phone-numbers.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: 'phone_numbers',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/v1/phone-numbers/{phoneNumberId}',
+  operationId: 'releasePhoneNumber',
+};
+
+export const tool: Tool = {
+  name: 'release_phone_numbers',
+  description: 'Release a phone number. The phone number must not be assigned to a sender.',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      phoneNumberId: {
+        type: 'string',
+      },
+    },
+    required: ['phoneNumberId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { phoneNumberId, ...body } = args as any;
+  const response = await client.phoneNumbers.release(phoneNumberId).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };