wixzel-voice-mcp 0.4.0

package/dist/tools/webhooks.d.ts

@@ -0,0 +1,52 @@
+import { z } from 'zod/v4';
+export declare const webhookTools: (import("../tooling.js").ToolDef<{}> | import("../tooling.js").ToolDef<{
+    url: z.ZodOptional<z.ZodString>;
+    enabled: z.ZodOptional<z.ZodBoolean>;
+    events: z.ZodOptional<z.ZodArray<z.ZodEnum<{
+        inboundCall: "inboundCall";
+        outboundCall: "outboundCall";
+        callCompleted: "callCompleted";
+        leadCreated: "leadCreated";
+        leadQualified: "leadQualified";
+        campaignCompleted: "campaignCompleted";
+        appointmentBooked: "appointmentBooked";
+        appointmentCanceled: "appointmentCanceled";
+        callTransferred: "callTransferred";
+        transferFailed: "transferFailed";
+    }>>>;
+}> | import("../tooling.js").ToolDef<{
+    event: z.ZodEnum<{
+        inboundCall: "inboundCall";
+        outboundCall: "outboundCall";
+        callCompleted: "callCompleted";
+        leadCreated: "leadCreated";
+        leadQualified: "leadQualified";
+        campaignCompleted: "campaignCompleted";
+        appointmentBooked: "appointmentBooked";
+        appointmentCanceled: "appointmentCanceled";
+        callTransferred: "callTransferred";
+        transferFailed: "transferFailed";
+    }>;
+}> | import("../tooling.js").ToolDef<{
+    limit: z.ZodOptional<z.ZodNumber>;
+    starting_after: z.ZodOptional<z.ZodString>;
+    ending_before: z.ZodOptional<z.ZodString>;
+    event: z.ZodOptional<z.ZodEnum<{
+        inboundCall: "inboundCall";
+        outboundCall: "outboundCall";
+        callCompleted: "callCompleted";
+        leadCreated: "leadCreated";
+        leadQualified: "leadQualified";
+        campaignCompleted: "campaignCompleted";
+        appointmentBooked: "appointmentBooked";
+        appointmentCanceled: "appointmentCanceled";
+        callTransferred: "callTransferred";
+        transferFailed: "transferFailed";
+    }>>;
+    status: z.ZodOptional<z.ZodEnum<{
+        failed: "failed";
+        delivered: "delivered";
+    }>>;
+    start: z.ZodOptional<z.ZodString>;
+    end: z.ZodOptional<z.ZodString>;
+}>)[];

package/dist/tools/webhooks.js

