@fonoster/mcp 0.9.48 → 0.9.49

package/README.md

@@ -28,15 +28,23 @@ MCP Server for the Fonoster API, enabling MCP clients to interact with Fonoster'
      - `app_ref` (string): The reference to the application to use for the call
    - Returns: Call creation confirmation with reference ID
 
+4. `create_call_batch`
+   - Creates a batch of calls from Fonoster
+   - Required inputs:
+     - `from` (string): The number to call from
+     - `to_array` (array): The numbers to call to
+     - `app_ref` (string): The reference to the application to use for the call
+   - Returns: Batch creation confirmation with reference ID
+
 ## Prompts
 
 1. `create_call_prompt`
    - A prompt for creating a call step by step
    - Guides Claude through the process of:
-     - Asking the user for the number to call
+     - Asking the user for the number or numbers to call if not already provided
      - Offering a list of available numbers using the `list_numbers` tool
      - Asking for the application name and finding its reference
-     - Creating a call using the `create_call` tool
+     - Creating a call using the `create_call` or `create_call_batch` tool depending on the user's request
 
 ## Setup
 
@@ -101,7 +109,7 @@ WORKSPACE_ACCESS_KEY_ID="your-workspace-access-key-id" \
 APIKEY_ACCESS_KEY_ID="your-apikey-access-key-id" \
 APIKEY_ACCESS_KEY_SECRET="your-apikey-access-key_secret" \
 npx @modelcontextprotocol/inspector \
-node /Users/psanders/Projects/fonoster/mods/mcp/dist/index.js
+node /path/to/fonoster/mods/mcp/dist/index.js
 ```
 
 ### Troubleshooting

package/dist/index.js

@@ -30,12 +30,10 @@ Object.defineProperty(exports, "__esModule", { value: true });
  */
 const fs_1 = require("fs");
 const path_1 = require("path");
-const logger_1 = require("@fonoster/logger");
 const mcp_js_1 = require("@modelcontextprotocol/sdk/server/mcp.js");
 const stdio_js_1 = require("@modelcontextprotocol/sdk/server/stdio.js");
 const index_1 = require("./prompts/index");
 const index_2 = require("./tools/index");
-const logger = (0, logger_1.getLogger)({ service: "mcp", filePath: __filename });
 function main() {
     return __awaiter(this, void 0, void 0, function* () {
         // Read package.json using fs module
@@ -51,10 +49,8 @@ function main() {
         yield (0, index_2.registerTools)(server);
         const transport = new stdio_js_1.StdioServerTransport();
         yield server.connect(transport);
-        logger.info("Fonoster MCP Server running on stdio");
     });
 }
 main().catch((error) => {
-    logger.error("Error starting MCP server:", error);
     process.exit(1);
 });

package/dist/prompts/createCallPrompt.js

@@ -45,17 +45,17 @@ function createCallPrompt() {
             You are a call originator that can create calls to Fonoster.
 
             ## Capabilities:
-            - You can list numbers from Fonoster by using the 'listNumbers' tool.
-            - You can list applications from Fonoster by using the 'listApplications' tool.
-            - You can create a call to Fonoster by using the 'createCall' tool.
+            - You can list numbers from Fonoster by using the 'listNumbers' tool
+            - You can list applications from Fonoster by using the 'listApplications' tool
+            - You can create a call to Fonoster by using the 'createCall' or 'createCallBatch' tool
 
             ## Steps:
-            1. Ask the user for the number to call if not already provided.
-            2. Offer the user a list of numbers to use for the call using the 'listNumbers' tool.
-            4. Then ask for the name of application and use that to find the 'ref' of the application.
-            5. Create a call to the selected application using the 'createCall' tool.
+            1. Ask the user for the number or numbers to call if not already provided
+            2. Offer the user a list of numbers to use for the call using the 'listNumbers' tool
+            3. Then ask for the name of application and use that to find the 'ref' of the application
+            4. Create a call to the selected application using the 'createCall' or 'createCallBatch' tool depending on the user's request
 
-            ## Example:
+            ## Example 1:
             User: I want to call +1234567890
             Assistant: Here are some numbers you can use:
            
@@ -72,6 +72,30 @@ function createCallPrompt() {
 
             User: That's the one. Please create the call.
             Assistant: Call created with REF: 586d7421-542f-49cc-b1ed-dc65378da01a
+
+            ## Example 2:
+            User: I want to call all the numbers on my list
+            Assistant: Great, which numbers do you want to call? Here are the numbers you can use:
+            - +1234567890
+            - +1234567891
+            - +1234567892
+
+            User: I want to use the numbers +1234567890
+            Assistant: Perfect, I will use the numbers +1234567890 for the call. Which application do you want to use? I see you have 3 applications available.
+            - My App
+            - My App 2
+            - My App 3
+
+            User: I want to use the application called "My App"
+            Assistant: Perfect, I will use "My App" for the call. Can you provide the list of numbers you want to call?
+
+            User: Here are the numbers:
+            - +1234567890
+            - +1234567891
+            - +1234567892
+
+            Assistant: Batch of 3 calls from +1234567890 initiated with ID: 1716604800000. 
+              Calls are being processed asynchronously at a rate of 10 calls per minute.
           `
                     }
                 }

