@zavudev/sdk-mcp 0.14.0

package/src/tools/phone-numbers/retrieve-phone-numbers.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: 'phone_numbers',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/phone-numbers/{phoneNumberId}',
+  operationId: 'getPhoneNumber',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_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\nGet details of a specific phone number.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/phone_number_retrieve_response',\n  $defs: {\n    phone_number_retrieve_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: {
+      phoneNumberId: {
+        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: ['phoneNumberId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { phoneNumberId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(
+      await maybeFilter(jq_filter, await client.phoneNumbers.retrieve(phoneNumberId)),
+    );
+  } 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/search-available-phone-numbers.ts

@@ -0,0 +1,72 @@
+// 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/available',
+  operationId: 'searchAvailablePhoneNumbers',
+};
+
+export const tool: Tool = {
+  name: 'search_available_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\nSearch for available phone numbers to purchase by country and type.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/phone_number_search_available_response',\n  $defs: {\n    phone_number_search_available_response: {\n      type: 'object',\n      properties: {\n        items: {\n          type: 'array',\n          items: {\n            $ref: '#/$defs/available_phone_number'\n          }\n        }\n      },\n      required: [        'items'\n      ]\n    },\n    available_phone_number: {\n      type: 'object',\n      properties: {\n        capabilities: {\n          $ref: '#/$defs/phone_number_capabilities'\n        },\n        phoneNumber: {\n          type: 'string'\n        },\n        pricing: {\n          $ref: '#/$defs/phone_number_pricing'\n        },\n        friendlyName: {\n          type: 'string'\n        },\n        locality: {\n          type: 'string'\n        },\n        region: {\n          type: 'string'\n        }\n      },\n      required: [        'capabilities',\n        'phoneNumber',\n        'pricing'\n      ]\n    },\n    phone_number_capabilities: {\n      type: 'object',\n      properties: {\n        mms: {\n          type: 'boolean'\n        },\n        sms: {\n          type: 'boolean'\n        },\n        voice: {\n          type: 'boolean'\n        }\n      }\n    },\n    phone_number_pricing: {\n      type: 'object',\n      properties: {\n        isFreeEligible: {\n          type: 'boolean',\n          description: 'Whether this number qualifies for the free first US number offer.'\n        },\n        monthlyPrice: {\n          type: 'number',\n          description: 'Monthly price in USD.'\n        },\n        upfrontPrice: {\n          type: 'number',\n          description: 'One-time purchase price in USD.'\n        }\n      }\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      countryCode: {
+        type: 'string',
+        description: 'Two-letter ISO country code.',
+      },
+      contains: {
+        type: 'string',
+        description: 'Search for numbers containing this string.',
+      },
+      limit: {
+        type: 'integer',
+        description: 'Maximum number of results to return.',
+      },
+      type: {
+        $ref: '#/$defs/phone_number_type',
+      },
+      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: ['countryCode'],
+    $defs: {
+      phone_number_type: {
+        type: 'string',
+        enum: ['local', 'mobile', 'tollFree'],
+      },
+    },
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+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.searchAvailable(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/update-phone-numbers.ts

@@ -0,0 +1,62 @@
+// 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: 'patch',
+  httpPath: '/v1/phone-numbers/{phoneNumberId}',
+  operationId: 'updatePhoneNumber',
+};
+
+export const tool: Tool = {
+  name: 'update_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\nUpdate a phone number's name or sender assignment.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/phone_number_update_response',\n  $defs: {\n    phone_number_update_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: {
+      phoneNumberId: {
+        type: 'string',
+      },
+      name: {
+        type: 'string',
+        description: 'Custom name for the phone number. Set to null to clear.',
+      },
+      senderId: {
+        type: 'string',
+        description: 'Sender ID to assign the phone number to. Set to null to unassign.',
+      },
+      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: ['phoneNumberId'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { phoneNumberId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(
+      await maybeFilter(jq_filter, await client.phoneNumbers.update(phoneNumberId, body)),
+    );
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,86 @@
+// 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: 'senders',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/senders',
+  operationId: 'createSender',
+};
+
+export const tool: Tool = {
+  name: 'create_senders',
+  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 sender\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/sender',\n  $defs: {\n    sender: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'Phone number in E.164 format.'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Whether this sender is the project\\'s default.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        webhook: {\n          $ref: '#/$defs/sender_webhook'\n        }\n      },\n      required: [        'id',\n        'name',\n        'phoneNumber'\n      ]\n    },\n    sender_webhook: {\n      type: 'object',\n      description: 'Webhook configuration for the sender.',\n      properties: {\n        active: {\n          type: 'boolean',\n          description: 'Whether the webhook is active.'\n        },\n        events: {\n          type: 'array',\n          description: 'List of events the webhook is subscribed to.',\n          items: {\n            $ref: '#/$defs/webhook_event'\n          }\n        },\n        url: {\n          type: 'string',\n          description: 'HTTPS URL that will receive webhook events.'\n        },\n        secret: {\n          type: 'string',\n          description: 'Webhook secret for signature verification. Only returned on create or regenerate.'\n        }\n      },\n      required: [        'active',\n        'events',\n        'url'\n      ]\n    },\n    webhook_event: {\n      type: 'string',\n      description: 'Type of event that triggers the webhook. Note: Reactions are delivered as message.inbound with messageType=\\'reaction\\'.',\n      enum: [        'message.queued',\n        'message.sent',\n        'message.delivered',\n        'message.failed',\n        'message.inbound',\n        'message.unsupported',\n        'conversation.new',\n        'template.status_changed'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      name: {
+        type: 'string',
+      },
+      phoneNumber: {
+        type: 'string',
+      },
+      setAsDefault: {
+        type: 'boolean',
+      },
+      webhookEvents: {
+        type: 'array',
+        description: 'Events to subscribe to.',
+        items: {
+          $ref: '#/$defs/webhook_event',
+        },
+      },
+      webhookUrl: {
+        type: 'string',
+        description: 'HTTPS URL for webhook events.',
+      },
+      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: ['name', 'phoneNumber'],
+    $defs: {
+      webhook_event: {
+        type: 'string',
+        description:
+          "Type of event that triggers the webhook. Note: Reactions are delivered as message.inbound with messageType='reaction'.",
+        enum: [
+          'message.queued',
+          'message.sent',
+          'message.delivered',
+          'message.failed',
+          'message.inbound',
+          'message.unsupported',
+          'conversation.new',
+          'template.status_changed',
+        ],
+      },
+    },
+  },
+  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.senders.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/senders/delete-senders.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: 'senders',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'delete',
+  httpPath: '/v1/senders/{senderId}',
+  operationId: 'deleteSender',
+};
+
+export const tool: Tool = {
+  name: 'delete_senders',
+  description: 'Delete sender',
+  inputSchema: {
+    type: 'object',
+    properties: {
+      senderId: {
+        type: 'string',
+      },
+    },
+    required: ['senderId'],
+  },
+  annotations: {
+    idempotentHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { senderId, ...body } = args as any;
+  const response = await client.senders.delete(senderId).asResponse();
+  return asTextContentResult(await response.text());
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,58 @@
+// 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: 'senders',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/senders',
+  operationId: 'listSenders',
+};
+
+export const tool: Tool = {
+  name: 'list_senders',
+  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 senders\n\n# Response Schema\n```json\n{\n  type: 'object',\n  properties: {\n    items: {\n      type: 'array',\n      items: {\n        $ref: '#/$defs/sender'\n      }\n    },\n    nextCursor: {\n      type: 'string'\n    }\n  },\n  required: [    'items'\n  ],\n  $defs: {\n    sender: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'Phone number in E.164 format.'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Whether this sender is the project\\'s default.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        webhook: {\n          $ref: '#/$defs/sender_webhook'\n        }\n      },\n      required: [        'id',\n        'name',\n        'phoneNumber'\n      ]\n    },\n    sender_webhook: {\n      type: 'object',\n      description: 'Webhook configuration for the sender.',\n      properties: {\n        active: {\n          type: 'boolean',\n          description: 'Whether the webhook is active.'\n        },\n        events: {\n          type: 'array',\n          description: 'List of events the webhook is subscribed to.',\n          items: {\n            $ref: '#/$defs/webhook_event'\n          }\n        },\n        url: {\n          type: 'string',\n          description: 'HTTPS URL that will receive webhook events.'\n        },\n        secret: {\n          type: 'string',\n          description: 'Webhook secret for signature verification. Only returned on create or regenerate.'\n        }\n      },\n      required: [        'active',\n        'events',\n        'url'\n      ]\n    },\n    webhook_event: {\n      type: 'string',\n      description: 'Type of event that triggers the webhook. Note: Reactions are delivered as message.inbound with messageType=\\'reaction\\'.',\n      enum: [        'message.queued',\n        'message.sent',\n        'message.delivered',\n        'message.failed',\n        'message.inbound',\n        'message.unsupported',\n        'conversation.new',\n        'template.status_changed'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      cursor: {
+        type: 'string',
+      },
+      limit: {
+        type: 'integer',
+      },
+      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.senders.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/senders/regenerate-webhook-secret-senders.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: 'senders',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'post',
+  httpPath: '/v1/senders/{senderId}/webhook/secret',
+  operationId: 'regenerateSenderWebhookSecret',
+};
+
+export const tool: Tool = {
+  name: 'regenerate_webhook_secret_senders',
+  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\nRegenerate the webhook secret for a sender. The old secret will be invalidated immediately.\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/webhook_secret_response',\n  $defs: {\n    webhook_secret_response: {\n      type: 'object',\n      properties: {\n        secret: {\n          type: 'string',\n          description: 'The new webhook secret.'\n        }\n      },\n      required: [        'secret'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      senderId: {
+        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: ['senderId'],
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { senderId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(
+      await maybeFilter(jq_filter, await client.senders.regenerateWebhookSecret(senderId)),
+    );
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

package/src/tools/senders/retrieve-senders.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: 'senders',
+  operation: 'read',
+  tags: [],
+  httpMethod: 'get',
+  httpPath: '/v1/senders/{senderId}',
+  operationId: 'getSender',
+};
+
+export const tool: Tool = {
+  name: 'retrieve_senders',
+  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 sender\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/sender',\n  $defs: {\n    sender: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'Phone number in E.164 format.'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Whether this sender is the project\\'s default.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        webhook: {\n          $ref: '#/$defs/sender_webhook'\n        }\n      },\n      required: [        'id',\n        'name',\n        'phoneNumber'\n      ]\n    },\n    sender_webhook: {\n      type: 'object',\n      description: 'Webhook configuration for the sender.',\n      properties: {\n        active: {\n          type: 'boolean',\n          description: 'Whether the webhook is active.'\n        },\n        events: {\n          type: 'array',\n          description: 'List of events the webhook is subscribed to.',\n          items: {\n            $ref: '#/$defs/webhook_event'\n          }\n        },\n        url: {\n          type: 'string',\n          description: 'HTTPS URL that will receive webhook events.'\n        },\n        secret: {\n          type: 'string',\n          description: 'Webhook secret for signature verification. Only returned on create or regenerate.'\n        }\n      },\n      required: [        'active',\n        'events',\n        'url'\n      ]\n    },\n    webhook_event: {\n      type: 'string',\n      description: 'Type of event that triggers the webhook. Note: Reactions are delivered as message.inbound with messageType=\\'reaction\\'.',\n      enum: [        'message.queued',\n        'message.sent',\n        'message.delivered',\n        'message.failed',\n        'message.inbound',\n        'message.unsupported',\n        'conversation.new',\n        'template.status_changed'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      senderId: {
+        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: ['senderId'],
+  },
+  annotations: {
+    readOnlyHint: true,
+  },
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { senderId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.senders.retrieve(senderId)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };

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

@@ -0,0 +1,90 @@
+// 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: 'senders',
+  operation: 'write',
+  tags: [],
+  httpMethod: 'patch',
+  httpPath: '/v1/senders/{senderId}',
+  operationId: 'updateSender',
+};
+
+export const tool: Tool = {
+  name: 'update_senders',
+  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 sender\n\n# Response Schema\n```json\n{\n  $ref: '#/$defs/sender',\n  $defs: {\n    sender: {\n      type: 'object',\n      properties: {\n        id: {\n          type: 'string'\n        },\n        name: {\n          type: 'string'\n        },\n        phoneNumber: {\n          type: 'string',\n          description: 'Phone number in E.164 format.'\n        },\n        createdAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        isDefault: {\n          type: 'boolean',\n          description: 'Whether this sender is the project\\'s default.'\n        },\n        updatedAt: {\n          type: 'string',\n          format: 'date-time'\n        },\n        webhook: {\n          $ref: '#/$defs/sender_webhook'\n        }\n      },\n      required: [        'id',\n        'name',\n        'phoneNumber'\n      ]\n    },\n    sender_webhook: {\n      type: 'object',\n      description: 'Webhook configuration for the sender.',\n      properties: {\n        active: {\n          type: 'boolean',\n          description: 'Whether the webhook is active.'\n        },\n        events: {\n          type: 'array',\n          description: 'List of events the webhook is subscribed to.',\n          items: {\n            $ref: '#/$defs/webhook_event'\n          }\n        },\n        url: {\n          type: 'string',\n          description: 'HTTPS URL that will receive webhook events.'\n        },\n        secret: {\n          type: 'string',\n          description: 'Webhook secret for signature verification. Only returned on create or regenerate.'\n        }\n      },\n      required: [        'active',\n        'events',\n        'url'\n      ]\n    },\n    webhook_event: {\n      type: 'string',\n      description: 'Type of event that triggers the webhook. Note: Reactions are delivered as message.inbound with messageType=\\'reaction\\'.',\n      enum: [        'message.queued',\n        'message.sent',\n        'message.delivered',\n        'message.failed',\n        'message.inbound',\n        'message.unsupported',\n        'conversation.new',\n        'template.status_changed'\n      ]\n    }\n  }\n}\n```",
+  inputSchema: {
+    type: 'object',
+    properties: {
+      senderId: {
+        type: 'string',
+      },
+      name: {
+        type: 'string',
+      },
+      setAsDefault: {
+        type: 'boolean',
+      },
+      webhookActive: {
+        type: 'boolean',
+        description: 'Whether the webhook is active.',
+      },
+      webhookEvents: {
+        type: 'array',
+        description: 'Events to subscribe to.',
+        items: {
+          $ref: '#/$defs/webhook_event',
+        },
+      },
+      webhookUrl: {
+        type: 'string',
+        description: 'HTTPS URL for webhook events. Set to null to remove webhook.',
+      },
+      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: ['senderId'],
+    $defs: {
+      webhook_event: {
+        type: 'string',
+        description:
+          "Type of event that triggers the webhook. Note: Reactions are delivered as message.inbound with messageType='reaction'.",
+        enum: [
+          'message.queued',
+          'message.sent',
+          'message.delivered',
+          'message.failed',
+          'message.inbound',
+          'message.unsupported',
+          'conversation.new',
+          'template.status_changed',
+        ],
+      },
+    },
+  },
+  annotations: {},
+};
+
+export const handler = async (client: Zavudev, args: Record<string, unknown> | undefined) => {
+  const { senderId, jq_filter, ...body } = args as any;
+  try {
+    return asTextContentResult(await maybeFilter(jq_filter, await client.senders.update(senderId, body)));
+  } catch (error) {
+    if (error instanceof Zavudev.APIError || isJqError(error)) {
+      return asErrorResult(error.message);
+    }
+    throw error;
+  }
+};
+
+export default { metadata, tool, handler };