@fonoster/mcp 0.9.25

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Fonoster Inc
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,120 @@
+# Fonoster MCP Server
+
+[![Discord](https://img.shields.io/discord/1016419835455996076?color=5865F2&label=Discord&logo=discord&logoColor=white)](https://discord.gg/4QWgSz4hTC) ![GitHub](https://img.shields.io/github/license/fonoster/fonoster?color=%2347b96d) ![Twitter Follow](https://img.shields.io/twitter/follow/fonoster?style=social)
+
+MCP Server for the Fonoster API, enabling MCP clients to interact with Fonoster's telephony services. This module is part of the [Fonoster](https://fonoster.com) open-source project. For more information about the project, please visit [https://github.com/fonoster/fonoster](https://github.com/fonoster/fonoster).
+
+## Tools
+
+1. `list_numbers`
+   - Returns a list of numbers from Fonoster in a table format (using markdown)
+   - Optional inputs:
+     - `page_size` (number): Maximum number of numbers to return
+     - `page_token` (string): Pagination token for next page
+   - Returns: List of numbers with their refs, names, and telUrls
+
+2. `list_applications`
+   - Lists applications from Fonoster in a table format (using markdown)
+   - Optional inputs:
+     - `page_size` (number): Maximum number of applications to return
+     - `page_token` (string): Pagination token for next page
+   - Returns: List of applications with their refs, names, endpoints, creation dates, update dates, and types
+
+3. `create_call`
+   - Creates a call from Fonoster
+   - Required inputs:
+     - `from` (string): The number to call from
+     - `to` (string): The number to call to
+     - `app_ref` (string): The reference to the application to use for the call
+   - Returns: Call 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
+     - 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
+
+## Setup
+
+### Usage with Claude Desktop
+
+Add the following to your `claude_desktop_config.json`:
+
+#### npx
+
+```json
+{
+  "mcpServers": {
+    "fonoster": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "@fonoster/mcp"
+      ],
+      "env": {
+        "MCP_WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
+        "MCP_ACCESS_KEY_ID": "your-apikey-access-key-id",
+        "MCP_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
+      }
+    }
+  }
+}
+```
+
+#### docker
+
+```json
+{
+  "mcpServers": {
+    "fonoster": {
+      "command": "docker",
+      "args": [
+        "run",
+        "-i",
+        "--rm",
+        "-e",
+        "MCP_WORKSPACE_ACCESS_KEY_ID",
+        "-e",
+        "MCP_ACCESS_KEY_ID",
+        "-e",
+        "MCP_ACCESS_KEY_SECRET",
+        "fonoster/mcp"
+      ],
+      "env": {
+        "MCP_WORKSPACE_ACCESS_KEY_ID": "your-workspace-access-key-id",
+        "MCP_ACCESS_KEY_ID": "your-apikey-access-key-id",
+        "MCP_ACCESS_KEY_SECRET": "your-apikey-access-key-secret"
+      }
+    }
+  }
+}
+```
+
+### Testing with the MCP Inspector
+
+```bash
+MCP_WORKSPACE_ACCESS_KEY_ID="your-workspace-access-key-id" \
+MCP_ACCESS_KEY_ID="your-apikey-access-key-id" \
+MCP_ACCESS_KEY_SECRET="your-apikey-access-key_secret" \
+npx @modelcontextprotocol/inspector \
+node /Users/psanders/Projects/fonoster/mods/mcp/dist/index.js
+```
+
+### Troubleshooting
+
+If you encounter authentication errors, verify that:
+1. Your Fonoster credentials are correct
+2. The environment variables are properly set
+3. You have the necessary permissions to access the Fonoster API
+
+## Build
+
+Docker build:
+
+```bash
+docker build -t fonoster/mcp -f Dockerfile .
+```

package/dist/env.d.ts

@@ -0,0 +1,4 @@
+declare const WORKSPACE_ACCESS_KEY_ID: string;
+declare const ACCESS_KEY_ID: string;
+declare const ACCESS_KEY_SECRET: string;
+export { WORKSPACE_ACCESS_KEY_ID, ACCESS_KEY_ID, ACCESS_KEY_SECRET };

package/dist/env.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ACCESS_KEY_SECRET = exports.ACCESS_KEY_ID = exports.WORKSPACE_ACCESS_KEY_ID = void 0;
+/**
+ * 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 common_1 = require("@fonoster/common");
+(0, common_1.assertEnvsAreSet)([
+    "MCP_WORKSPACE_ACCESS_KEY_ID",
+    "MCP_ACCESS_KEY_ID",
+    "MCP_ACCESS_KEY_SECRET"
+]);
+const WORKSPACE_ACCESS_KEY_ID = process.env.MCP_WORKSPACE_ACCESS_KEY_ID;
+exports.WORKSPACE_ACCESS_KEY_ID = WORKSPACE_ACCESS_KEY_ID;
+const ACCESS_KEY_ID = process.env.MCP_ACCESS_KEY_ID;
+exports.ACCESS_KEY_ID = ACCESS_KEY_ID;
+const ACCESS_KEY_SECRET = process.env.MCP_ACCESS_KEY_SECRET;
+exports.ACCESS_KEY_SECRET = ACCESS_KEY_SECRET;

package/dist/index.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/index.js

@@ -0,0 +1,59 @@
+"use strict";
+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 });
+/**
+ * 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 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
+        const packageJsonPath = (0, path_1.join)(__dirname, "..", "package.json");
+        const packageJson = JSON.parse((0, fs_1.readFileSync)(packageJsonPath, "utf8"));
+        const server = new mcp_js_1.McpServer({
+            name: "Fonoster MCP Server",
+            version: packageJson.version
+        });
+        // Register all prompts
+        (0, index_1.registerPrompts)(server);
+        // Register all tools
+        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.d.ts

@@ -0,0 +1,31 @@
+/**
+ * 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.
+ */
+/**
+ * Returns the createCallPrompt content
+ * @returns The prompt content
+ */
+export declare function createCallPrompt(): Promise<{
+    messages: {
+        role: "assistant";
+        content: {
+            type: "text";
+            text: string;
+        };
+    }[];
+}>;

package/dist/prompts/createCallPrompt.js

@@ -0,0 +1,81 @@
+"use strict";
+/**
+ * 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.
+ */
+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.createCallPrompt = createCallPrompt;
+/**
+ * Returns the createCallPrompt content
+ * @returns The prompt content
+ */
+function createCallPrompt() {
+    return __awaiter(this, void 0, void 0, function* () {
+        return {
+            messages: [
+                {
+                    role: "assistant",
+                    content: {
+                        type: "text",
+                        text: `
+            ## Role:
+            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.
+
+            ## 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.
+
+            ## Example:
+            User: I want to call +1234567890
+            Assistant: Here are some numbers you can use:
+           
+            - +1234567890
+            - +1234567891
+            - +1234567892
+
+            User: I want to use the number +1234567890
+            Assistant: Perfect, I will use the number +1234567890 for the call. Which application do you want to use?
+
+            User: I want to use the application called "My App"
+            Assistant: Perfect, the application "My App" has the following ref:
+            - 586d7421-542f-49cc-b1ed-dc65378da01a
+
+            User: That's the one. Please create the call.
+            Assistant: Call created with REF: 586d7421-542f-49cc-b1ed-dc65378da01a
+          `
+                    }
+                }
+            ]
+        };
+    });
+}

package/dist/prompts/index.d.ts

@@ -0,0 +1,24 @@
+/**
+ * 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 { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers all prompts with the MCP server
+ * @param server The MCP server instance
+ */
+export declare function registerPrompts(server: McpServer): void;

package/dist/prompts/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerPrompts = registerPrompts;
+const createCallPrompt_1 = require("./createCallPrompt");
+/**
+ * Registers all prompts with the MCP server
+ * @param server The MCP server instance
+ */
+function registerPrompts(server) {
+    // Register the createCallPrompt
+    server.prompt("create_call_prompt", "A predefined prompt for creating a call", createCallPrompt_1.createCallPrompt);
+}

package/dist/schemas.d.ts

@@ -0,0 +1,53 @@
+/**
+ * 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 { z } from "zod";
+declare const ListApplicationsSchema: z.ZodObject<{
+    page_size: z.ZodOptional<z.ZodNumber>;
+    page_token: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page_size?: number;
+    page_token?: string;
+}, {
+    page_size?: number;
+    page_token?: string;
+}>;
+declare const ListNumbersSchema: z.ZodObject<{
+    page_size: z.ZodOptional<z.ZodNumber>;
+    page_token: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    page_size?: number;
+    page_token?: string;
+}, {
+    page_size?: number;
+    page_token?: string;
+}>;
+declare const CreateCallSchema: z.ZodObject<{
+    from: z.ZodString;
+    to: z.ZodString;
+    app_ref: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    from?: string;
+    to?: string;
+    app_ref?: string;
+}, {
+    from?: string;
+    to?: string;
+    app_ref?: string;
+}>;
+export { ListApplicationsSchema, CreateCallSchema, ListNumbersSchema };

package/dist/schemas.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ListNumbersSchema = exports.CreateCallSchema = exports.ListApplicationsSchema = void 0;
+/**
+ * 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 zod_1 = require("zod");
+const ListApplicationsSchema = zod_1.z.object({
+    page_size: zod_1.z.number().optional().describe("Number of applications per page"),
+    page_token: zod_1.z.string().optional().describe("Token for pagination")
+});
+exports.ListApplicationsSchema = ListApplicationsSchema;
+const ListNumbersSchema = zod_1.z.object({
+    page_size: zod_1.z.number().optional().describe("Number of numbers per page"),
+    page_token: zod_1.z.string().optional().describe("Token for pagination")
+});
+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")
+});
+exports.CreateCallSchema = CreateCallSchema;

package/dist/tools/createCreateCall.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 { CreateCallSchema } from "../schemas";
+/**
+ * Creates a call from Fonoster
+ * @param client The Fonoster client
+ * @returns A function that creates a call
+ */
+export declare function createCreateCall(client: SDK.Client): (params: z.infer<typeof CreateCallSchema>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/createCreateCall.js

@@ -0,0 +1,86 @@
+"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.createCreateCall = createCreateCall;
+/**
+ * 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"));
+/**
+ * Creates a call from Fonoster
+ * @param client The Fonoster client
+ * @returns A function that creates a call
+ */
+function createCreateCall(client) {
+    return function createCall(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const calls = new SDK.Calls(client);
+            const call = yield calls.createCall({
+                from: params.from,
+                to: params.to,
+                appRef: params.app_ref
+            });
+            return {
+                content: [
+                    { type: "text", text: `Call created with REF: ${call.ref}` }
+                ]
+            };
+        });
+    };
+}

package/dist/tools/createListApplications.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 { ListApplicationsSchema } from "../schemas";
+/**
+ * Lists applications from Fonoster
+ * @param client The Fonoster client
+ * @returns A function that lists applications
+ */
+export declare function createListApplications(client: SDK.Client): (params: z.infer<typeof ListApplicationsSchema>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/createListApplications.js

@@ -0,0 +1,93 @@
+"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.createListApplications = createListApplications;
+/**
+ * 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"));
+/**
+ * Lists applications from Fonoster
+ * @param client The Fonoster client
+ * @returns A function that lists applications
+ */
+function createListApplications(client) {
+    return function listApplications(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const apps = new SDK.Applications(client);
+            const response = yield apps.listApplications({
+                pageSize: params.page_size,
+                pageToken: params.page_token
+            });
+            return {
+                content: response.items.map((app) => ({
+                    type: "text",
+                    text: JSON.stringify({
+                        ref: app.ref,
+                        name: app.name,
+                        endpoint: app.endpoint,
+                        createdAt: app.createdAt,
+                        updatedAt: app.updatedAt,
+                        type: app.type
+                    })
+                }))
+            };
+        });
+    };
+}

