@zavudev/sdk-mcp 0.14.0

package/src/tools/broadcasts/send-broadcasts.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: 'broadcasts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/broadcasts/{broadcastId}/send',
+  operationId: 'sendBroadcast',
+};
+
+export const tool: Tool = {
+  name: 'send_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\nStart sending the broadcast immediately or schedule for later. Reserves the estimated cost from your balance.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/broadcast_send_response',\n  $defs: {\n    broadcast_send_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',
+      },
+      scheduledAt: {
+        type: 'string',
+        description: 'Schedule for future delivery. Omit to send immediately.',
+        format: 'date-time',
+      },
+      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.send(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/update-broadcasts.ts

@@ -0,0 +1,106 @@
+// 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: 'patch',
+  httpPath: '/v1/broadcasts/{broadcastId}',
+  operationId: 'updateBroadcast',
+};
+
+export const tool: Tool = {
+  name: 'update_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\nUpdate a broadcast in draft status.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/broadcast_update_response',\n  $defs: {\n    broadcast_update_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',
+      },
+      content: {
+        $ref: '#/$defs/broadcast_content',
+      },
+      emailHtmlBody: {
+        type: 'string',
+      },
+      emailSubject: {
+        type: 'string',
+      },
+      metadata: {
+        type: 'object',
+        additionalProperties: true,
+      },
+      name: {
+        type: 'string',
+      },
+      text: {
+        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'],
+    $defs: {
+      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,
+          },
+        },
+      },
+    },
+  },
+  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.update(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/contacts/list-contacts.ts

@@ -0,0 +1,61 @@
+// 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: 'contacts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/contacts',
+  operationId: 'listContacts',
+};
+
+export const tool: Tool = {
+  name: 'list_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\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/contact'\n      }\n    },\n    nextCursor: {\n      type: 'string'\n    }\n  },\n  required: [    'items'\n  ],\n  $defs: {\n    contact: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'E.164 phone number.'\n        },\n        availableChannels: {\n          type: 'array',\n          description: 'List of available messaging channels for this contact.',\n          items: {\n            type: 'string'\n          }\n        },\n        countryCode: {\n          type: 'string'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        defaultChannel: {\n          type: 'string',\n          description: 'Preferred channel for this contact.',\n          enum: [            'sms',\n            'whatsapp',\n            'email'\n          ]\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        profileName: {\n          type: 'string',\n          description: 'Contact\\'s WhatsApp profile name. Only available for WhatsApp contacts.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        verified: {\n          type: 'boolean',\n          description: 'Whether this contact has been verified.'\n        }\n      },\n      required: [        'id',\n        'phoneNumber'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      cursor: {
+        type: 'string',
+      },
+      limit: {
+        type: 'integer',
+      },
+      phoneNumber: {
+        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: [],
+  },
+  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.contacts.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/contacts/retrieve-by-phone-contacts.ts

@@ -0,0 +1,56 @@
+// 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: 'contacts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/contacts/phone/{phoneNumber}',
+  operationId: 'getContactByPhone',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_by_phone_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\nGet contact by phone number\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contact',\n  $defs: {\n    contact: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'E.164 phone number.'\n        },\n        availableChannels: {\n          type: 'array',\n          description: 'List of available messaging channels for this contact.',\n          items: {\n            type: 'string'\n          }\n        },\n        countryCode: {\n          type: 'string'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        defaultChannel: {\n          type: 'string',\n          description: 'Preferred channel for this contact.',\n          enum: [            'sms',\n            'whatsapp',\n            'email'\n          ]\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        profileName: {\n          type: 'string',\n          description: 'Contact\\'s WhatsApp profile name. Only available for WhatsApp contacts.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        verified: {\n          type: 'boolean',\n          description: 'Whether this contact has been verified.'\n        }\n      },\n      required: [        'id',\n        'phoneNumber'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      phoneNumber: {
+        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: ['phoneNumber'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { phoneNumber, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(
+      await maybeFilter(jq_filter, await client.contacts.retrieveByPhone(phoneNumber)),
+    );
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/contacts/retrieve-contacts.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: 'contacts',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/contacts/{contactId}',
+  operationId: 'getContact',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_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\nGet contact\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contact',\n  $defs: {\n    contact: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'E.164 phone number.'\n        },\n        availableChannels: {\n          type: 'array',\n          description: 'List of available messaging channels for this contact.',\n          items: {\n            type: 'string'\n          }\n        },\n        countryCode: {\n          type: 'string'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        defaultChannel: {\n          type: 'string',\n          description: 'Preferred channel for this contact.',\n          enum: [            'sms',\n            'whatsapp',\n            'email'\n          ]\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        profileName: {\n          type: 'string',\n          description: 'Contact\\'s WhatsApp profile name. Only available for WhatsApp contacts.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        verified: {\n          type: 'boolean',\n          description: 'Whether this contact has been verified.'\n        }\n      },\n      required: [        'id',\n        'phoneNumber'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      contactId: {
+        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: ['contactId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { contactId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.contacts.retrieve(contactId)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/contacts/update-contacts.ts

@@ -0,0 +1,61 @@
+// 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: 'contacts',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'patch',
+  httpPath: '/v1/contacts/{contactId}',
+  operationId: 'updateContact',
+};
+
+export const tool: Tool = {
+  name: 'update_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\nUpdate contact\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/contact',\n  $defs: {\n    contact: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'E.164 phone number.'\n        },\n        availableChannels: {\n          type: 'array',\n          description: 'List of available messaging channels for this contact.',\n          items: {\n            type: 'string'\n          }\n        },\n        countryCode: {\n          type: 'string'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        defaultChannel: {\n          type: 'string',\n          description: 'Preferred channel for this contact.',\n          enum: [            'sms',\n            'whatsapp',\n            'email'\n          ]\n        },\n        metadata: {\n          type: 'object',\n          additionalProperties: true\n        },\n        profileName: {\n          type: 'string',\n          description: 'Contact\\'s WhatsApp profile name. Only available for WhatsApp contacts.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        verified: {\n          type: 'boolean',\n          description: 'Whether this contact has been verified.'\n        }\n      },\n      required: [        'id',\n        'phoneNumber'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      contactId: {
+        type: 'string',
+      },
+      defaultChannel: {
+        type: 'string',
+        description: 'Preferred channel for this contact. Set to null to clear.',
+        enum: ['sms', 'whatsapp', 'email'],
+      },
+      metadata: {
+        type: 'object',
+        additionalProperties: true,
+      },
+      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: ['contactId'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { contactId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.contacts.update(contactId, body)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/index.ts

@@ -0,0 +1,143 @@
+// File generated from our OpenAPI spec by Stainless. See CONTRIBUTING.md for details.
+
+import { Metadata, Endpoint, HandlerFunction } from './types';
+
+export { Metadata, Endpoint, HandlerFunction };
+
+import retrieve_messages from './messages/retrieve-messages';
+import list_messages from './messages/list-messages';
+import react_messages from './messages/react-messages';
+import send_messages from './messages/send-messages';
+import create_templates from './templates/create-templates';
+import retrieve_templates from './templates/retrieve-templates';
+import list_templates from './templates/list-templates';
+import delete_templates from './templates/delete-templates';
+import submit_templates from './templates/submit-templates';
+import create_senders from './senders/create-senders';
+import retrieve_senders from './senders/retrieve-senders';
+import update_senders from './senders/update-senders';
+import list_senders from './senders/list-senders';
+import delete_senders from './senders/delete-senders';
+import regenerate_webhook_secret_senders from './senders/regenerate-webhook-secret-senders';
+import retrieve_contacts from './contacts/retrieve-contacts';
+import update_contacts from './contacts/update-contacts';
+import list_contacts from './contacts/list-contacts';
+import retrieve_by_phone_contacts from './contacts/retrieve-by-phone-contacts';
+import create_broadcasts from './broadcasts/create-broadcasts';
+import retrieve_broadcasts from './broadcasts/retrieve-broadcasts';
+import update_broadcasts from './broadcasts/update-broadcasts';
+import list_broadcasts from './broadcasts/list-broadcasts';
+import delete_broadcasts from './broadcasts/delete-broadcasts';
+import cancel_broadcasts from './broadcasts/cancel-broadcasts';
+import progress_broadcasts from './broadcasts/progress-broadcasts';
+import send_broadcasts from './broadcasts/send-broadcasts';
+import list_broadcasts_contacts from './broadcasts/contacts/list-broadcasts-contacts';
+import add_broadcasts_contacts from './broadcasts/contacts/add-broadcasts-contacts';
+import remove_broadcasts_contacts from './broadcasts/contacts/remove-broadcasts-contacts';
+import validate_phone_introspect from './introspect/validate-phone-introspect';
+import retrieve_phone_numbers from './phone-numbers/retrieve-phone-numbers';
+import update_phone_numbers from './phone-numbers/update-phone-numbers';
+import list_phone_numbers from './phone-numbers/list-phone-numbers';
+import purchase_phone_numbers from './phone-numbers/purchase-phone-numbers';
+import release_phone_numbers from './phone-numbers/release-phone-numbers';
+import search_available_phone_numbers from './phone-numbers/search-available-phone-numbers';
+
+export const endpoints: Endpoint[] = [];
+
+function addEndpoint(endpoint: Endpoint) {
+  endpoints.push(endpoint);
+}
+
+addEndpoint(retrieve_messages);
+addEndpoint(list_messages);
+addEndpoint(react_messages);
+addEndpoint(send_messages);
+addEndpoint(create_templates);
+addEndpoint(retrieve_templates);
+addEndpoint(list_templates);
+addEndpoint(delete_templates);
+addEndpoint(submit_templates);
+addEndpoint(create_senders);
+addEndpoint(retrieve_senders);
+addEndpoint(update_senders);
+addEndpoint(list_senders);
+addEndpoint(delete_senders);
+addEndpoint(regenerate_webhook_secret_senders);
+addEndpoint(retrieve_contacts);
+addEndpoint(update_contacts);
+addEndpoint(list_contacts);
+addEndpoint(retrieve_by_phone_contacts);
+addEndpoint(create_broadcasts);
+addEndpoint(retrieve_broadcasts);
+addEndpoint(update_broadcasts);
+addEndpoint(list_broadcasts);
+addEndpoint(delete_broadcasts);
+addEndpoint(cancel_broadcasts);
+addEndpoint(progress_broadcasts);
+addEndpoint(send_broadcasts);
+addEndpoint(list_broadcasts_contacts);
+addEndpoint(add_broadcasts_contacts);
+addEndpoint(remove_broadcasts_contacts);
+addEndpoint(validate_phone_introspect);
+addEndpoint(retrieve_phone_numbers);
+addEndpoint(update_phone_numbers);
+addEndpoint(list_phone_numbers);
+addEndpoint(purchase_phone_numbers);
+addEndpoint(release_phone_numbers);
+addEndpoint(search_available_phone_numbers);
+
+export type Filter = {
+  type: 'resource' | 'operation' | 'tag' | 'tool';
+  op: 'include' | 'exclude';
+  value: string;
+};
+
+export function query(filters: Filter[], endpoints: Endpoint[]): Endpoint[] {
+  const allExcludes = filters.length > 0 && filters.every((filter) => filter.op === 'exclude');
+  const unmatchedFilters = new Set(filters);
+
+  const filtered = endpoints.filter((endpoint: Endpoint) => {
+    let included = false || allExcludes;
+
+    for (const filter of filters) {
+      if (match(filter, endpoint)) {
+        unmatchedFilters.delete(filter);
+        included = filter.op === 'include';
+      }
+    }
+
+    return included;
+  });
+
+  // Check if any filters didn't match
+  const unmatched = Array.from(unmatchedFilters).filter((f) => f.type === 'tool' || f.type === 'resource');
+  if (unmatched.length > 0) {
+    throw new Error(
+      `The following filters did not match any endpoints: ${unmatched
+        .map((f) => `${f.type}=${f.value}`)
+        .join(', ')}`,
+    );
+  }
+
+  return filtered;
+}
+
+function match({ type, value }: Filter, endpoint: Endpoint): boolean {
+  switch (type) {
+    case 'resource': {
+      const regexStr = '^' + normalizeResource(value).replace(/\*/g, '.*') + '$';
+      const regex = new RegExp(regexStr);
+      return regex.test(normalizeResource(endpoint.metadata.resource));
+    }
+    case 'operation':
+      return endpoint.metadata.operation === value;
+    case 'tag':
+      return endpoint.metadata.tags.includes(value);
+    case 'tool':
+      return endpoint.tool.name === value;
+  }
+}
+
+function normalizeResource(resource: string): string {
+  return resource.toLowerCase().replace(/[^a-z.*\-_]*/g, '');
+}

package/src/tools/introspect/validate-phone-introspect.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: 'introspect',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/introspect/phone',
+  operationId: 'introspectPhone',
+};
+
+export const tool: Tool = {
+  name: 'validate_phone_introspect',
+  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\nValidate a phone number and check if a WhatsApp conversation window is open.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/introspect_validate_phone_response',\n  $defs: {\n    introspect_validate_phone_response: {\n      type: 'object',\n      properties: {\n        countryCode: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string'\n        },\n        validNumber: {\n          type: 'boolean'\n        },\n        availableChannels: {\n          type: 'array',\n          description: 'List of available messaging channels for this phone number.',\n          items: {\n            type: 'string'\n          }\n        },\n        carrier: {\n          type: 'object',\n          description: 'Carrier information for the phone number.',\n          properties: {\n            name: {\n              type: 'string',\n              description: 'Carrier name.'\n            },\n            type: {\n              $ref: '#/$defs/line_type'\n            }\n          }\n        },\n        lineType: {\n          $ref: '#/$defs/line_type'\n        },\n        nationalFormat: {\n          type: 'string',\n          description: 'Phone number in national format.'\n        }\n      },\n      required: [        'countryCode',\n        'phoneNumber',\n        'validNumber'\n      ]\n    },\n    line_type: {\n      type: 'string',\n      description: 'Type of phone line.',\n      enum: [        'mobile',\n        'landline',\n        'voip',\n        'toll_free',\n        'unknown'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      phoneNumber: {
+        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: ['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.introspect.validatePhone(body)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };