@chamade/mcp-server 1.1.7 → 2.0.0

package/dist/index.d.ts

@@ -7,7 +7,14 @@
  * and receive live transcripts via resource subscriptions.
  *
  * Two modes:
- * - Standard MCP (default): agent polls chamade_status for transcripts
+ * - Standard MCP (default): agent polls chamade_call_status for transcripts
  * - Channel mode (--channel): transcripts and events pushed via notifications
+ *
+ * Tools: 13 total
+ *   DM:   chamade_dm_chat, chamade_dm_typing
+ *   Call: chamade_call_join, chamade_call_accept, chamade_call_refuse,
+ *         chamade_call_say, chamade_call_chat, chamade_call_typing,
+ *         chamade_call_status, chamade_call_leave, chamade_call_list
+ *   Other: chamade_inbox, chamade_account
  */
 export {};

package/dist/index.js

@@ -7,8 +7,15 @@
  * and receive live transcripts via resource subscriptions.
  *
  * Two modes:
- * - Standard MCP (default): agent polls chamade_status for transcripts
+ * - Standard MCP (default): agent polls chamade_call_status for transcripts
  * - Channel mode (--channel): transcripts and events pushed via notifications
+ *
+ * Tools: 13 total
+ *   DM:   chamade_dm_chat, chamade_dm_typing
+ *   Call: chamade_call_join, chamade_call_accept, chamade_call_refuse,
+ *         chamade_call_say, chamade_call_chat, chamade_call_typing,
+ *         chamade_call_status, chamade_call_leave, chamade_call_list
+ *   Other: chamade_inbox, chamade_account
  */
 import { McpServer, ResourceTemplate } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -83,59 +90,60 @@ const CHANNEL_PREAMBLE = [
     "## Channel mode — events arrive automatically",
     "",
     "Transcripts, messages, and calls are pushed to you in real-time.",
-    "Do NOT poll chamade_status in a loop — you will be notified automatically.",
-    "When you receive transcript lines, respond using chamade_say (TTS) or chamade_chat (text).",
-    "When you receive a message, reply using chamade_send.",
-    "When you receive an incoming call, use chamade_answer to pick up.",
-    "You can still call chamade_status manually to catch up on missed transcript.",
+    "Do NOT poll chamade_call_status in a loop — you will be notified automatically.",
+    "When you receive transcript lines, respond using chamade_call_say (TTS) or chamade_call_chat (text).",
+    "When you receive a message, reply using chamade_dm_chat.",
+    "When you receive an incoming call, use chamade_call_accept to pick up.",
+    "You can still call chamade_call_status manually to catch up on missed transcript.",
     "",
 ].join("\n");
 const BASE_INSTRUCTIONS = [
     "Chamade is a voice gateway for AI agents. It lets you join voice meetings (Discord, Teams, Meet, Telegram, SIP) and interact via speech and text.",
     "",
     "## Voice call workflow",
-    "1. Use chamade_join to enter a meeting — returns a call_id and capabilities.",
-    "2. Poll chamade_status in a loop to read new transcript lines (delta pattern — only new lines since last call).",
-    "3. When you see new transcript, respond to the CONTENT using chamade_say (TTS) or chamade_chat (text).",
+    "1. Use chamade_call_join to enter a meeting — returns a call_id and capabilities.",
+    "2. Poll chamade_call_status in a loop to read new transcript lines (delta pattern — only new lines since last call).",
+    "3. When you see new transcript, respond to the CONTENT using chamade_call_say (TTS) or chamade_call_chat (text).",
     "4. Repeat step 2-3. Keep the call active — do NOT leave between exchanges.",
-    "5. Use chamade_leave only when explicitly asked or when the meeting ends.",
+    "5. Use chamade_call_leave only when explicitly asked or when the meeting ends.",
     "",
     "## SIP phone calls",
     "SIP supports both outbound and inbound calls. Setup depends on the tier:",
-    "- Outbound (Pro plan only): call chamade_join with platform='sip' and meeting_url='sip:+33...@provider'. Uses the user's own SIP trunk (configured in the dashboard).",
-    "- Inbound (répondeur): user activates a phone number (DID) in the dashboard. Incoming calls appear as 'ringing' in chamade_list_calls.",
+    "- Outbound (Pro plan only): call chamade_call_join with platform='sip' and meeting_url='sip:+33...@provider'. Uses the user's own SIP trunk (configured in the dashboard).",
+    "- Inbound (répondeur): user activates a phone number (DID) in the dashboard. Incoming calls appear as 'ringing' in chamade_call_list.",
     "- Inbound (BYOT): user connects their own SIP trunk + DIDs in the dashboard. Same inbound flow.",
     "",
     "Inbound call workflow:",
-    "1. Use chamade_list_calls to see ringing calls (poll regularly).",
-    "2. Use chamade_answer to pick up the call.",
-    "3. Use chamade_say to speak and chamade_status to read transcript (same as outbound).",
+    "1. Use chamade_call_list to see ringing calls (poll regularly).",
+    "2. Use chamade_call_accept to pick up the call.",
+    "3. Use chamade_call_say to speak and chamade_call_status to read transcript (same as outbound).",
     "4. If auto_answer is enabled, calls go straight to 'active' — no need to answer.",
+    "5. Use chamade_call_refuse to reject a ringing call.",
     "",
     "## Recovery from disconnection",
     "If the bridge restarts or connection is lost, the call state becomes 'disconnected'.",
-    "chamade_status will show instructions to reconnect.",
-    "To recover: call chamade_join again with the same platform and meeting_url.",
+    "chamade_call_status will show instructions to reconnect.",
+    "To recover: call chamade_call_join again with the same platform and meeting_url.",
     "A new call_id is issued. Previous transcript is lost.",
     "",
     "## DM / Messaging workflow",
     "1. Use chamade_inbox to check for incoming DM conversations.",
-    "2. Before composing a reply, use chamade_typing to show the user you are working on it.",
-    "3. Use chamade_send to reply to a conversation.",
-    "4. When a conversation has a call_id (voice_started), use chamade_say/chamade_status on it.",
+    "2. Before composing a reply, use chamade_dm_typing to show the user you are working on it.",
+    "3. Use chamade_dm_chat to reply — specify the platform (e.g. 'teams', 'discord').",
+    "4. When a call_invite event has a call_id, use chamade_call_say/chamade_call_status on that call.",
     "",
     "## Capabilities",
     "Each call and conversation returns a capabilities array. Meaning:",
     "- listen: receive audio transcripts (STT)",
-    "- speak: send audio via TTS (chamade_say)",
+    "- speak: send audio via TTS (chamade_call_say)",
     "- read: receive text chat messages",
-    "- write: send text chat messages (chamade_chat)",
-    "- typing: typing indicator supported (chamade_typing)",
+    "- write: send text chat messages (chamade_call_chat)",
+    "- typing: typing indicator supported",
     "- files: file sharing supported",
     "",
     "Per-platform defaults:",
     "- discord/teams: listen, speak, read, write, typing, files (full voice + chat)",
-    "- meet: listen, read, write (no TTS — use chamade_chat instead). Note: chat (read/write) only works for calendar-scheduled meetings. Ad-hoc Meet links have no chat API access. IMPORTANT: when the bot joins a Meet call, a participant in the meeting must manually accept it (Google shows a 'Someone wants to join' popup). Tell the user to accept the bot in the Meet UI.",
+    "- meet: listen, read, write (no TTS — use chamade_call_chat instead). Note: chat (read/write) only works for calendar-scheduled meetings. Ad-hoc Meet links have no chat API access. IMPORTANT: when the bot joins a Meet call, a participant in the meeting must manually accept it (Google shows a 'Someone wants to join' popup). Tell the user to accept the bot in the Meet UI.",
     "- zoom: listen, speak, read, write, files",
     "- telegram: read, write, typing, files (text DM only, no voice join)",
     "- whatsapp: read, write (text DM only, no voice join, no typing indicator)",
@@ -143,7 +151,7 @@ const BASE_INSTRUCTIONS = [
     "- nctalk: listen, speak, read, write, typing",
     "- slack: read, write, files (text only, no voice — Huddles have no API)",
     "",
-    "If 'speak' is not in capabilities, use chamade_chat to send text instead of chamade_say.",
+    "If 'speak' is not in capabilities, use chamade_call_chat to send text instead of chamade_call_say.",
     "",
     "## Platform requirements",
     "Each platform requires specific setup. Use chamade_account to check what is already configured.",
@@ -173,8 +181,8 @@ const BASE_INSTRUCTIONS = [
     "- \"Voice quota exceeded\" → monthly voice minutes used up (free plan: 10 min/month)",
     "- \"SIP not available on free plan\" → user needs to upgrade to Pro for SIP calls",
     "- \"No SIP trunk configured\" → user needs to connect a SIP trunk in the dashboard for outbound SIP",
-    "- \"Direct audio requires a Pro plan\" → direct audio streaming (raw PCM via WebSocket) is Pro only. Free users can still use chamade_say (TTS) within their voice quota",
-    "- \"Slack does not support voice calls\" → use chamade_inbox/chamade_send for Slack messaging instead",
+    "- \"Direct audio requires a Pro plan\" → direct audio streaming (raw PCM via WebSocket) is Pro only. Free users can still use chamade_call_say (TTS) within their voice quota",
+    "- \"Slack does not support voice calls\" → use chamade_inbox/chamade_dm_chat for Slack messaging instead",
     "",
     "## Account management",
     `Chamade is fully bot-friendly. All account management (API keys, bot tokens, platform connections, SIP, billing) is available via the REST API at the same endpoints the dashboard uses. See ${CHAMADE_URL}/llms.txt for the full machine-readable documentation. This MCP server focuses on runtime operations (calls + messaging); use the REST API directly for account setup and configuration.`,
@@ -196,15 +204,18 @@ const INSTRUCTIONS = CHANNEL_MODE
 // ---------------------------------------------------------------------------
 const server = new McpServer({
     name: "chamade",
-    version: "1.1.0",
+    version: "2.0.0",
 }, {
     capabilities: CHANNEL_MODE
         ? { experimental: { "claude/channel": {} } }
         : undefined,
     instructions: INSTRUCTIONS,
 });
-// -- Tool: join -------------------------------------------------------------
-server.tool("chamade_join", "Join a voice meeting on any platform (Discord, Teams, Meet, Telegram, SIP, WhatsApp). Returns a call_id. After joining, poll chamade_status regularly to read new transcript lines. Use chamade_say to speak (TTS) and chamade_leave to hang up. Keep the call active — do NOT leave between exchanges.", {
+// ===========================================================================
+// CALL TOOLS
+// ===========================================================================
+// -- Tool: call_join ----------------------------------------------------------
+server.tool("chamade_call_join", "Join a voice meeting on any platform (Discord, Teams, Meet, Telegram, SIP, WhatsApp). Returns a call_id. After joining, poll chamade_call_status regularly to read new transcript lines. Use chamade_call_say to speak (TTS) and chamade_call_leave to hang up. Keep the call active — do NOT leave between exchanges.", {
     platform: z
         .enum(["discord", "teams", "meet", "telegram", "sip", "nctalk", "zoom", "whatsapp"])
         .describe("Meeting platform"),
@@ -245,13 +256,13 @@ server.tool("chamade_join", "Join a voice meeting on any platform (Discord, Team
         lines.push(`Audio: ${audio.sample_rate}Hz ${audio.format} (${audio.frame_duration_ms}ms frames, ${audio.frame_bytes} bytes/frame)`);
     }
     if (!capabilities.includes("speak")) {
-        lines.push(`Note: TTS (speak) is not supported on ${platform}. Use chamade_chat to send text instead.`);
+        lines.push(`Note: TTS (speak) is not supported on ${platform}. Use chamade_call_chat to send text instead.`);
     }
     if (CHANNEL_MODE) {
-        lines.push(``, `Transcript will be pushed automatically. Use chamade_say to speak, chamade_chat to send text, chamade_leave to hang up.`);
+        lines.push(``, `Transcript will be pushed automatically. Use chamade_call_say to speak, chamade_call_chat to send text, chamade_call_leave to hang up.`);
     }
     else {
-        lines.push(`Transcript: chamade://calls/${callId}/transcript`, ``, `Use chamade_say to speak, chamade_chat to send text, chamade_status to check transcript, chamade_leave to hang up.`);
+        lines.push(`Transcript: chamade://calls/${callId}/transcript`, ``, `Use chamade_call_say to speak, chamade_call_chat to send text, chamade_call_status to check transcript, chamade_call_leave to hang up.`);
     }
     return {
         content: [
@@ -262,9 +273,59 @@ server.tool("chamade_join", "Join a voice meeting on any platform (Discord, Team
         ],
     };
 });
-// -- Tool: say --------------------------------------------------------------
-server.tool("chamade_say", "Speak text aloud in the meeting via TTS. Write naturally and concisely — avoid markdown, code blocks, or long lists as the text is converted to speech. Respond to the CONTENT of what people say, do not echo or repeat their words. Use punctuation to shape delivery: '...' for hesitation, '!' for energy, '—' for a pause. Use CAPS sparingly for emphasis.", {
-    call_id: z.string().describe("Call ID from chamade_join"),
+// -- Tool: call_accept --------------------------------------------------------
+server.tool("chamade_call_accept", "Answer a ringing inbound call. Use this when chamade_call_list or a call_invite event shows a call in 'ringing' state (incoming phone call). The call transitions to 'active' and you can start speaking.", {
+    call_id: z.string().describe("Call ID of the ringing call"),
+}, async ({ call_id }) => {
+    await chamadePost(`/api/call/${call_id}/accept`, {});
+    // Fetch call details to get real capabilities and platform
+    const data = (await chamadeGet(`/api/call/${call_id}`));
+    const platform = data.platform || "sip";
+    const capabilities = data.capabilities ?? ["listen", "speak"];
+    // Track the call locally
+    calls.set(call_id, {
+        callId: call_id,
+        platform,
+        meetingUrl: data.meeting_url || "",
+        capabilities,
+        lastTranscriptLength: 0,
+    });
+    // Channel mode: auto-watch for transcript push
+    if (CHANNEL_MODE) {
+        channelWatchCall(call_id);
+    }
+    const lines = [
+        `Answered call ${call_id}.`,
+        `State: active`,
+        `Capabilities: ${capabilities.join(", ")}`,
+        ``,
+        `Use chamade_call_say to speak, chamade_call_status to check transcript, chamade_call_leave to hang up.`,
+    ];
+    if (!capabilities.includes("speak")) {
+        lines.push(`Note: TTS (speak) is not supported on ${platform}. Use chamade_call_chat to send text instead.`);
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: lines.join("\n"),
+            },
+        ],
+    };
+});
+// -- Tool: call_refuse --------------------------------------------------------
+server.tool("chamade_call_refuse", "Refuse (reject) a ringing inbound call. The call is ended and the caller hears a disconnect.", {
+    call_id: z.string().describe("Call ID of the ringing call"),
+}, async ({ call_id }) => {
+    await chamadePost(`/api/call/${call_id}/refuse`, {});
+    calls.delete(call_id);
+    return {
+        content: [{ type: "text", text: `Refused call ${call_id}.` }],
+    };
+});
+// -- Tool: call_say -----------------------------------------------------------
+server.tool("chamade_call_say", "Speak text aloud in the meeting via TTS. Write naturally and concisely — avoid markdown, code blocks, or long lists as the text is converted to speech. Respond to the CONTENT of what people say, do not echo or repeat their words. Use punctuation to shape delivery: '...' for hesitation, '!' for energy, '—' for a pause. Use CAPS sparingly for emphasis.", {
+    call_id: z.string().describe("Call ID from chamade_call_join"),
     text: z.string().describe("Text to speak aloud"),
 }, async ({ call_id, text }) => {
     await chamadePost(`/api/call/${call_id}/say`, { text });
@@ -272,19 +333,32 @@ server.tool("chamade_say", "Speak text aloud in the meeting via TTS. Write natur
         content: [{ type: "text", text: `Speaking: "${text}"` }],
     };
 });
-// -- Tool: chat -------------------------------------------------------------
-server.tool("chamade_chat", "Send a text chat message in the meeting.", {
-    call_id: z.string().describe("Call ID from chamade_join"),
+// -- Tool: call_chat ----------------------------------------------------------
+server.tool("chamade_call_chat", "Send a text chat message in the meeting. Set sender_name to identify yourself (e.g. your name or 'AI Assistant').", {
+    call_id: z.string().describe("Call ID from chamade_call_join"),
     text: z.string().describe("Chat message to send"),
-}, async ({ call_id, text }) => {
-    await chamadePost(`/api/call/${call_id}/chat`, { text });
+    sender_name: z.string().optional().describe("Display name shown in the chat (e.g. 'Claude', 'AI Assistant')"),
+}, async ({ call_id, text, sender_name }) => {
+    const body = { text };
+    if (sender_name)
+        body.sender_name = sender_name;
+    await chamadePost(`/api/call/${call_id}/chat`, body);
     return {
         content: [{ type: "text", text: `Chat sent: "${text}"` }],
     };
 });
-// -- Tool: status -----------------------------------------------------------
-server.tool("chamade_status", "Get call status and new transcript lines since last check. Poll this regularly to listen to what people are saying. Returns only new lines since the previous call (delta pattern).", {
-    call_id: z.string().describe("Call ID from chamade_join"),
+// -- Tool: call_typing --------------------------------------------------------
+server.tool("chamade_call_typing", "Send a typing indicator in the call's chat. Only works on platforms with 'typing' in capabilities.", {
+    call_id: z.string().describe("Call ID from chamade_call_join"),
+}, async ({ call_id }) => {
+    await chamadePost(`/api/call/${call_id}/typing`, {});
+    return {
+        content: [{ type: "text", text: "Typing indicator sent." }],
+    };
+});
+// -- Tool: call_status --------------------------------------------------------
+server.tool("chamade_call_status", "Get call status and new transcript lines since last check. Poll this regularly to listen to what people are saying. Returns only new lines since the previous call (delta pattern).", {
+    call_id: z.string().describe("Call ID from chamade_call_join"),
 }, async ({ call_id }) => {
     const state = calls.get(call_id);
     const since = state?.lastTranscriptLength ?? 0;
@@ -317,15 +391,15 @@ server.tool("chamade_status", "Get call status and new transcript lines since la
         data.ended_at ? `Ended: ${data.ended_at}` : "",
     ];
     if (data.state === "ringing") {
-        statusLines.push(``, `Incoming call! Use chamade_answer to pick up, or chamade_leave to reject.`);
+        statusLines.push(``, `Incoming call! Use chamade_call_accept to pick up, or chamade_call_refuse to reject.`);
     }
     if (data.state === "disconnected") {
         const meetingUrl = state?.meetingUrl || data.meeting_url || "";
         const platform = state?.platform || data.platform || "";
-        statusLines.push(``, `⚠ Bridge connection lost. The voice session has been interrupted.`, `To reconnect, call chamade_join again with platform="${platform}" and meeting_url="${meetingUrl}".`, `A new call_id will be issued. Previous transcript is lost.`);
+        statusLines.push(``, `Bridge connection lost. The voice session has been interrupted.`, `To reconnect, call chamade_call_join again with platform="${platform}" and meeting_url="${meetingUrl}".`, `A new call_id will be issued. Previous transcript is lost.`);
     }
     if (!capabilities.includes("speak")) {
-        statusLines.push(`Note: TTS (speak) is not supported on ${data.platform}. Use chamade_chat to send text instead.`);
+        statusLines.push(`Note: TTS (speak) is not supported on ${data.platform}. Use chamade_call_chat to send text instead.`);
     }
     return {
         content: [
@@ -338,73 +412,9 @@ server.tool("chamade_status", "Get call status and new transcript lines since la
         ],
     };
 });
-// -- Tool: answer -----------------------------------------------------------
-server.tool("chamade_answer", "Answer a ringing inbound call. Use this when chamade_list_calls or chamade_status shows a call in 'ringing' state (incoming phone call). The call transitions to 'active' and you can start speaking.", {
-    call_id: z.string().describe("Call ID of the ringing call"),
-}, async ({ call_id }) => {
-    await chamadePost(`/api/call/${call_id}/answer`, {});
-    // Fetch call details to get real capabilities and platform
-    const data = (await chamadeGet(`/api/call/${call_id}`));
-    const platform = data.platform || "sip";
-    const capabilities = data.capabilities ?? ["listen", "speak"];
-    // Track the call locally
-    calls.set(call_id, {
-        callId: call_id,
-        platform,
-        meetingUrl: data.meeting_url || "",
-        capabilities,
-        lastTranscriptLength: 0,
-    });
-    // Channel mode: auto-watch for transcript push
-    if (CHANNEL_MODE) {
-        channelWatchCall(call_id);
-    }
-    const lines = [
-        `Answered call ${call_id}.`,
-        `State: active`,
-        `Capabilities: ${capabilities.join(", ")}`,
-        ``,
-        `Use chamade_say to speak, chamade_status to check transcript, chamade_leave to hang up.`,
-    ];
-    if (!capabilities.includes("speak")) {
-        lines.push(`Note: TTS (speak) is not supported on ${platform}. Use chamade_chat to send text instead.`);
-    }
-    return {
-        content: [
-            {
-                type: "text",
-                text: lines.join("\n"),
-            },
-        ],
-    };
-});
-// -- Tool: typing -----------------------------------------------------------
-server.tool("chamade_typing", "Send a typing indicator. Use this before composing a reply so the user sees you are working on it. Only works on platforms with 'typing' in capabilities (Discord, Teams, Telegram, NC Talk).", {
-    call_id: z
-        .string()
-        .optional()
-        .describe("Call ID (for typing in a call's chat)"),
-    conversation_id: z
-        .string()
-        .optional()
-        .describe("Conversation ID (for typing in a DM)"),
-}, async ({ call_id, conversation_id }) => {
-    if (call_id) {
-        await chamadePost(`/api/call/${call_id}/typing`, {});
-    }
-    else if (conversation_id) {
-        await chamadePost("/api/typing", { conversation_id });
-    }
-    else {
-        throw new Error("Either call_id or conversation_id is required");
-    }
-    return {
-        content: [{ type: "text", text: "Typing indicator sent." }],
-    };
-});
-// -- Tool: leave ------------------------------------------------------------
-server.tool("chamade_leave", "Leave the meeting and hang up. Only use when explicitly asked to leave or when the meeting is over.", {
-    call_id: z.string().describe("Call ID from chamade_join"),
+// -- Tool: call_leave ---------------------------------------------------------
+server.tool("chamade_call_leave", "Leave the meeting and hang up. Only use when explicitly asked to leave or when the meeting is over.", {
+    call_id: z.string().describe("Call ID from chamade_call_join"),
 }, async ({ call_id }) => {
     calls.delete(call_id);
     // Channel mode: stop watching
@@ -416,8 +426,8 @@ server.tool("chamade_leave", "Leave the meeting and hang up. Only use when expli
         content: [{ type: "text", text: `Left call ${call_id}.` }],
     };
 });
-// -- Tool: list_calls -------------------------------------------------------
-server.tool("chamade_list_calls", "List all active calls.", {}, async () => {
+// -- Tool: call_list ----------------------------------------------------------
+server.tool("chamade_call_list", "List all active calls.", {}, async () => {
     const data = (await chamadeGet("/api/calls"));
     if (data.calls.length === 0) {
         return {
@@ -434,57 +444,63 @@ server.tool("chamade_list_calls", "List all active calls.", {}, async () => {
         content: [{ type: "text", text: lines.join("\n") }],
     };
 });
-// -- Tool: account ----------------------------------------------------------
-server.tool("chamade_account", "Check account status: plan, credit/quota remaining, and per-platform readiness (ok, not_configured, error). Use this to diagnose setup issues or check remaining credit before making calls.", {}, async () => {
-    const data = (await chamadeGet("/api/account"));
-    const lines = [`Plan: ${data.plan}`];
-    // Credit or voice quota
-    const credit = data.credit;
-    const voice = data.voice_quota;
-    if (credit) {
-        lines.push(`Credit: ${credit.remaining_eur.toFixed(2)} EUR remaining (${credit.used_eur.toFixed(2)} / ${credit.total_eur.toFixed(2)} EUR used)`);
-    }
-    else if (voice) {
-        lines.push(`Voice quota: ${voice.used_minutes.toFixed(1)} / ${voice.limit_minutes} min used`);
-    }
-    const concurrent = data.concurrent_calls;
-    if (concurrent) {
-        const limitStr = concurrent.limit === 0 ? "unlimited" : String(concurrent.limit);
-        lines.push(`Active calls: ${concurrent.active} / ${limitStr}`);
-    }
-    // Platform statuses
-    const platforms = data.platforms;
-    if (platforms) {
-        lines.push("", "Platforms:");
-        for (const [name, status] of Object.entries(platforms)) {
-            const icon = status.startsWith("ok") ? "+" : status.startsWith("error") ? "!" : "-";
-            lines.push(`  ${icon} ${name}: ${status}`);
-        }
-    }
+// ===========================================================================
+// DM TOOLS
+// ===========================================================================
+// -- Tool: dm_chat ------------------------------------------------------------
+server.tool("chamade_dm_chat", "Send a message to the active DM conversation on a platform. The message will be delivered to the user on their platform (Discord, Telegram, Teams, etc.).", {
+    platform: z
+        .enum(["discord", "teams", "telegram", "whatsapp", "slack", "nctalk"])
+        .describe("Platform where the DM conversation is active"),
+    text: z.string().describe("Message text to send"),
+}, async ({ platform, text }) => {
+    channelStopTyping(platform);
+    const data = (await chamadePost("/api/dm/chat", {
+        platform,
+        text,
+    }));
     return {
-        content: [{ type: "text", text: lines.join("\n") }],
+        content: [
+            {
+                type: "text",
+                text: `Message sent to ${platform} (${data.delivery || "async"}): "${text}"`,
+            },
+        ],
     };
 });
-// -- Tool: inbox ------------------------------------------------------------
-server.tool("chamade_inbox", "Check inbox for DM conversations. Without conversation_id, lists all active conversations. With conversation_id, returns details and message history. When a voice_started event appears, use chamade_say/chamade_status with the provided call_id.", {
-    conversation_id: z
-        .string()
+// -- Tool: dm_typing ----------------------------------------------------------
+server.tool("chamade_dm_typing", "Send a typing indicator on a DM conversation. Use this before composing a reply so the user sees you are working on it. Only works on platforms with 'typing' in capabilities (Discord, Teams, Telegram, NC Talk).", {
+    platform: z
+        .enum(["discord", "teams", "telegram", "whatsapp", "slack", "nctalk"])
+        .describe("Platform where the DM conversation is active"),
+}, async ({ platform }) => {
+    await chamadePost("/api/dm/typing", { platform });
+    return {
+        content: [{ type: "text", text: `Typing indicator sent on ${platform}.` }],
+    };
+});
+// ===========================================================================
+// OTHER TOOLS
+// ===========================================================================
+// -- Tool: inbox --------------------------------------------------------------
+server.tool("chamade_inbox", "Check inbox for DM conversations. Without a platform, lists all active conversations. With a platform, returns the active DM conversation details and message history for that platform.", {
+    platform: z
+        .enum(["discord", "teams", "telegram", "whatsapp", "slack", "nctalk"])
         .optional()
-        .describe("Optional conversation ID to get details and messages"),
+        .describe("Optional: get messages for a specific platform's DM"),
     limit: z
         .number()
         .default(20)
         .describe("Max messages to return (when viewing a conversation)"),
-}, async ({ conversation_id, limit }) => {
-    if (conversation_id) {
-        const data = (await chamadeGet(`/api/inbox/${conversation_id}?limit=${limit}`));
+}, async ({ platform, limit }) => {
+    if (platform) {
+        const data = (await chamadeGet(`/api/inbox?platform=${platform}&limit=${limit}`));
         const conv = data.conversation;
         const messages = data.messages;
         const capabilities = conv.capabilities ?? [];
         const lines = [
-            `Conversation: ${conv.id}`,
             `Platform: ${conv.platform}`,
-            `Contact: ${conv.remote_name || conv.remote_id}`,
+            `Contact: ${conv.remote_name || "unknown"}`,
             `Type: ${conv.channel_type}`,
             `Capabilities: ${capabilities.join(", ") || "text"}`,
             `Messages: ${conv.message_count}`,
@@ -517,32 +533,44 @@ server.tool("chamade_inbox", "Check inbox for DM conversations. Without conversa
         const capabilities = c.capabilities ?? [];
         const cap = capabilities.length > 0 ? ` [${capabilities.join(",")}]` : "";
         const callInfo = c.call_id ? ` (voice: ${c.call_id})` : "";
-        return `- ${c.id} (${c.platform}) — ${c.remote_name || c.remote_id} — ${c.message_count} msgs${cap}${callInfo}`;
+        return `- ${c.platform} — ${c.remote_name || "unknown"} — ${c.message_count} msgs${cap}${callInfo}`;
     });
     return {
         content: [{ type: "text", text: lines.join("\n") }],
     };
 });
-// -- Tool: send -------------------------------------------------------------
-server.tool("chamade_send", "Send a message to a DM conversation. The message will be delivered to the user on their platform (Discord, Telegram, etc.).", {
-    conversation_id: z.string().describe("Conversation ID from chamade_inbox"),
-    text: z.string().describe("Message text to send"),
-}, async ({ conversation_id, text }) => {
-    channelStopTyping(conversation_id);
-    const data = (await chamadePost("/api/send", {
-        conversation_id,
-        text,
-    }));
+// -- Tool: account ------------------------------------------------------------
+server.tool("chamade_account", "Check account status: plan, credit/quota remaining, and per-platform readiness (ok, not_configured, error). Use this to diagnose setup issues or check remaining credit before making calls.", {}, async () => {
+    const data = (await chamadeGet("/api/account"));
+    const lines = [`Plan: ${data.plan}`];
+    // Credit or voice quota
+    const credit = data.credit;
+    const voice = data.voice_quota;
+    if (credit) {
+        lines.push(`Credit: ${credit.remaining_eur.toFixed(2)} EUR remaining (${credit.used_eur.toFixed(2)} / ${credit.total_eur.toFixed(2)} EUR used)`);
+    }
+    else if (voice) {
+        lines.push(`Voice quota: ${voice.used_minutes.toFixed(1)} / ${voice.limit_minutes} min used`);
+    }
+    const concurrent = data.concurrent_calls;
+    if (concurrent) {
+        const limitStr = concurrent.limit === 0 ? "unlimited" : String(concurrent.limit);
+        lines.push(`Active calls: ${concurrent.active} / ${limitStr}`);
+    }
+    // Platform statuses
+    const platforms = data.platforms;
+    if (platforms) {
+        lines.push("", "Platforms:");
+        for (const [name, status] of Object.entries(platforms)) {
+            const icon = status.startsWith("ok") ? "+" : status.startsWith("error") ? "!" : "-";
+            lines.push(`  ${icon} ${name}: ${status}`);
+        }
+    }
     return {
-        content: [
-            {
-                type: "text",
-                text: `Message sent (${data.delivery || "async"}): "${text}"`,
-            },
-        ],
+        content: [{ type: "text", text: lines.join("\n") }],
     };
 });
-// -- Resource: transcript ---------------------------------------------------
+// -- Resource: transcript -----------------------------------------------------
 const transcriptTemplate = new ResourceTemplate("chamade://calls/{call_id}/transcript", {
     list: async () => {
         return {
@@ -599,18 +627,18 @@ const _callWatchers = new Map();
 const _closedWatchers = new Set();
 const _typingActive = new Set();
 /**
- * Start typing indicator for a conversation.
+ * Start typing indicator for a DM conversation (keyed by platform).
  * Sends a single POST — Maquisard manages the repeat loop internally
  * and stops it automatically when a message is sent.
  */
-function channelStartTyping(conversationId) {
-    if (_typingActive.has(conversationId))
+function channelStartTyping(platform) {
+    if (_typingActive.has(platform))
         return;
-    _typingActive.add(conversationId);
-    chamadePost("/api/typing", { conversation_id: conversationId }).catch(() => { });
+    _typingActive.add(platform);
+    chamadePost("/api/dm/typing", { platform }).catch(() => { });
 }
-function channelStopTyping(conversationId) {
-    _typingActive.delete(conversationId);
+function channelStopTyping(platform) {
+    _typingActive.delete(platform);
 }
 /**
  * Push a channel notification to Claude Code.
@@ -635,6 +663,12 @@ async function channelPush(content, meta = {}) {
 /**
  * Watch a call's transcript via WebSocket push.
  * Opens a WS to /api/call/{id}/stream and pushes each event.
+ *
+ * Events from server (already remapped by Chamade backend):
+ * - call_transcript: speaker + text
+ * - call_chat: sender + text
+ * - call_state: state changes
+ * - call_error: errors
  */
 function channelWatchCall(callId) {
     if (_callWatchers.has(callId) || _closedWatchers.has(callId))
@@ -656,28 +690,27 @@ function channelWatchCall(callId) {
             try {
                 const data = JSON.parse(raw.toString());
                 switch (data.type) {
-                    case "transcript":
+                    case "call_transcript":
                         retryCount = 0; // Real data — reset retry counter
                         if (data.is_final !== false) {
-                            await channelPush(`[${data.speaker || "?"}] ${data.text || ""}`, { type: "transcript", call_id: callId });
+                            await channelPush(`[${data.speaker || "?"}] ${data.text || ""}`, { type: "call_transcript", call_id: callId });
                         }
                         break;
-                    case "chat":
-                    case "chat_received":
-                        await channelPush(`[chat:${data.sender || "?"}] ${data.text || ""}`, { type: "chat", call_id: callId });
+                    case "call_chat":
+                        await channelPush(`[chat:${data.sender || "?"}] ${data.text || ""}`, { type: "call_chat", call_id: callId });
                         break;
-                    case "state":
-                        await channelPush(`Call state: ${data.state}`, { type: "state", call_id: callId });
+                    case "call_state":
+                        await channelPush(`Call state: ${data.state}`, { type: "call_state", call_id: callId });
                         if (data.state === "ended" || data.state === "error") {
                             channelUnwatchCall(callId);
                         }
                         break;
-                    case "error":
-                        await channelPush(`Call error: ${data.message || data.code || "unknown"}`, { type: "error", call_id: callId });
+                    case "call_error":
+                        await channelPush(`Call error: ${data.message || data.code || "unknown"}`, { type: "call_error", call_id: callId });
                         // Stop watching on any terminal error
                         channelUnwatchCall(callId);
                         if (data.code === "bridge_disconnected") {
-                            await channelPush(`Bridge connection lost for call ${callId}. Use chamade_join with the same meeting_url to reconnect.`, { type: "disconnected", call_id: callId });
+                            await channelPush(`Bridge connection lost for call ${callId}. Use chamade_call_join with the same meeting_url to reconnect.`, { type: "call_state", call_id: callId });
                         }
                         break;
                 }
@@ -696,7 +729,7 @@ function channelWatchCall(callId) {
             else if (!_closedWatchers.has(callId)) {
                 console.error(`[chamade-channel] Call ${callId}: max retries (${MAX_RETRIES}) reached, giving up`);
                 channelUnwatchCall(callId);
-                channelPush(`Call ${callId} ended (connection lost). Use chamade_leave to clean up, or chamade_join to reconnect.`, { type: "call_ended", call_id: callId });
+                channelPush(`Call ${callId} ended (connection lost). Use chamade_call_leave to clean up, or chamade_call_join to reconnect.`, { type: "call_state", call_id: callId });
             }
         });
         ws.on("error", () => {
@@ -722,6 +755,13 @@ function channelUnwatchCall(callId) {
 /**
  * Watch inbox for DMs, incoming calls, and conversation events.
  * Reconnects automatically on disconnect.
+ *
+ * Events from server (already remapped by Chamade backend):
+ * - dm_chat: new DM message
+ * - dm_started: new DM conversation
+ * - dm_ended: DM conversation closed
+ * - call_invite: incoming call (SIP or DM voice)
+ * - call_state: call state change (disconnected, etc.)
  */
 function channelWatchInbox() {
     let retryDelay = 1000;
@@ -747,46 +787,34 @@ function channelWatchInbox() {
             try {
                 const data = JSON.parse(raw.toString());
                 switch (data.type) {
-                    case "message":
-                        // Auto-send repeating typing indicator until chamade_send replies
-                        if (data.conversation_id) {
-                            channelStartTyping(data.conversation_id);
+                    case "dm_chat":
+                        // Auto-send typing indicator by platform
+                        if (data.platform) {
+                            channelStartTyping(data.platform);
                         }
                         await channelPush(`New message from ${data.sender_name || "unknown"} on ${data.platform}: "${data.text}"`, {
-                            type: "message",
-                            conversation_id: data.conversation_id || "",
+                            type: "dm_chat",
                             platform: data.platform || "",
                         });
                         break;
-                    case "incoming_call":
-                        await channelPush(`Incoming call from ${data.caller || "unknown"}${data.did ? ` on ${data.did}` : ""}. Call ID: ${data.call_id}. Use chamade_answer to pick up.`, { type: "incoming_call", call_id: data.call_id || "" });
-                        // Auto-watch if already active (auto_answer)
+                    case "call_invite":
+                        await channelPush(`Incoming call${data.caller ? ` from ${data.caller}` : ""} on ${data.platform || "sip"}. Call ID: ${data.call_id}. State: ${data.state || "ringing"}. Use chamade_call_accept to pick up.`, { type: "call_invite", call_id: data.call_id || "" });
+                        // Auto-watch if already active (auto_answer or DM voice)
                         if (data.state === "active" && data.call_id) {
                             channelWatchCall(data.call_id);
                         }
                         break;
-                    case "voice_started":
-                        await channelPush(`Voice started. Call ID: ${data.call_id}. Platform: ${data.platform}.`, {
-                            type: "voice_started",
-                            call_id: data.call_id || "",
-                            conversation_id: data.conversation_id || "",
-                        });
-                        if (data.call_id) {
-                            channelWatchCall(data.call_id);
-                        }
-                        break;
-                    case "conversation_started":
+                    case "dm_started":
                         await channelPush(`New conversation from ${data.remote_name || "unknown"} on ${data.platform}.`, {
-                            type: "conversation",
-                            conversation_id: data.conversation_id || "",
+                            type: "dm_started",
                             platform: data.platform || "",
                         });
                         break;
-                    case "conversation_ended":
-                        await channelPush(`Conversation ended.`, { type: "conversation_ended", conversation_id: data.conversation_id || "" });
+                    case "dm_ended":
+                        await channelPush(`Conversation ended on ${data.platform || "unknown"}.`, { type: "dm_ended", platform: data.platform || "" });
                         break;
-                    case "call_disconnected":
-                        await channelPush(`Call disconnected: ${data.message || "connection lost"}. Call ID: ${data.call_id}.`, { type: "call_disconnected", call_id: data.call_id || "" });
+                    case "call_state":
+                        await channelPush(`Call ${data.call_id}: ${data.state}${data.message ? ` — ${data.message}` : ""}`, { type: "call_state", call_id: data.call_id || "" });
                         break;
                 }
             }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@chamade/mcp-server",
-  "version": "1.1.7",
+  "version": "2.0.0",
   "description": "MCP server for Chamade — voice gateway for AI agents. Join Discord, Teams, Meet, Telegram, SIP, Zoom meetings and interact via speech and text. Supports Claude Code channel mode for push events.",
   "type": "module",
   "bin": {