package/dist/tools/createListNumbers.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 { ListNumbersSchema } from "../schemas";
+/**
+ * Lists numbers from Fonoster
+ * @param client The Fonoster client
+ * @returns A function that lists numbers
+ */
+export declare function createListNumbers(client: SDK.Client): (params: z.infer<typeof ListNumbersSchema>) => Promise<{
+    content: {
+        type: "text";
+        text: string;
+    }[];
+}>;

package/dist/tools/createListNumbers.js

@@ -0,0 +1,90 @@
+"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.createListNumbers = createListNumbers;
+/**
+ * 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"));
+/**
+ * Lists numbers from Fonoster
+ * @param client The Fonoster client
+ * @returns A function that lists numbers
+ */
+function createListNumbers(client) {
+    return function listNumbers(params) {
+        return __awaiter(this, void 0, void 0, function* () {
+            const numbers = new SDK.Numbers(client);
+            const response = yield numbers.listNumbers({
+                pageSize: params.page_size,
+                pageToken: params.page_token
+            });
+            return {
+                content: response.items.map((app) => ({
+                    type: "text",
+                    text: JSON.stringify({
+                        ref: app.ref,
+                        name: app.name,
+                        telUrl: app.telUrl
+                    })
+                }))
+            };
+        });
+    };
+}

