call-me-cloud-mcp 1.1.0 → 1.3.0

package/README.md

@@ -1,21 +1,29 @@
 # call-me-cloud-mcp
 
-MCP (Model Context Protocol) client that enables Claude to make phone calls via [Call-Me Cloud](https://github.com/riverscornelson/call-me-cloud).
+MCP (Model Context Protocol) client that enables Claude to make phone calls and send WhatsApp messages via [Call-Me Cloud](https://github.com/riverscornelson/call-me-cloud).
 
 ## What is this?
 
-This package lets Claude Code call you on the phone. It connects to a Call-Me Cloud server (which you deploy) and provides MCP tools for initiating and managing voice calls.
+This package lets Claude Code call you on the phone or message you on WhatsApp. It connects to a Call-Me Cloud server (which you deploy) and provides MCP tools for initiating and managing voice calls and text conversations.
 
 ## Installation
 
-Used automatically via npx in Claude Code configurations. Add to your MCP settings:
+### Via Plugin Marketplace (Recommended)
+
+```
+/plugin install call-me-cloud@claude-plugins-official
+```
+
+### Via npx (Manual)
+
+Add to your MCP settings (`.mcp.json` or Claude Code config):
 
 ```json
 {
   "mcpServers": {
     "call-me-cloud": {
       "command": "npx",
-      "args": ["-y", "call-me-cloud-mcp"],
+      "args": ["-y", "call-me-cloud-mcp@1.3.0"],
       "env": {
         "CALLME_CLOUD_URL": "https://your-server.railway.app",
         "CALLME_API_KEY": "your-api-key"
@@ -64,25 +72,34 @@ End the call with a closing message.
 end_call({ call_id: "call-1", message: "Sounds good, I'll get started. Talk soon!" })
 ```
 
+### `send_message`
+Send a WhatsApp message and wait for the user's reply.
+
+```
+send_message({ message: "The deploy finished. Want me to run the smoke tests?" })
+```
+
+Returns: `{ messageId, response }` - The message ID and the user's text response.
+
 ## Requirements
 
 - Node.js 18+
 - A deployed [Call-Me Cloud](https://github.com/riverscornelson/call-me-cloud) server
-- Twilio or Telnyx account for phone calls
+- Twilio account for phone calls
 - OpenAI API key (for speech-to-text and text-to-speech)
 
 ## How It Works
 
 ```
-Claude Code  -->  This MCP Client  -->  Your Cloud Server  -->  Phone Call
-   (stdio)          (REST API)           (Twilio/Telnyx)        (to you)
+Claude Code  -->  This MCP Client  -->  Your Cloud Server  -->  Phone Call / WhatsApp
+   (stdio)          (REST API)              (Twilio)           (to you)
 ```
 
-1. Claude decides to call you using one of the MCP tools
+1. Claude decides to call or message you using one of the MCP tools
 2. This client forwards the request to your cloud server
-3. The server initiates a phone call via Twilio/Telnyx
-4. Audio is processed through OpenAI's real-time API
-5. Your response is transcribed and returned to Claude
+3. The server initiates a phone call via Twilio or sends a WhatsApp message
+4. Audio is processed through OpenAI's real-time API (for calls)
+5. Your response is transcribed/received and returned to Claude
 
 ## Server Setup
 

package/index.ts

@@ -14,6 +14,15 @@ import { CallToolRequestSchema, ListToolsRequestSchema } from '@modelcontextprot
 const CLOUD_URL = process.env.CALLME_CLOUD_URL;
 const API_KEY = process.env.CALLME_API_KEY;
 
+const TOOL_TIMEOUTS: Record<string, number> = {
+  initiate_call:  200_000,  // user answers phone + speaks
+  continue_call:  200_000,  // waiting for spoken/WhatsApp response
+  send_message:   200_000,  // WhatsApp: server waits up to 3 min
+  speak_to_user:   30_000,  // fire-and-forget
+  end_call:        30_000,  // quick hangup
+}
+const DEFAULT_TIMEOUT = 30_000
+
 if (!CLOUD_URL) {
   console.error('Error: CALLME_CLOUD_URL is required');
   console.error('Set it to your Railway/Render deployment URL');
@@ -25,7 +34,7 @@ if (!API_KEY) {
   process.exit(1);
 }
 
-async function apiCall(path: string, body: unknown): Promise<unknown> {
+async function apiCall(path: string, body: unknown, timeoutMs = DEFAULT_TIMEOUT): Promise<unknown> {
   const response = await fetch(`${CLOUD_URL}${path}`, {
     method: 'POST',
     headers: {
@@ -33,6 +42,7 @@ async function apiCall(path: string, body: unknown): Promise<unknown> {
       'Authorization': `Bearer ${API_KEY}`,
     },
     body: JSON.stringify(body),
+    signal: AbortSignal.timeout(timeoutMs),
   });
 
   if (!response.ok) {
@@ -46,7 +56,9 @@ async function apiCall(path: string, body: unknown): Promise<unknown> {
 async function main() {
   // Verify cloud server is reachable (uses unauthenticated /health endpoint)
   try {
-    const healthResponse = await fetch(`${CLOUD_URL}/health`);
+    const healthResponse = await fetch(`${CLOUD_URL}/health`, {
+      signal: AbortSignal.timeout(5_000),
+    });
     if (!healthResponse.ok) {
       throw new Error(`Health check failed: ${healthResponse.status}`);
     }
@@ -58,7 +70,7 @@ async function main() {
   }
 
   const mcpServer = new Server(
-    { name: 'call-me-cloud', version: '1.0.1' },
+    { name: 'call-me-cloud', version: '1.3.0' },
     { capabilities: { tools: {} } }
   );
 
@@ -116,6 +128,20 @@ async function main() {
             required: ['call_id', 'message'],
           },
         },
+        {
+          name: 'send_message',
+          description: 'Send a WhatsApp message to the user. Use when a phone call is not appropriate or when the user prefers text. Waits for user response.',
+          inputSchema: {
+            type: 'object',
+            properties: {
+              message: {
+                type: 'string',
+                description: 'The message to send via WhatsApp.',
+              },
+            },
+            required: ['message'],
+          },
+        },
       ],
     };
   });
@@ -125,7 +151,7 @@ async function main() {
     try {
       if (request.params.name === 'initiate_call') {
         const { message } = request.params.arguments as { message: string };
-        const result = await apiCall('/api/call', { message }) as {
+        const result = await apiCall('/api/call', { message }, TOOL_TIMEOUTS.initiate_call) as {
           callId: string;
           response: string;
           contactMode?: 'voice' | 'whatsapp';
@@ -165,7 +191,7 @@ async function main() {
 
       if (request.params.name === 'continue_call') {
         const { call_id, message } = request.params.arguments as { call_id: string; message: string };
-        const result = await apiCall(`/api/call/${call_id}/continue`, { message }) as {
+        const result = await apiCall(`/api/call/${call_id}/continue`, { message }, TOOL_TIMEOUTS.continue_call) as {
           response: string;
           contactMode?: 'voice' | 'whatsapp';
           whatsappSessionWindow?: {
@@ -195,7 +221,7 @@ async function main() {
 
       if (request.params.name === 'speak_to_user') {
         const { call_id, message } = request.params.arguments as { call_id: string; message: string };
-        await apiCall(`/api/call/${call_id}/speak`, { message });
+        await apiCall(`/api/call/${call_id}/speak`, { message }, TOOL_TIMEOUTS.speak_to_user);
 
         return {
           content: [{ type: 'text', text: `Message spoken: "${message}"` }],
@@ -204,13 +230,25 @@ async function main() {
 
       if (request.params.name === 'end_call') {
         const { call_id, message } = request.params.arguments as { call_id: string; message: string };
-        const result = await apiCall(`/api/call/${call_id}/end`, { message }) as { durationSeconds: number };
+        const result = await apiCall(`/api/call/${call_id}/end`, { message }, TOOL_TIMEOUTS.end_call) as { durationSeconds: number };
 
         return {
           content: [{ type: 'text', text: `Call ended. Duration: ${result.durationSeconds}s` }],
         };
       }
 
+      if (request.params.name === 'send_message') {
+        const { message } = request.params.arguments as { message: string };
+        const result = await apiCall('/api/message', { message }, TOOL_TIMEOUTS.send_message) as { messageId: string; response: string };
+
+        return {
+          content: [{
+            type: 'text',
+            text: `WhatsApp message sent.\n\nMessage ID: ${result.messageId}\n\nUser's response:\n${result.response}`,
+          }],
+        };
+      }
+
       throw new Error(`Unknown tool: ${request.params.name}`);
     } catch (error) {
       const errorMessage = error instanceof Error ? error.message : 'Unknown error';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "call-me-cloud-mcp",
-  "version": "1.1.0",
+  "version": "1.3.0",
   "description": "MCP client for Call-Me Cloud - lets Claude call you via phone",
   "type": "module",
   "bin": {