@@ -0,0 +1,90 @@
+import { z } from 'zod/v4';
+import { annotate, compact, defineTool } from '../tooling.js';
+import { isoDate, pagination } from '../schemas.js';
+const EVENTS = [
+    'inboundCall',
+    'outboundCall',
+    'callCompleted',
+    'leadCreated',
+    'leadQualified',
+    'campaignCompleted',
+    'appointmentBooked',
+    'appointmentCanceled',
+    'callTransferred',
+    'transferFailed',
+];
+const event = z.enum(EVENTS).describe('An event id. These are camelCase because they are the literal `event` field of the JSON we POST, not API fields.');
+export const webhookTools = [
+    defineTool({
+        name: 'get_webhook',
+        endpoint: 'GET /v1/webhook',
+        title: 'Retrieve the webhook endpoint',
+        description: 'Where events are sent for this account, whether delivery is on, and which events are subscribed. ' +
+            'One endpoint per account, so there is nothing to list. The signing secret is never returned — only whether one is set.',
+        input: {},
+        annotations: annotate.read,
+        scope: 'webhooks:read',
+        handler: (client) => client.get('/v1/webhook'),
+    }),
+    defineTool({
+        name: 'update_webhook',
+        endpoint: 'PATCH /v1/webhook',
+        title: 'Update the webhook endpoint',
+        description: 'Set the URL, turn delivery on or off, or change the event subscription. Only the fields you send change, ' +
+            'EXCEPT events, which replaces the subscription entirely — send the full list you want, not a delta. ' +
+            'The URL must be publicly resolvable; one pointing at loopback or a private network is refused. ' +
+            'Enabling with no URL set is refused rather than silently saved.',
+        input: {
+            url: z.string().url().optional().describe('HTTPS endpoint we POST events to.'),
+            enabled: z.boolean().optional().describe('Master switch. False sends nothing regardless of the event list.'),
+            events: z.array(event).min(1).optional().describe('The complete set of events to receive.'),
+        },
+        annotations: annotate.write,
+        scope: 'webhooks:write',
+        handler: (client, args) => client.patch('/v1/webhook', compact(args)),
+    }),
+    defineTool({
+        name: 'rotate_webhook_secret',
+        endpoint: 'POST /v1/webhook/rotate-secret',
+        title: 'Rotate the webhook signing secret',
+        description: 'Mint a new signing secret and return it ONCE. The old secret stops verifying immediately, so a receiver ' +
+            'that checks signatures will reject every event until it has been redeployed with the new one. ' +
+            'Do this when a secret has leaked, not as routine maintenance, and hand the value to the user right away.',
+        input: {},
+        annotations: annotate.write,
+        scope: 'webhooks:write',
+        handler: (client) => client.post('/v1/webhook/rotate-secret'),
+    }),
+    defineTool({
+        name: 'test_webhook',
+        endpoint: 'POST /v1/webhook/test',
+        title: 'Send a test webhook event',
+        description: 'POST one sample payload to the configured URL right now and report what came back. This is how to check ' +
+            'a webhook works BEFORE enabling it: it deliberately ignores the enabled flag and the event subscription. ' +
+            'It reaches a real third-party endpoint but spends no credit. The payload is obviously fake sample data.',
+        input: { event },
+        annotations: annotate.probe,
+        scope: 'webhooks:write',
+        handler: (client, args) => client.post('/v1/webhook/test', args),
+    }),
+    defineTool({
+        name: 'list_webhook_deliveries',
+        endpoint: 'GET /v1/webhook/deliveries',
+        title: 'List webhook delivery attempts',
+        description: 'What was sent and what came back, newest first — the answer to "did my webhook fire?". One record per ' +
+            'attempt, so an event delivered on its third try appears three times. A null response_status means nothing ' +
+            'answered at all (DNS, refused connection, timeout), which is what tells a wrong URL apart from a handler ' +
+            'that threw. Filter with status: "failed" to see only what broke.',
+        input: {
+            event: event.optional(),
+            status: z.enum(['delivered', 'failed']).optional().describe('Filter by outcome.'),
+            start: isoDate.optional().describe('Only attempts at or after this time.'),
+            end: isoDate.optional().describe('Only attempts at or before this time.'),
+            ...pagination,
+        },
+        annotations: annotate.read,
+        scope: 'webhooks:read',
+        handler: (client, args) => client.get('/v1/webhook/deliveries', compact(args)),
+    }),
+];
+//# sourceMappingURL=webhooks.js.map

package/dist/tools/webhooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webhooks.js","sourceRoot":"","sources":["../../src/tools/webhooks.ts"],"names":[],"mappings":"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"}

package/dist/version.d.ts

@@ -0,0 +1,7 @@
+/**
+ * The release, in one place. The server advertises it, the client sends it in
+ * its User-Agent, and a test holds package.json and server.json to it. The
+ * User-Agent once said 0.2.1 through the 0.3.0 release because it was a second
+ * literal nobody bumped.
+ */
+export declare const VERSION = "0.4.0";

package/dist/version.js

@@ -0,0 +1,8 @@
+/**
+ * The release, in one place. The server advertises it, the client sends it in
+ * its User-Agent, and a test holds package.json and server.json to it. The
+ * User-Agent once said 0.2.1 through the 0.3.0 release because it was a second
+ * literal nobody bumped.
+ */
+export const VERSION = '0.4.0';
+//# sourceMappingURL=version.js.map

package/dist/version.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"version.js","sourceRoot":"","sources":["../src/version.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,OAAO,CAAC"}

package/package.json

@@ -0,0 +1,65 @@
+{
+  "name": "wixzel-voice-mcp",
+  "version": "0.4.0",
+  "description": "MCP server for Wixzel Voice — lets Claude, ChatGPT, Cursor and any other MCP client create voice agents, place and answer real phone calls, manage leads and campaigns, and read usage over the Wixzel Voice API.",
+  "mcpName": "com.wixzel/voice",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "wixzel-voice-mcp": "dist/index.js"
+  },
+  "main": "dist/server.js",
+  "types": "dist/server.d.ts",
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": ">=20"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json && chmod +x dist/index.js",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "test": "tsx --test test/*.test.ts",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "inspect": "npx @modelcontextprotocol/inspector node dist/index.js",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "wixzel",
+    "voice-agents",
+    "telephony",
+    "claude-code",
+    "ai-agents",
+    "mcp-server",
+    "phone-calls",
+    "voice-ai",
+    "ai-voice-agent",
+    "sip-trunk",
+    "claude",
+    "cursor"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/aqeelshamz/wixzel-voice-sdks.git",
+    "directory": "apps/mcp"
+  },
+  "homepage": "https://voice.wixzel.com",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.30.0",
+    "zod": "^3.25.76"
+  },
+  "devDependencies": {
+    "@types/node": "^22.19.0",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.0"
+  }
+}