@mailloom/mcp 0.1.0 → 0.1.1

package/README.md

@@ -20,15 +20,15 @@ API auth runs in the Supabase Edge Function `mailloom-api` (service role never l
       "args": ["-y", "@mailloom/mcp"],
       "env": {
         "MAILLOOM_API_KEY": "ml_live_…",
-        "MAILLOOM_API_BASE": "http://localhost:3847/api/v1"
+        "MAILLOOM_API_BASE": "https://<project>.supabase.co/functions/v1/mailloom-api",
+        "MAILLOOM_ANON_KEY": "<supabase-anon-key>"
       }
     }
   }
 }
 ```
 
-Production Next: `https://your-host/api/v1`.  
-Edge Function only (CRUD, no HTML export): `https://<project>.supabase.co/functions/v1/mailloom-api`.
+Account settings copies this snippet for you. For HTML `export_template`, point `MAILLOOM_API_BASE` at your app `/api/v1` instead (proxies to the Edge Function).
 
 ### Local package (unpublished)
 
@@ -58,7 +58,8 @@ npm run build
 | Variable | Required | Default | Purpose |
 | --- | --- | --- | --- |
 | `MAILLOOM_API_KEY` | yes | — | `ml_live_…` from Account settings |
-| `MAILLOOM_API_BASE` | no | `http://localhost:3847/api/v1` | API origin including `/api/v1` |
+| `MAILLOOM_API_BASE` | no | Mailloom Edge Function URL | Edge Function or Next `/api/v1` |
+| `MAILLOOM_ANON_KEY` | for Edge Function | — | Public Supabase anon key (`apikey` header) |
 
 ## Tools
 

package/dist/client.d.ts

@@ -2,12 +2,14 @@
  * Thin Mailloom API client for MCP.
  * Auth: Authorization Bearer ml_live_…
  *
- * Prefer Next /api/v1 (proxies to the mailloom-api Edge Function + HTML export).
- * Or point at https://<project>.supabase.co/functions/v1/mailloom-api for CRUD only.
+ * Default base is the mailloom-api Edge Function (no local Next required).
+ * Optional MAILLOOM_ANON_KEY (public) is sent as `apikey` for the Supabase gateway.
+ * For HTML export, point MAILLOOM_API_BASE at your app `/api/v1` instead.
  */
 export type ApiConfig = {
     baseUrl: string;
     apiKey: string;
+    anonKey?: string;
 };
 export declare function loadConfig(): ApiConfig;
 export declare function apiRequest(config: ApiConfig, method: string, path: string, opts?: {

package/dist/client.js

@@ -2,10 +2,11 @@
  * Thin Mailloom API client for MCP.
  * Auth: Authorization Bearer ml_live_…
  *
- * Prefer Next /api/v1 (proxies to the mailloom-api Edge Function + HTML export).
- * Or point at https://<project>.supabase.co/functions/v1/mailloom-api for CRUD only.
+ * Default base is the mailloom-api Edge Function (no local Next required).
+ * Optional MAILLOOM_ANON_KEY (public) is sent as `apikey` for the Supabase gateway.
+ * For HTML export, point MAILLOOM_API_BASE at your app `/api/v1` instead.
  */
-const DEFAULT_BASE = 'http://localhost:3847/api/v1';
+const DEFAULT_BASE = 'https://siqcxhwcklmtoazielus.supabase.co/functions/v1/mailloom-api';
 export function loadConfig() {
     const apiKey = (process.env.MAILLOOM_API_KEY || '').trim();
     if (!apiKey) {
@@ -15,7 +16,8 @@ export function loadConfig() {
         throw new Error('MAILLOOM_API_KEY must start with ml_live_');
     }
     const baseUrl = (process.env.MAILLOOM_API_BASE || DEFAULT_BASE).replace(/\/$/, '');
-    return { baseUrl, apiKey };
+    const anonKey = (process.env.MAILLOOM_ANON_KEY || '').trim() || undefined;
+    return { baseUrl, apiKey, anonKey };
 }
 export async function apiRequest(config, method, path, opts) {
     const url = new URL(path.startsWith('http') ? path : `${config.baseUrl}${path.startsWith('/') ? path : `/${path}`}`);
@@ -30,6 +32,10 @@ export async function apiRequest(config, method, path, opts) {
         Authorization: `Bearer ${config.apiKey}`,
         Accept: 'application/json',
     };
+    // Supabase Functions gateway expects the project anon key even when verify_jwt is off.
+    if (config.anonKey) {
+        headers.apikey = config.anonKey;
+    }
     if (opts?.body !== undefined) {
         headers['Content-Type'] = 'application/json';
     }

package/dist/index.js

@@ -3,8 +3,9 @@
  * Official Mailloom MCP server — templates, brand kits, assets for AI hosts.
  *
  * Env:
- *   MAILLOOM_API_KEY   required — ml_live_…
- *   MAILLOOM_API_BASE  optional — default http://localhost:3847/api/v1
+ *   MAILLOOM_API_KEY    required — ml_live_…
+ *   MAILLOOM_API_BASE   optional — Edge Function URL (default) or Next /api/v1
+ *   MAILLOOM_ANON_KEY   optional — public Supabase anon key (needed for Edge Function)
  *
  * Write tools require Account settings → Allow MCP / API write access (default on).
  * When disabled, mutating tools return 403 write_disabled; reads still work.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mailloom/mcp",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Official Mailloom MCP server — manage email templates, brand kits, and assets via the Mailloom API.",
   "type": "module",
   "bin": {
@@ -46,5 +46,8 @@
     "email",
     "templates"
   ],
+  "publishConfig": {
+    "access": "public"
+  },
   "license": "MIT"
 }