@telitask/mcp-server 0.1.4 → 0.2.0

package/dist/index.js

@@ -6,6 +6,7 @@ import { runOAuthLogin } from './auth/oauth.js';
 import { registerContactTools } from './tools/contacts.js';
 import { registerTaskTools } from './tools/tasks.js';
 import { registerCallTools } from './tools/calls.js';
+import { registerPhoneTools } from './tools/phone.js';
 import { registerResources } from './resources/index.js';
 const DEFAULT_DASHBOARD_URL = 'https://telitask.ai';
 async function runLogin() {
@@ -58,6 +59,7 @@ async function runServer() {
         registerContactTools(server);
         registerTaskTools(server);
         registerCallTools(server);
+        registerPhoneTools(server);
         registerResources(server);
     }
     const transport = new StdioServerTransport();

package/dist/tools/calls.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../src/tools/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4JzE,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAgF5C;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwE5C;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAgC5C;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAuC5C;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwC5C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAyF5C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6EzD"}
+{"version":3,"file":"calls.d.ts","sourceRoot":"","sources":["../../src/tools/calls.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AA4JzE,wBAAsB,cAAc,CAAC,MAAM,EAAE;IAC3C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAiF5C;AAED,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAyE5C;AAED,wBAAsB,gBAAgB,CAAC,MAAM,EAAE;IAC7C,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAgC5C;AAED,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAuC5C;AAED,wBAAsB,aAAa,CAAC,MAAM,EAAE;IAC1C,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwC5C;AAED,wBAAsB,YAAY,CAAC,MAAM,EAAE;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,OAAO,CAAC;CAC3B,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA0F5C;AAED,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA6EzD"}

package/dist/tools/calls.js

@@ -144,6 +144,7 @@ export async function handleMakeCall(params) {
             callType: 'on_behalf',
             purpose: params.brief,
             contactId: contactResult.id,
+            source: 'mcp',
         }),
     });
     if (!response.ok) {
@@ -235,6 +236,7 @@ export async function handleScheduleCall(params) {
         callType,
         purpose: params.brief,
         scheduledAt: params.scheduled_at,
+        source: 'mcp',
         ...(contactId && { contactId }),
     };
     const response = await fetch(`${voiceServerUrl}/api/scheduled-calls`, {
@@ -379,6 +381,7 @@ export async function handleCallMe(params) {
         personaId,
         phoneNumber: userProfile.phone_number,
         callType: 'direct',
+        source: 'mcp',
     };
     if (params.brief)
         body.purpose = params.brief;

package/dist/tools/contacts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwC5C;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAsB5C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2B5D"}
+{"version":3,"file":"contacts.d.ts","sourceRoot":"","sources":["../../src/tools/contacts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAKzE,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAwC5C;AAED,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,SAAS,EAAE,MAAM,CAAC;IAClB,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAuB5C;AAED,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CA2B5D"}

package/dist/tools/contacts.js

@@ -50,6 +50,7 @@ export async function handleCreateContact(params) {
         email: params.email ?? null,
         notes: params.notes ?? null,
         user_id: userId,
+        external_source: 'mcp',
     })
         .select()
         .single();

package/dist/tools/phone.d.ts

@@ -0,0 +1,17 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function handleSendPhoneCode(params: {
+    phone_number: string;
+    country_code?: string;
+}): Promise<{
+    type: 'text';
+    text: string;
+}[]>;
+export declare function handleVerifyPhoneCode(params: {
+    phone_number: string;
+    code: string;
+}): Promise<{
+    type: 'text';
+    text: string;
+}[]>;
+export declare function registerPhoneTools(server: McpServer): void;
+//# sourceMappingURL=phone.d.ts.map

package/dist/tools/phone.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"phone.d.ts","sourceRoot":"","sources":["../../src/tools/phone.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAqBzE,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,YAAY,EAAE,MAAM,CAAC;IACrB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CA8C5C;AAED,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;CACd,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EAAE,CAAC,CAsB5C;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAwB1D"}

package/dist/tools/phone.js

@@ -0,0 +1,89 @@
+import { z } from 'zod';
+import { parsePhoneNumberFromString } from 'libphonenumber-js';
+import { refreshSessionIfNeeded, getVoiceServerUrl, getAccessToken, } from '../lib/supabase.js';
+/** Map voice server error codes to user-friendly messages */
+const ERROR_MESSAGES = {
+    invalid_code: 'Invalid code. Please try again.',
+    code_expired: "Code expired. Say 'resend' and I'll send a new one.",
+    max_attempts_exceeded: 'Too many failed attempts. Request a new code.',
+    phone_already_verified: 'This phone number is already in use by another account.',
+    rate_limit_exceeded: 'Too many attempts. Please wait a few minutes.',
+    country_not_supported: 'Phone numbers from this country are not currently supported.',
+    cooldown: 'Please wait before requesting another code.',
+};
+export async function handleSendPhoneCode(params) {
+    await refreshSessionIfNeeded();
+    const voiceServerUrl = getVoiceServerUrl();
+    const accessToken = getAccessToken();
+    // Normalize phone number to E.164
+    let e164;
+    if (params.phone_number.startsWith('+')) {
+        // International format — parse directly
+        const parsed = parsePhoneNumberFromString(params.phone_number);
+        if (!parsed?.isValid()) {
+            return [{ type: 'text', text: 'Could not parse that phone number. Please provide a valid phone number.' }];
+        }
+        e164 = parsed.format('E.164');
+    }
+    else {
+        // Local format — need country_code
+        if (!params.country_code) {
+            return [{ type: 'text', text: "I need your country to verify this number. Which country are you in? (e.g., US, GB, KE)" }];
+        }
+        const parsed = parsePhoneNumberFromString(params.phone_number, params.country_code);
+        if (!parsed?.isValid()) {
+            return [{ type: 'text', text: `Could not parse "${params.phone_number}" as a valid phone number for ${params.country_code}.` }];
+        }
+        e164 = parsed.format('E.164');
+    }
+    // POST to voice server
+    const response = await fetch(`${voiceServerUrl}/api/phone/send-code`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({ phoneNumber: e164 }),
+    });
+    if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        const errorKey = body.error ?? 'unknown';
+        const message = ERROR_MESSAGES[errorKey] ?? body.message ?? 'Failed to send verification code. Please try again.';
+        return [{ type: 'text', text: message }];
+    }
+    return [{ type: 'text', text: `Verification code sent to ${e164}. What's the 6-digit code?` }];
+}
+export async function handleVerifyPhoneCode(params) {
+    await refreshSessionIfNeeded();
+    const voiceServerUrl = getVoiceServerUrl();
+    const accessToken = getAccessToken();
+    const response = await fetch(`${voiceServerUrl}/api/phone/verify-code`, {
+        method: 'POST',
+        headers: {
+            'Content-Type': 'application/json',
+            Authorization: `Bearer ${accessToken}`,
+        },
+        body: JSON.stringify({ phoneNumber: params.phone_number, code: params.code }),
+    });
+    if (!response.ok) {
+        const body = await response.json().catch(() => ({}));
+        const errorKey = body.error ?? 'unknown';
+        const message = ERROR_MESSAGES[errorKey] ?? body.message ?? 'Failed to verify code. Please try again.';
+        return [{ type: 'text', text: message }];
+    }
+    return [{ type: 'text', text: `Phone number verified: ${params.phone_number}` }];
+}
+export function registerPhoneTools(server) {
+    server.tool('send_phone_code', "Send a verification code to a phone number. Accepts local format (e.g., '0712345678') with a country_code, or international format (e.g., '+254712345678'). Use this when the user wants to add or verify their phone number.", {
+        phone_number: z.string().describe("Phone number in local or international format (e.g., '0712345678' or '+254712345678')"),
+        country_code: z.string().optional().describe("ISO 3166-1 alpha-2 country code (e.g., 'KE', 'US'). Required when phone_number is in local format."),
+    }, async ({ phone_number, country_code }) => ({
+        content: await handleSendPhoneCode({ phone_number, country_code }),
+    }));
+    server.tool('verify_phone_code', 'Verify a phone number with the 6-digit code sent via SMS. Use the E.164 phone number from the previous send_phone_code step.', {
+        phone_number: z.string().describe("Phone number in E.164 format (e.g., '+254712345678') — use the number returned by send_phone_code"),
+        code: z.string().describe('The 6-digit verification code from the SMS'),
+    }, async ({ phone_number, code }) => ({
+        content: await handleVerifyPhoneCode({ phone_number, code }),
+    }));
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@telitask/mcp-server",
-  "version": "0.1.4",
+  "version": "0.2.0",
   "description": "TeliTask MCP server — manage contacts, tasks, and calls from AI assistants",
   "type": "module",
   "license": "MIT",
@@ -48,6 +48,7 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.29.0",
     "@supabase/supabase-js": "^2.49.4",
+    "libphonenumber-js": "^1.12.36",
     "open": "^10.1.0",
     "zod": "^3.24.2"
   },