alienmail-mcp 1.0.0

package/README.md

@@ -0,0 +1,90 @@
+# alienmail-mcp
+
+Model Context Protocol (MCP) server for **AlienMail**. This package allows AI assistants (like Cursor, Claude, or Gemini) to securely interact with the AlienMail API to manage workspaces, marketing campaigns, leads, templates, and SMTP mailboxes directly from your AI workflows.
+
+## 🚀 Usage
+
+You do not need to clone this repository to use the MCP server. You can run it directly using `npx` in your favorite MCP-compatible AI assistant.
+
+### MCP Configuration
+
+Add the following configuration to your MCP client (e.g., Cursor or Claude Desktop):
+
+```json
+{
+  "mcpServers": {
+    "alienmail-mcp": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "alienmail-mcp"
+      ],
+      "env": {
+        "MCP_API_TOKEN": "your-alienmail-api-token"
+      }
+    }
+  }
+}
+```
+
+## ⚙️ Environment Variables
+
+The server requires the following environment variables to authenticate with the AlienMail backend:
+
+- `MCP_API_TOKEN` (or `API_TOKEN`): **Required.** Your authentication JWT token to access the AlienMail API securely.
+- `NEXT_PUBLIC_APP_URL`: *Optional.* The base URL of the AlienMail API. Defaults to `https://app.alienmail.io` if not provided.
+
+## 🛠️ Available Tools
+
+Once connected, your AI assistant will have access to the following tools to manage your AlienMail platform:
+
+### 🏢 Workspaces
+- `list_workspaces`: List all your accessible workspaces.
+- `create_workspace`: Create a new workspace.
+
+### 📢 Campaigns
+- `list_campaigns`: List campaigns for a workspace.
+- `create_campaign`, `get_campaign`, `update_campaign`, `delete_campaign`
+- `duplicate_campaign`, `start_campaign`, `toggle_campaign_status`, `update_campaign_settings`
+
+### 📧 Templates & Flow
+- `list_templates`, `create_template`: Manage email templates for a campaign.
+- `get_campaign_flow`, `save_campaign_flow`: Manage the nodes and edges for visual campaign flows.
+- `get_campaign_conditions`, `create_campaign_condition`: Manage campaign trigger conditions (e.g., Opened an email).
+
+### 👥 Leads
+- `list_leads`: List leads with pagination and search.
+- `create_lead`, `import_leads_csv`, `get_lead`
+- `bulk_update_lead_status`, `bulk_enroll_leads`
+- `enroll_leads_in_campaign`: Enroll leads into a specific campaign.
+- `get_lead_email_timeline`: Get email interaction timeline for a specific lead.
+
+### 📮 SMTP / Mailboxes
+- `list_smtp_accounts`: View configured SMTP accounts.
+- `add_smtp_account`, `update_smtp_account`, `delete_smtp_account`
+- `test_smtp_connection`: Test your SMTP credentials.
+
+### 📊 Analytics
+- `get_workspace_analytics`: Get aggregated analytics for a workspace within a date range.
+
+## 👨‍💻 Local Development
+
+If you are developing or testing this package locally:
+
+1. Clone the repository and navigate into the directory.
+2. Install dependencies:
+   ```bash
+   npm install
+   ```
+3. Symlink the package globally to test `npx alienmail-mcp`:
+   ```bash
+   npm link
+   ```
+4. Run locally:
+   ```bash
+   npm start
+   ```
+
+## 📝 License
+
+ISC

package/mcp-server.mjs