package/dist/schemas.d.ts

@@ -41,13 +41,35 @@ declare const CreateCallSchema: z.ZodObject<{
     from: z.ZodString;
     to: z.ZodString;
     app_ref: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
 }, "strip", z.ZodTypeAny, {
     from?: string;
     to?: string;
     app_ref?: string;
+    timeout?: number;
 }, {
     from?: string;
     to?: string;
     app_ref?: string;
+    timeout?: number;
 }>;
-export { ListApplicationsSchema, CreateCallSchema, ListNumbersSchema };
+declare const CreateCallBatchSchema: z.ZodObject<{
+    from: z.ZodString;
+    to_array: z.ZodArray<z.ZodString, "many">;
+    app_ref: z.ZodString;
+    timeout: z.ZodOptional<z.ZodNumber>;
+    calls_per_minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+}, "strip", z.ZodTypeAny, {
+    from?: string;
+    app_ref?: string;
+    timeout?: number;
+    to_array?: string[];
+    calls_per_minute?: number;
+}, {
+    from?: string;
+    app_ref?: string;
+    timeout?: number;
+    to_array?: string[];
+    calls_per_minute?: number;
+}>;
+export { ListApplicationsSchema, CreateCallSchema, ListNumbersSchema, CreateCallBatchSchema };

package/dist/schemas.js

@@ -1,6 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.ListNumbersSchema = exports.CreateCallSchema = exports.ListApplicationsSchema = void 0;
+exports.CreateCallBatchSchema = exports.ListNumbersSchema = exports.CreateCallSchema = exports.ListApplicationsSchema = void 0;
 /**
  * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
  * http://github.com/fonoster/fonoster
@@ -33,6 +33,15 @@ exports.ListNumbersSchema = ListNumbersSchema;
 const CreateCallSchema = zod_1.z.object({
     from: zod_1.z.string().describe("The phone number to call from"),
     to: zod_1.z.string().describe("The phone number to call to"),
-    app_ref: zod_1.z.string().describe("The application reference to use for the call")
+    app_ref: zod_1.z.string().describe("The application reference to use for the call"),
+    timeout: zod_1.z.number().optional().describe("The timeout for the call")
 });
 exports.CreateCallSchema = CreateCallSchema;
+const CreateCallBatchSchema = zod_1.z.object({
+    from: zod_1.z.string().min(1),
+    to_array: zod_1.z.array(zod_1.z.string().min(1)).min(1),
+    app_ref: zod_1.z.string().min(1),
+    timeout: zod_1.z.number().optional(),
+    calls_per_minute: zod_1.z.number().min(1).max(60).optional().default(20)
+});
+exports.CreateCallBatchSchema = CreateCallBatchSchema;

package/dist/tools/createCreateCall.js

@@ -74,7 +74,8 @@ function createCreateCall(client) {
             const call = yield calls.createCall({
                 from: params.from,
                 to: params.to,
-                appRef: params.app_ref
+                appRef: params.app_ref,
+                timeout: params.timeout
             });
             return {
                 content: [

package/dist/tools/createCreateCallBatch.d.ts

@@ -0,0 +1,32 @@
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+import * as SDK from "@fonoster/sdk";
+import { z } from "zod";
+import { CreateCallBatchSchema } from "../schemas";
+/**
+ * Creates multiple calls from Fonoster in a batch with the same from number and application
+ * @param client The Fonoster client
+ * @returns A function that creates multiple calls in a batch
+ */
+export declare function createCreateCallBatch(client: SDK.Client): (params: z.infer<typeof CreateCallBatchSchema>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/createCreateCallBatch.js

@@ -0,0 +1,109 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCreateCallBatch = createCreateCallBatch;
+/**
+ * Copyright (C) 2025 by Fonoster Inc (https://fonoster.com)
+ * http://github.com/fonoster/fonoster
+ *
+ * This file is part of Fonoster
+ *
+ * Licensed under the MIT License (the "License");
+ * you may not use this file except in compliance with
+ * the License. You may obtain a copy of the License at
+ *
+ *    https://opensource.org/licenses/MIT
+ *
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+const SDK = __importStar(require("@fonoster/sdk"));
+const schemas_1 = require("../schemas");
+/**
+ * Creates multiple calls from Fonoster in a batch with the same from number and application
+ * @param client The Fonoster client
+ * @returns A function that creates multiple calls in a batch
+ */
+function createCreateCallBatch(client) {
+    return function createCallBatch(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const calls = new SDK.Calls(client);
+            const validatedParams = schemas_1.CreateCallBatchSchema.parse(params);
+            const { from, to_array, app_ref, timeout, calls_per_minute } = validatedParams;
+            const batchId = Date.now().toString();
+            const createSingleCall = (to) => calls.createCall({
+                from,
+                to,
+                appRef: app_ref,
+                timeout
+            });
+            const delayBetweenCalls = Math.ceil(60000 / calls_per_minute);
+            const delay = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+            (() => __awaiter(this, void 0, void 0, function* () {
+                const destinations = [...to_array];
+                while (destinations.length > 0) {
+                    const to = destinations.shift();
+                    createSingleCall(to).catch((error) => {
+                        console.error(`Failed to create call to ${to}: ${error.message}`);
+                    });
+                    if (destinations.length > 0) {
+                        yield delay(delayBetweenCalls);
+                    }
+                }
+            }))();
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Batch of ${to_array.length} calls from ${from} initiated with ID: ${batchId}. ` +
+                            `Calls are being processed asynchronously at a rate of ${calls_per_minute} calls per minute.`
+                    }
+                ]
+            };
+        });
+    };
+}

package/dist/tools/index.js

@@ -13,6 +13,7 @@ exports.registerTools = registerTools;
 const schemas_1 = require("../schemas");
 const createClient_1 = require("../utils/createClient");
 const createCreateCall_1 = require("./createCreateCall");
+const createCreateCallBatch_1 = require("./createCreateCallBatch");
 const createListApplications_1 = require("./createListApplications");
 const createListNumbers_1 = require("./createListNumbers");
 /**
@@ -23,11 +24,9 @@ const createListNumbers_1 = require("./createListNumbers");
 function registerTools(server) {
     return __awaiter(this, void 0, void 0, function* () {
         const client = yield (0, createClient_1.createClient)();
-        // Register the listNumbers tool
         server.tool("list_numbers", "Returns a list of numbers from Fonoster in a table format (using markdown)", schemas_1.ListNumbersSchema.shape, (0, createListNumbers_1.createListNumbers)(client));
-        // Register the listApplications tool
         server.tool("list_applications", "Lists applications from Fonoster in a table format (using markdown)", schemas_1.ListApplicationsSchema.shape, (0, createListApplications_1.createListApplications)(client));
-        // Register the createCall tool
         server.tool("create_call", "Creates a call from Fonoster", schemas_1.CreateCallSchema.shape, (0, createCreateCall_1.createCreateCall)(client));
+        server.tool("create_call_batch", "Creates a batch of calls from Fonoster", schemas_1.CreateCallBatchSchema.shape, (0, createCreateCallBatch_1.createCreateCallBatch)(client));
     });
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fonoster/mcp",
-  "version": "0.9.48",
+  "version": "0.9.49",
   "description": "Model Context Protocol for Fonoster",
   "author": "Pedro Sanders <psanders@fonoster.com>",
   "homepage": "https://github.com/fonoster/fonoster#readme",
@@ -17,12 +17,13 @@
   "scripts": {
     "prebuild": "rimraf ./dist tsconfig.tsbuildinfo",
     "build": "tsc -b tsconfig.json",
+    "postbuild": "chmod +x ./dist/index.js",
     "clean": "rimraf ./dist node_modules tsconfig.tsbuildinfo"
   },
   "dependencies": {
-    "@fonoster/common": "^0.9.48",
-    "@fonoster/logger": "^0.9.46",
-    "@fonoster/sdk": "^0.9.48",
+    "@fonoster/common": "^0.9.49",
+    "@fonoster/logger": "^0.9.49",
+    "@fonoster/sdk": "^0.9.49",
     "@modelcontextprotocol/sdk": "^1.4.0"
   },
   "files": [
@@ -38,5 +39,5 @@
   "bugs": {
     "url": "https://github.com/fonoster/fonoster/issues"
   },
-  "gitHead": "7c9666911ad017363ea4d99b06c2f6cc915d5c91"
+  "gitHead": "8f176f86f5ed02c7e8d87e275d14e6b34fa116bd"
 }