@telitask/mcp-server 0.1.3 → 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,CAwC5C;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) {
@@ -196,26 +197,55 @@ export async function handleScheduleCall(params) {
     const userId = getUserId();
     const voiceServerUrl = getVoiceServerUrl();
     const accessToken = getAccessToken();
-    const contactResult = await resolveContact(params.contact_id, params.contact_name);
-    if (Array.isArray(contactResult))
-        return contactResult;
     const personaId = await resolvePersonaId(params.persona_id, userId);
     if (!personaId) {
         return [{ type: 'text', text: 'No persona specified and no default persona set. Please provide a persona_id.' }];
     }
+    // Determine if this is a self-call or a contact call
+    const isContactCall = !!(params.contact_id || params.contact_name);
+    let callType;
+    let contactId;
+    let targetName;
+    if (isContactCall) {
+        const contactResult = await resolveContact(params.contact_id, params.contact_name);
+        if (Array.isArray(contactResult))
+            return contactResult;
+        callType = 'on_behalf';
+        contactId = contactResult.id;
+        targetName = contactResult.full_name;
+    }
+    else {
+        // Self-call: verify user has a phone number
+        const supabase = getAuthenticatedClient();
+        const { data: userProfile, error } = await supabase
+            .from('users')
+            .select('phone_number')
+            .eq('id', userId)
+            .single();
+        if (error) {
+            return [{ type: 'text', text: `Failed to look up your profile: ${error.message}` }];
+        }
+        if (!userProfile?.phone_number) {
+            return [{ type: 'text', text: 'No phone number on your profile. Please add one in the dashboard settings.' }];
+        }
+        callType = 'direct';
+        targetName = 'you';
+    }
+    const body = {
+        personaId,
+        callType,
+        purpose: params.brief,
+        scheduledAt: params.scheduled_at,
+        source: 'mcp',
+        ...(contactId && { contactId }),
+    };
     const response = await fetch(`${voiceServerUrl}/api/scheduled-calls`, {
         method: 'POST',
         headers: {
             'Content-Type': 'application/json',
             Authorization: `Bearer ${accessToken}`,
         },
-        body: JSON.stringify({
-            personaId,
-            callType: 'on_behalf',
-            contactId: contactResult.id,
-            purpose: params.brief,
-            scheduledAt: params.scheduled_at,
-        }),
+        body: JSON.stringify(body),
     });
     if (!response.ok) {
         const errBody = await response.text().catch(() => '');
@@ -224,7 +254,7 @@ export async function handleScheduleCall(params) {
     const result = await response.json();
     return [{
             type: 'text',
-            text: `Call scheduled to **${contactResult.full_name}** at ${params.scheduled_at}.\nBrief: ${params.brief}\nScheduled call ID: ${result.id ?? 'pending'}`,
+            text: `Call scheduled to **${targetName}** at ${params.scheduled_at}.\nBrief: ${params.brief}\nScheduled call ID: ${result.id ?? 'pending'}`,
         }];
 }
 export async function handleCancelCall(params) {
@@ -351,6 +381,7 @@ export async function handleCallMe(params) {
         personaId,
         phoneNumber: userProfile.phone_number,
         callType: 'direct',
+        source: 'mcp',
     };
     if (params.brief)
         body.purpose = params.brief;
@@ -425,7 +456,7 @@ export function registerCallTools(server) {
     }, async ({ contact_id, contact_name, brief, persona_id, wait_for_result }) => ({
         content: await handleMakeCall({ contact_id, contact_name, brief, persona_id, wait_for_result }),
     }));
-    server.tool('schedule_call', 'Schedule a phone call for a future time. Resolves contacts by ID or name.', {
+    server.tool('schedule_call', 'Schedule a phone call for a future time. If contact_id or contact_name is provided, schedules a call to that contact. If neither is provided, schedules a call to the user\'s own phone number.', {
         contact_id: z.string().optional().describe('Contact ID to call'),
         contact_name: z.string().optional().describe('Contact name to search for'),
         brief: z.string().describe('Purpose/brief for the call'),

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.3",
+  "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"
   },