package/dist/tools/index.d.ts

@@ -0,0 +1,7 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+/**
+ * Registers all tools with the MCP server
+ * @param server The MCP server instance
+ * @param client The Fonoster client
+ */
+export declare function registerTools(server: McpServer): Promise<void>;

package/dist/tools/index.js

@@ -0,0 +1,33 @@
+"use strict";
+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.registerTools = registerTools;
+const schemas_1 = require("../schemas");
+const createCreateCall_1 = require("./createCreateCall");
+const createListApplications_1 = require("./createListApplications");
+const createListNumbers_1 = require("./createListNumbers");
+const createClient_1 = require("../utils/createClient");
+/**
+ * Registers all tools with the MCP server
+ * @param server The MCP server instance
+ * @param client The Fonoster client
+ */
+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));
+    });
+}

package/dist/utils/createClient.d.ts

@@ -0,0 +1,20 @@
+/**
+ * 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";
+export declare function createClient(): Promise<SDK.Client>;

package/dist/utils/createClient.js

@@ -0,0 +1,72 @@
+"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.createClient = createClient;
+/**
+ * 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 env_1 = require("../env");
+function createClient() {
+    return __awaiter(this, void 0, void 0, function* () {
+        const client = new SDK.Client({ accessKeyId: env_1.WORKSPACE_ACCESS_KEY_ID });
+        yield client.loginWithApiKey(env_1.ACCESS_KEY_ID, env_1.ACCESS_KEY_SECRET);
+        return client;
+    });
+}

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@fonoster/mcp",
+  "version": "0.9.25",
+  "description": "Model Context Protocol for Fonoster",
+  "author": "Pedro Sanders <psanders@fonoster.com>",
+  "homepage": "https://github.com/fonoster/fonoster#readme",
+  "license": "MIT",
+  "main": "dist/index",
+  "types": "dist/index",
+  "directories": {
+    "src": "src",
+    "test": "test"
+  },
+  "scripts": {
+    "prebuild": "rimraf ./dist tsconfig.tsbuildinfo",
+    "build": "tsc -b tsconfig.json",
+    "clean": "rimraf ./dist node_modules tsconfig.tsbuildinfo"
+  },
+  "dependencies": {
+    "@fonoster/common": "^0.9.22",
+    "@fonoster/logger": "^0.9.22",
+    "@fonoster/sdk": "^0.9.22",
+    "@modelcontextprotocol/sdk": "^1.4.0"
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/fonoster/fonoster.git"
+  },
+  "bugs": {
+    "url": "https://github.com/fonoster/fonoster/issues"
+  },
+  "gitHead": "7fb41c18b755c07fd168e6d43f4651e733353afc"
+}