@multimail/mcp-server 0.1.1 → 0.1.3

package/dist/index.js

@@ -11,6 +11,15 @@ if (!API_KEY) {
     process.exit(1);
 }
 // --- API Client ---
+async function parseResponse(res) {
+    const text = await res.text();
+    try {
+        return JSON.parse(text);
+    }
+    catch {
+        throw new Error(`API returned non-JSON response (${res.status}): ${text.slice(0, 200)}`);
+    }
+}
 async function apiCall(method, path, body) {
     const url = `${BASE_URL}${path}`;
     const headers = {
@@ -22,7 +31,7 @@ async function apiCall(method, path, body) {
         headers,
         body: body ? JSON.stringify(body) : undefined,
     });
-    const data = await res.json();
+    const data = await parseResponse(res);
     if (!res.ok) {
         if (res.status === 401) {
             throw new Error("Invalid API key. Check MULTIMAIL_API_KEY environment variable.");
@@ -34,16 +43,16 @@ async function apiCall(method, path, body) {
             const retryAfter = res.headers.get("retry-after") || "unknown";
             throw new Error(`Rate limit exceeded. Retry after ${retryAfter} seconds.`);
         }
-        throw new Error(`API error ${res.status}: ${JSON.stringify(data)}`);
+        throw new Error(`API error ${res.status}: ${data.error || JSON.stringify(data)}`);
     }
     return data;
 }
 async function publicFetch(path) {
     const url = `${BASE_URL}${path}`;
     const res = await fetch(url, { headers: { "Accept": "application/json" } });
-    const data = await res.json();
+    const data = await parseResponse(res);
     if (!res.ok) {
-        throw new Error(`API error ${res.status}: ${JSON.stringify(data)}`);
+        throw new Error(`API error ${res.status}: ${data.error || JSON.stringify(data)}`);
     }
     return data;
 }
@@ -59,7 +68,7 @@ function getMailboxId(argsMailboxId) {
 // --- Server ---
 const server = new McpServer({
     name: "multimail",
-    version: "0.1.0",
+    version: "0.1.3",
 });
 // Tool 1: list_mailboxes
 server.tool("list_mailboxes", "List all mailboxes available to this API key. Returns each mailbox's ID, email address, oversight mode, and display name. Use this to discover your mailbox ID if MULTIMAIL_MAILBOX_ID is not set.", {}, async () => {
@@ -68,10 +77,10 @@ server.tool("list_mailboxes", "List all mailboxes available to this API key. Ret
 });
 // Tool 2: send_email
 server.tool("send_email", "Send an email from your MultiMail address. The body is written in markdown and automatically converted to formatted HTML for delivery. If the mailbox uses gated oversight, the response status will be 'pending_approval' — this means the email is queued for human review. Do not retry or resend when you see pending_approval.", {
-    to: z.array(z.string()).describe("Recipient email addresses"),
+    to: z.array(z.string().email()).describe("Recipient email addresses"),
     subject: z.string().describe("Email subject line"),
     markdown: z.string().describe("Email body in markdown format"),
-    cc: z.array(z.string()).optional().describe("CC email addresses"),
+    cc: z.array(z.string().email()).optional().describe("CC email addresses"),
     mailbox_id: z.string().optional().describe("Mailbox ID (uses MULTIMAIL_MAILBOX_ID env var if not provided)"),
 }, async ({ to, subject, markdown, cc, mailbox_id }) => {
     const id = getMailboxId(mailbox_id);
@@ -104,7 +113,7 @@ server.tool("read_email", "Get the full content of a specific email, including t
 server.tool("reply_email", "Reply to an email in its existing thread. Threading headers (In-Reply-To, References) are set automatically. The body is written in markdown. If the mailbox uses gated oversight, the response status will be 'pending_approval' — the reply is queued for human review. Do not retry or resend when you see pending_approval.", {
     email_id: z.string().describe("The email ID to reply to"),
     markdown: z.string().describe("Reply body in markdown format"),
-    cc: z.array(z.string()).optional().describe("CC email addresses"),
+    cc: z.array(z.string().email()).optional().describe("CC email addresses"),
     mailbox_id: z.string().optional().describe("Mailbox ID (uses MULTIMAIL_MAILBOX_ID env var if not provided)"),
 }, async ({ email_id, markdown, cc, mailbox_id }) => {
     const id = getMailboxId(mailbox_id);
@@ -116,7 +125,7 @@ server.tool("reply_email", "Reply to an email in its existing thread. Threading
 });
 // Tool 6: search_identity
 server.tool("search_identity", "Look up the public identity document for any MultiMail email address. Returns the agent's operator, oversight mode, capabilities, and whether the operator is verified. No authentication required. Use this to verify another agent's identity before sending sensitive information.", {
-    address: z.string().describe("The email address to look up (e.g. sandy@multimail.dev)"),
+    address: z.string().email().describe("The email address to look up (e.g. sandy@multimail.dev)"),
 }, async ({ address }) => {
     const data = await publicFetch(`/.well-known/agent/${encodeURIComponent(address)}`);
     return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };

package/package.json

@@ -1,19 +1,34 @@
 {
   "name": "@multimail/mcp-server",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "MCP server for MultiMail — email for AI agents",
   "type": "module",
   "bin": {
     "multimail-mcp": "./dist/index.js"
   },
   "main": "./dist/index.js",
+  "files": [
+    "dist/",
+    "README.md",
+    "LICENSE"
+  ],
   "scripts": {
     "build": "tsc",
     "start": "node dist/index.js",
-    "dev": "tsx src/index.ts"
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "tsc"
   },
-  "keywords": ["mcp", "email", "ai-agents", "multimail", "model-context-protocol"],
+  "keywords": [
+    "mcp",
+    "email",
+    "ai-agents",
+    "multimail",
+    "model-context-protocol"
+  ],
   "license": "MIT",
+  "engines": {
+    "node": ">=18.0.0"
+  },
   "author": {
     "name": "MultiMail",
     "email": "dev@multimail.dev",
@@ -23,6 +38,7 @@
     "type": "git",
     "url": "https://github.com/multimail-dev/mcp-server.git"
   },
+  "mcpName": "io.github.multimail-dev/mcp-server",
   "homepage": "https://multimail.dev",
   "bugs": {
     "email": "dev@multimail.dev"

package/src/index.ts

@@ -1,184 +0,0 @@
-#!/usr/bin/env node
-import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
-import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { z } from "zod";
-
-// --- Config ---
-
-const API_KEY = process.env.MULTIMAIL_API_KEY;
-const DEFAULT_MAILBOX_ID = process.env.MULTIMAIL_MAILBOX_ID;
-const BASE_URL = (process.env.MULTIMAIL_API_URL || "https://api.multimail.dev").replace(/\/$/, "");
-
-if (!API_KEY) {
-  console.error("MULTIMAIL_API_KEY environment variable is required.");
-  process.exit(1);
-}
-
-// --- API Client ---
-
-async function apiCall(method: string, path: string, body?: unknown): Promise<unknown> {
-  const url = `${BASE_URL}${path}`;
-  const headers: Record<string, string> = {
-    "Authorization": `Bearer ${API_KEY}`,
-    "Content-Type": "application/json",
-  };
-
-  const res = await fetch(url, {
-    method,
-    headers,
-    body: body ? JSON.stringify(body) : undefined,
-  });
-
-  const data = await res.json() as Record<string, unknown>;
-
-  if (!res.ok) {
-    if (res.status === 401) {
-      throw new Error("Invalid API key. Check MULTIMAIL_API_KEY environment variable.");
-    }
-    if (res.status === 403) {
-      throw new Error(`API key lacks required scope for this operation. ${(data as Record<string, unknown>).error || ""}`);
-    }
-    if (res.status === 429) {
-      const retryAfter = res.headers.get("retry-after") || "unknown";
-      throw new Error(`Rate limit exceeded. Retry after ${retryAfter} seconds.`);
-    }
-    throw new Error(`API error ${res.status}: ${JSON.stringify(data)}`);
-  }
-
-  return data;
-}
-
-async function publicFetch(path: string): Promise<unknown> {
-  const url = `${BASE_URL}${path}`;
-  const res = await fetch(url, { headers: { "Accept": "application/json" } });
-  const data = await res.json();
-  if (!res.ok) {
-    throw new Error(`API error ${res.status}: ${JSON.stringify(data)}`);
-  }
-  return data;
-}
-
-function getMailboxId(argsMailboxId?: string): string {
-  const id = argsMailboxId || DEFAULT_MAILBOX_ID;
-  if (!id) {
-    throw new Error(
-      "No mailbox_id provided and MULTIMAIL_MAILBOX_ID is not set. " +
-      "Either pass mailbox_id or set the MULTIMAIL_MAILBOX_ID environment variable. " +
-      "Use list_mailboxes to discover available mailboxes."
-    );
-  }
-  return id;
-}
-
-// --- Server ---
-
-const server = new McpServer({
-  name: "multimail",
-  version: "0.1.0",
-});
-
-// Tool 1: list_mailboxes
-server.tool(
-  "list_mailboxes",
-  "List all mailboxes available to this API key. Returns each mailbox's ID, email address, oversight mode, and display name. Use this to discover your mailbox ID if MULTIMAIL_MAILBOX_ID is not set.",
-  {},
-  async () => {
-    const data = await apiCall("GET", "/v1/mailboxes");
-    return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-// Tool 2: send_email
-server.tool(
-  "send_email",
-  "Send an email from your MultiMail address. The body is written in markdown and automatically converted to formatted HTML for delivery. If the mailbox uses gated oversight, the response status will be 'pending_approval' — this means the email is queued for human review. Do not retry or resend when you see pending_approval.",
-  {
-    to: z.array(z.string()).describe("Recipient email addresses"),
-    subject: z.string().describe("Email subject line"),
-    markdown: z.string().describe("Email body in markdown format"),
-    cc: z.array(z.string()).optional().describe("CC email addresses"),
-    mailbox_id: z.string().optional().describe("Mailbox ID (uses MULTIMAIL_MAILBOX_ID env var if not provided)"),
-  },
-  async ({ to, subject, markdown, cc, mailbox_id }) => {
-    const id = getMailboxId(mailbox_id);
-    const body: Record<string, unknown> = { to, subject, markdown };
-    if (cc?.length) body.cc = cc;
-    const data = await apiCall("POST", `/v1/mailboxes/${encodeURIComponent(id)}/send`, body);
-    return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-// Tool 3: check_inbox
-server.tool(
-  "check_inbox",
-  "List emails in your inbox. Returns email summaries including id, from, to, subject, status, received_at, and has_attachments. Does NOT include the email body — call read_email with the email ID to get the full message content.",
-  {
-    status: z.enum(["unread", "read", "archived"]).optional().describe("Filter by email status (default: all)"),
-    mailbox_id: z.string().optional().describe("Mailbox ID (uses MULTIMAIL_MAILBOX_ID env var if not provided)"),
-  },
-  async ({ status, mailbox_id }) => {
-    const id = getMailboxId(mailbox_id);
-    const query = status ? `?status=${status}` : "";
-    const data = await apiCall("GET", `/v1/mailboxes/${encodeURIComponent(id)}/emails${query}`);
-    return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-// Tool 4: read_email
-server.tool(
-  "read_email",
-  "Get the full content of a specific email, including the markdown body and attachment metadata. Automatically marks unread emails as read. Use the email ID from check_inbox results.",
-  {
-    email_id: z.string().describe("The email ID to read"),
-    mailbox_id: z.string().optional().describe("Mailbox ID (uses MULTIMAIL_MAILBOX_ID env var if not provided)"),
-  },
-  async ({ email_id, mailbox_id }) => {
-    const id = getMailboxId(mailbox_id);
-    const data = await apiCall("GET", `/v1/mailboxes/${encodeURIComponent(id)}/emails/${encodeURIComponent(email_id)}`);
-    return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-// Tool 5: reply_email
-server.tool(
-  "reply_email",
-  "Reply to an email in its existing thread. Threading headers (In-Reply-To, References) are set automatically. The body is written in markdown. If the mailbox uses gated oversight, the response status will be 'pending_approval' — the reply is queued for human review. Do not retry or resend when you see pending_approval.",
-  {
-    email_id: z.string().describe("The email ID to reply to"),
-    markdown: z.string().describe("Reply body in markdown format"),
-    cc: z.array(z.string()).optional().describe("CC email addresses"),
-    mailbox_id: z.string().optional().describe("Mailbox ID (uses MULTIMAIL_MAILBOX_ID env var if not provided)"),
-  },
-  async ({ email_id, markdown, cc, mailbox_id }) => {
-    const id = getMailboxId(mailbox_id);
-    const body: Record<string, unknown> = { markdown };
-    if (cc?.length) body.cc = cc;
-    const data = await apiCall("POST", `/v1/mailboxes/${encodeURIComponent(id)}/reply/${encodeURIComponent(email_id)}`, body);
-    return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-// Tool 6: search_identity
-server.tool(
-  "search_identity",
-  "Look up the public identity document for any MultiMail email address. Returns the agent's operator, oversight mode, capabilities, and whether the operator is verified. No authentication required. Use this to verify another agent's identity before sending sensitive information.",
-  {
-    address: z.string().describe("The email address to look up (e.g. sandy@multimail.dev)"),
-  },
-  async ({ address }) => {
-    const data = await publicFetch(`/.well-known/agent/${encodeURIComponent(address)}`);
-    return { content: [{ type: "text" as const, text: JSON.stringify(data, null, 2) }] };
-  }
-);
-
-// --- Start ---
-
-async function main() {
-  const transport = new StdioServerTransport();
-  await server.connect(transport);
-}
-
-main().catch((err) => {
-  console.error("Failed to start MCP server:", err);
-  process.exit(1);
-});

package/tsconfig.json

@@ -1,16 +0,0 @@
-{
-  "compilerOptions": {
-    "target": "ES2022",
-    "module": "ES2022",
-    "moduleResolution": "bundler",
-    "lib": ["ES2022"],
-    "outDir": "./dist",
-    "strict": true,
-    "skipLibCheck": true,
-    "forceConsistentCasingInFileNames": true,
-    "resolveJsonModule": true,
-    "isolatedModules": true,
-    "declaration": true
-  },
-  "include": ["src/**/*.ts"]
-}