@@ -0,0 +1,719 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  CallToolRequestSchema,
+  ListToolsRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+import "dotenv/config";
+
+// --- API State ---
+const API_BASE_URL = process.env.NEXT_PUBLIC_APP_URL || "https://app.alienmail.io";
+const API_TOKEN = process.env.MCP_API_TOKEN || process.env.API_TOKEN;
+
+const server = new Server(
+  {
+    name: "project-access-mcp",
+    version: "1.0.0",
+  },
+  {
+    capabilities: {
+      tools: {},
+    },
+  }
+);
+
+async function makeApiCall(method, endpoint, body = null) {
+  const url = `${API_BASE_URL}${endpoint.startsWith('/') ? endpoint : `/${endpoint}`}`;
+  const headers = { "Content-Type": "application/json" };
+
+  if (API_TOKEN) {
+    headers.Authorization = `Bearer ${API_TOKEN}`;
+    headers.Cookie = `authToken=${API_TOKEN}`;
+  } else {
+    throw new Error("No API token configured. Please set MCP_API_TOKEN or API_TOKEN in your .env file or environment.");
+  }
+
+  const fetchOptions = {
+    method: method.toUpperCase(),
+    headers,
+  };
+  if (body && ["POST", "PUT", "PATCH"].includes(fetchOptions.method)) {
+    fetchOptions.body = JSON.stringify(body);
+  }
+
+  const response = await fetch(url, fetchOptions);
+  let responseBody;
+  const contentType = response.headers.get("content-type");
+  if (contentType && contentType.includes("application/json")) {
+    responseBody = await response.json();
+  } else {
+    responseBody = await response.text();
+  }
+
+  return {
+    content: [
+      { type: "text", text: `Status: ${response.status} ${response.statusText}\n\nResponse:\n${typeof responseBody === "string" ? responseBody : JSON.stringify(responseBody, null, 2)}` }
+    ],
+  };
+}
+
+// Define tools
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  return {
+    tools: [
+      // WORKSPACES
+      {
+        name: "list_workspaces",
+        description: "List all workspaces.",
+        inputSchema: { type: "object", properties: {} },
+      },
+      {
+        name: "create_workspace",
+        description: "Create a new workspace.",
+        inputSchema: {
+          type: "object",
+          properties: { name: { type: "string" } },
+          required: ["name"],
+        },
+      },
+      // CAMPAIGNS
+      {
+        name: "list_campaigns",
+        description: "List campaigns for a workspace.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            search: { type: "string" },
+            status: { type: "string" },
+          },
+          required: ["workspaceUID"],
+        },
+      },
+      {
+        name: "create_campaign",
+        description: "Create a new campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            name: { type: "string" },
+          },
+          required: ["workspaceUID", "workspaceId", "name"],
+        },
+      },
+      {
+        name: "get_campaign",
+        description: "Get a campaign by ID.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "update_campaign",
+        description: "Update a campaign name.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            name: { type: "string" },
+          },
+          required: ["workspaceUID", "campaignId", "name"],
+        },
+      },
+      {
+        name: "delete_campaign",
+        description: "Soft delete a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "duplicate_campaign",
+        description: "Duplicate a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "start_campaign",
+        description: "Start a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "toggle_campaign_status",
+        description: "Toggle a campaign's status.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            status: { type: "string", description: "DRAFT, ACTIVE, PAUSED, COMPLETED" },
+          },
+          required: ["workspaceUID", "campaignId", "status"],
+        },
+      },
+      {
+        name: "update_campaign_settings",
+        description: "Update campaign settings.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            emailsPerDay: { type: "number" },
+            gapBwEmail: { type: "number" },
+            startScheduleAt: { type: "string" },
+            endScheduleAt: { type: "string" },
+          },
+          required: ["workspaceUID", "campaignId", "emailsPerDay", "gapBwEmail"],
+        },
+      },
+      // CAMPAIGN TEMPLATES
+      {
+        name: "list_templates",
+        description: "List templates for a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "create_template",
+        description: "Create a template for a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            name: { type: "string" },
+            subject: { type: "string" },
+            html: { type: "string" },
+            enabled: { type: "boolean" },
+            stepIndex: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId", "name", "subject", "html"],
+        },
+      },
+      // CAMPAIGN FLOW
+      {
+        name: "get_campaign_flow",
+        description: "Get the flow (nodes and edges) of a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "save_campaign_flow",
+        description: "Save the flow (nodes and edges) for a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            nodes: { type: "array" },
+            edges: { type: "array" },
+          },
+          required: ["workspaceUID", "campaignId", "nodes", "edges"],
+        },
+      },
+      // CAMPAIGN CONDITIONS
+      {
+        name: "get_campaign_conditions",
+        description: "Get conditions for a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId"],
+        },
+      },
+      {
+        name: "create_campaign_condition",
+        description: "Create a condition for a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            name: { type: "string" },
+            condition: { type: "string", description: "Opened an email, Clicked on link, Has replied, All Leads" },
+            templateId: { type: "number" },
+            enabled: { type: "boolean" },
+          },
+          required: ["workspaceUID", "campaignId", "name", "condition", "templateId"],
+        },
+      },
+      // LEADS
+      {
+        name: "list_leads",
+        description: "List leads with pagination and optional search.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            page: { type: "number" },
+            pageSize: { type: "number" },
+            search: { type: "string" },
+          },
+          required: ["workspaceUID"],
+        },
+      },
+      {
+        name: "create_lead",
+        description: "Create a single lead.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            email: { type: "string" },
+            firstName: { type: "string" },
+            lastName: { type: "string" },
+            company: { type: "string" },
+            source: { type: "string" },
+          },
+          required: ["workspaceUID", "workspaceId", "email", "firstName"],
+        },
+      },
+      {
+        name: "import_leads_csv",
+        description: "Import leads via CSV.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            csv: { type: "string" },
+          },
+          required: ["workspaceUID", "workspaceId", "csv"],
+        },
+      },
+      {
+        name: "get_lead",
+        description: "Get a lead by ID with campaign analytics.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            leadId: { type: "number" },
+          },
+          required: ["workspaceUID", "leadId"],
+        },
+      },
+      {
+        name: "bulk_update_lead_status",
+        description: "Bulk update lead statuses.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            status: { type: "string" },
+            mode: { type: "string" },
+            selectedIds: { type: "array" },
+            excludedIds: { type: "array" },
+            search: { type: "string" },
+          },
+          required: ["workspaceUID", "workspaceId", "status", "mode"],
+        },
+      },
+      {
+        name: "bulk_enroll_leads",
+        description: "Bulk enroll leads into a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            campaignId: { type: "number" },
+            leads: { type: "array" },
+          },
+          required: ["workspaceUID", "workspaceId", "campaignId", "leads"],
+        },
+      },
+      // ENROLL LEADS INTO CAMPAIGN
+      {
+        name: "enroll_leads_in_campaign",
+        description: "Enroll leads into a specific campaign (by IDs or query).",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            workspaceId: { type: "number" },
+            mode: { type: "string" },
+            leadIds: { type: "array" },
+            search: { type: "string" },
+            excludedIds: { type: "array" },
+          },
+          required: ["workspaceUID", "campaignId", "workspaceId", "mode"],
+        },
+      },
+      {
+        name: "get_lead_email_timeline",
+        description: "Get email timeline for a lead in a campaign.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            campaignId: { type: "number" },
+            leadId: { type: "number" },
+          },
+          required: ["workspaceUID", "campaignId", "leadId"],
+        },
+      },
+      // SMTP / MAILBOX
+      {
+        name: "list_smtp_accounts",
+        description: "List SMTP accounts for a workspace.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+          },
+          required: ["workspaceUID"],
+        },
+      },
+      {
+        name: "add_smtp_account",
+        description: "Add an SMTP account.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            workspaceId: { type: "number" },
+            host: { type: "string" },
+            port: { type: "number" },
+            username: { type: "string" },
+            password: { type: "string" },
+            fromEmail: { type: "string" },
+            fromName: { type: "string" },
+          },
+          required: ["workspaceUID", "workspaceId", "host", "port", "username", "password", "fromEmail", "fromName"],
+        },
+      },
+      {
+        name: "update_smtp_account",
+        description: "Update an SMTP account.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            id: { type: "number" },
+            host: { type: "string" },
+            port: { type: "number" },
+            username: { type: "string" },
+            fromEmail: { type: "string" },
+            fromName: { type: "string" },
+          },
+          required: ["workspaceUID", "id", "host", "port", "username", "fromEmail", "fromName"],
+        },
+      },
+      {
+        name: "delete_smtp_account",
+        description: "Delete an SMTP account.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            id: { type: "number" },
+          },
+          required: ["workspaceUID", "id"],
+        },
+      },
+      {
+        name: "test_smtp_connection",
+        description: "Test an SMTP connection.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            id: { type: "number" },
+          },
+          required: ["workspaceUID", "id"],
+        },
+      },
+      // ANALYTICS
+      {
+        name: "get_workspace_analytics",
+        description: "Get workspace analytics.",
+        inputSchema: {
+          type: "object",
+          properties: {
+            workspaceUID: { type: "string" },
+            from: { type: "string" },
+            to: { type: "string" },
+            status: { type: "string" },
+          },
+          required: ["workspaceUID", "from", "to"],
+        },
+      },
+    ],
+  };
+});
+
+// Handle tool execution
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const { name, arguments: args } = request.params;
+
+  try {
+    // WORKSPACES
+    if (name === "list_workspaces") {
+      return await makeApiCall("GET", "/api/workspaces");
+    }
+    if (name === "create_workspace") {
+      return await makeApiCall("POST", "/api/workspaces", { name: args.name });
+    }
+
+    // CAMPAIGNS
+    if (name === "list_campaigns") {
+      const params = new URLSearchParams();
+      if (args.workspaceId) params.append("workspaceId", args.workspaceId.toString());
+      if (args.search) params.append("search", args.search);
+      if (args.status) params.append("status", args.status);
+      const queryStr = params.toString() ? `?${params.toString()}` : "";
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/campaigns${queryStr}`);
+    }
+    if (name === "create_campaign") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns`, {
+        name: args.name,
+        workspaceId: args.workspaceId,
+      });
+    }
+    if (name === "get_campaign") {
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/campaigns/${args.campaignId}`);
+    }
+    if (name === "update_campaign") {
+      return await makeApiCall("PATCH", `/api/${args.workspaceUID}/campaigns/${args.campaignId}`, {
+        name: args.name,
+      });
+    }
+    if (name === "delete_campaign") {
+      return await makeApiCall("PATCH", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/delete`);
+    }
+    if (name === "duplicate_campaign") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/duplicate`);
+    }
+    if (name === "start_campaign") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/start`);
+    }
+    if (name === "toggle_campaign_status") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/toggle`, {
+        id: args.campaignId,
+        status: args.status,
+      });
+    }
+    if (name === "update_campaign_settings") {
+      return await makeApiCall("PUT", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/settings`, {
+        emailsPerDay: args.emailsPerDay,
+        gapBwEmail: args.gapBwEmail,
+        startScheduleAt: args.startScheduleAt,
+        endScheduleAt: args.endScheduleAt,
+      });
+    }
+
+    // CAMPAIGN TEMPLATES
+    if (name === "list_templates") {
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/templates`);
+    }
+    if (name === "create_template") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/templates`, {
+        name: args.name,
+        subject: args.subject,
+        html: args.html,
+        enabled: args.enabled !== undefined ? args.enabled : true,
+        stepIndex: args.stepIndex || 0,
+      });
+    }
+
+    // CAMPAIGN FLOW
+    if (name === "get_campaign_flow") {
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/steps`);
+    }
+    if (name === "save_campaign_flow") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/steps`, {
+        nodes: args.nodes,
+        edges: args.edges,
+      });
+    }
+
+    // CAMPAIGN CONDITIONS
+    if (name === "get_campaign_conditions") {
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/conditions`);
+    }
+    if (name === "create_campaign_condition") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/conditions`, {
+        name: args.name,
+        condition: args.condition,
+        templateId: args.templateId,
+        enabled: args.enabled !== undefined ? args.enabled : true,
+      });
+    }
+
+    // LEADS
+    if (name === "list_leads") {
+      const params = new URLSearchParams();
+      if (args.page) params.append("page", args.page.toString());
+      if (args.pageSize) params.append("pageSize", args.pageSize.toString());
+      if (args.search) params.append("search", args.search);
+      const queryStr = params.toString() ? `?${params.toString()}` : "";
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/leads${queryStr}`);
+    }
+    if (name === "create_lead") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/leads`, {
+        workspaceId: args.workspaceId,
+        email: args.email,
+        firstName: args.firstName,
+        lastName: args.lastName,
+        company: args.company,
+        source: args.source || "MANUAL",
+      });
+    }
+    if (name === "import_leads_csv") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/leads`, {
+        workspaceId: args.workspaceId,
+        csv: args.csv,
+      });
+    }
+    if (name === "get_lead") {
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/leads/${args.leadId}`);
+    }
+    if (name === "bulk_update_lead_status") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/leads/bulk`, {
+        workspaceId: args.workspaceId,
+        status: args.status,
+        mode: args.mode,
+        selectedIds: args.selectedIds || [],
+        excludedIds: args.excludedIds || [],
+        search: args.search || "",
+      });
+    }
+    if (name === "bulk_enroll_leads") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/leads/bulkenroll`, {
+        workspaceId: args.workspaceId,
+        campaignId: args.campaignId,
+        leads: args.leads,
+      });
+    }
+
+    // ENROLL LEADS INTO CAMPAIGN
+    if (name === "enroll_leads_in_campaign") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/enroll`, {
+        workspaceId: args.workspaceId,
+        mode: args.mode,
+        leadIds: args.leadIds,
+        search: args.search,
+        excludedIds: args.excludedIds,
+      });
+    }
+    if (name === "get_lead_email_timeline") {
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/campaigns/${args.campaignId}/lead/${args.leadId}`);
+    }
+
+    // SMTP / MAILBOX
+    if (name === "list_smtp_accounts") {
+      const params = new URLSearchParams();
+      if (args.workspaceId) params.append("workspaceId", args.workspaceId.toString());
+      const queryStr = params.toString() ? `?${params.toString()}` : "";
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/smtp${queryStr}`);
+    }
+    if (name === "add_smtp_account") {
+      return await makeApiCall("POST", `/api/${args.workspaceUID}/smtp`, {
+        workspaceId: args.workspaceId,
+        host: args.host,
+        port: args.port,
+        username: args.username,
+        password: args.password,
+        fromEmail: args.fromEmail,
+        fromName: args.fromName,
+      });
+    }
+    if (name === "update_smtp_account") {
+      return await makeApiCall("PUT", `/api/${args.workspaceUID}/smtp`, {
+        id: args.id,
+        host: args.host,
+        port: args.port,
+        username: args.username,
+        fromEmail: args.fromEmail,
+        fromName: args.fromName,
+      });
+    }
+    if (name === "delete_smtp_account") {
+      const params = new URLSearchParams();
+      if (args.id) params.append("id", args.id.toString());
+      const queryStr = params.toString() ? `?${params.toString()}` : "";
+      return await makeApiCall("DELETE", `/api/${args.workspaceUID}/smtp${queryStr}`);
+    }
+    if (name === "test_smtp_connection") {
+      const params = new URLSearchParams();
+      if (args.id) params.append("id", args.id.toString());
+      const queryStr = params.toString() ? `?${params.toString()}` : "";
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/smtp/test${queryStr}`);
+    }
+
+    // ANALYTICS
+    if (name === "get_workspace_analytics") {
+      const params = new URLSearchParams();
+      if (args.from) params.append("from", args.from);
+      if (args.to) params.append("to", args.to);
+      if (args.status) params.append("status", args.status);
+      const queryStr = params.toString() ? `?${params.toString()}` : "";
+      return await makeApiCall("GET", `/api/${args.workspaceUID}/analytics${queryStr}`);
+    }
+
+    throw new Error(`Unknown tool: ${name}`);
+  } catch (error) {
+    return {
+      content: [{ type: "text", text: `Error: ${error.message}` }],
+      isError: true,
+    };
+  }
+});
+
+// Start server
+async function run() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error("Project Access MCP Server running on stdio");
+}
+
+run().catch(console.error);

package/package.json

@@ -0,0 +1,24 @@
+{
+  "name": "alienmail-mcp",
+  "version": "1.0.0",
+  "description": "MCP server for AlienMail",
+  "main": "mcp-server.mjs",
+  "type": "module",
+  "bin": {
+    "alienmail-mcp": "./mcp-server.mjs"
+  },
+  "scripts": {
+    "start": "node mcp-server.mjs"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "latest",
+    "dotenv": "latest"
+  },
+  "keywords": [
+    "mcp",
+    "mcp-server",
+    "alienmail"
+  ],
+  "author": "",
+  "license": "ISC"
+}