groundmail-mcp 0.5.15 → 0.6.1

package/README.md

@@ -152,8 +152,12 @@ Want your coding agent to know Groundmail too? Install the [agent skills](https:
 | Strapi | [Groundmail/strapi-provider-email-groundmail](https://github.com/Groundmail/strapi-provider-email-groundmail) |
 | Medusa | [Groundmail/medusa-notification-groundmail](https://github.com/Groundmail/medusa-notification-groundmail) |
 | AdonisJS | [Groundmail/adonisjs-groundmail](https://github.com/Groundmail/adonisjs-groundmail) |
+| Rails (Action Mailer) | [Groundmail/groundmail-rails](https://github.com/Groundmail/groundmail-rails) |
+| Phoenix (Swoosh) | [Groundmail/swoosh_groundmail](https://github.com/Groundmail/swoosh_groundmail) |
+| PocketBase | [Groundmail/groundmail-pocketbase](https://github.com/Groundmail/groundmail-pocketbase) |
 | CLI | [`groundmail-cli`](https://www.npmjs.com/package/groundmail-cli) on npm |
 | MCP server (Claude, ChatGPT, Cursor) | [Groundmail/groundmail-mcp](https://github.com/Groundmail/groundmail-mcp) |
 | Agent skills and Claude Code plugin | [Groundmail/groundmail-skills](https://github.com/Groundmail/groundmail-skills) |
+| Email templates (React Email, MJML, HTML) | [Groundmail/email-templates](https://github.com/Groundmail/email-templates) |
 
 [Website](https://groundmail.dev) · [Docs](https://docs.groundmail.dev) · [Pricing](https://groundmail.dev/pricing) · [Sign up free](https://app.groundmail.dev/signup)

package/dist/index.js

@@ -346,6 +346,39 @@ var deliverabilityOutput = object(
   },
   ["window", "summary"]
 );
+var anyObject = (description) => ({ type: "object", description });
+var migrationOutput = object(
+  {
+    migration: described(
+      object(
+        {
+          id: string("Import id"),
+          provider: string("sendgrid, postmark or mailgun"),
+          dry_run: boolean("True for a preview: nothing was written"),
+          status: string("completed, partial (some items failed, each listed), failed, or in_progress"),
+          started_at: string("When the import started (ISO 8601)"),
+          resources: stringArray("What was imported: domains, webhooks, templates, suppressions"),
+          has_more: boolean("True if the import stopped early; call the tool again with `cursor` to continue"),
+          next_cursor: nullableString("Pass as `cursor` to continue an import that stopped early"),
+          retry_after_seconds: { type: ["number", "null"], description: "Wait this long before continuing" },
+          domains: anyObject("Totals and one item per domain, with the DNS records to publish"),
+          webhooks: anyObject("Totals and one item per webhook (created disabled), with mapped events and the signing secret"),
+          templates: anyObject("Totals and one item per template, with its alias and conversion notes"),
+          suppressions: anyObject("Totals by type (bounce, complaint, unsubscribe, manual) and skip reasons"),
+          errors: arrayOf(anyObject("A resource that could not be read"), "Resources that could not be read at all"),
+          notes: stringArray("What was left out on purpose, and why"),
+          attention: stringArray("What the user still needs to do"),
+          template_map: arrayOf(anyObject("Provider template id and Groundmail alias"), "Provider template id \u2192 Groundmail alias"),
+          code_changes: { type: ["array", "null"], items: anyObject("One stack"), description: "Send call before and after, for Node.js, Python and cURL" },
+          agent_prompt: nullableString("Prompt for a coding agent to make the code change")
+        },
+        ["id", "provider", "dry_run", "status", "has_more"]
+      ),
+      "The import report"
+    )
+  },
+  ["migration"]
+);
 
 // src/tools.ts
 function textResult(value, isError = false) {
@@ -581,6 +614,27 @@ async function callMcpTool(client, name, args) {
         const result = await client.emails.insights(window);
         return textResult(result);
       }
+      case "import_from_provider": {
+        const provider = optString(args, "provider");
+        if (provider !== "sendgrid" && provider !== "postmark" && provider !== "mailgun") {
+          return textResult("Missing or unknown provider: use sendgrid, postmark or mailgun", true);
+        }
+        const apiKey = optString(args, "api_key");
+        if (!apiKey) return textResult("Missing required argument: api_key (the key of the account to import from)", true);
+        const region = optString(args, "region");
+        const resources = optStringArray(args, "resources");
+        const cursor = optString(args, "cursor");
+        const params = {
+          provider,
+          api_key: apiKey,
+          ...optString(args, "account_api_key") ? { account_api_key: optString(args, "account_api_key") } : {},
+          ...region === "us" || region === "eu" ? { region } : {},
+          ...resources?.length ? { resources } : {},
+          ...optBoolean(args, "dry_run") ? { dry_run: true } : {},
+          ...cursor ? { cursor } : {}
+        };
+        return textResult({ migration: await client.migrations.run(params) });
+      }
       default:
         return textResult(`Unknown tool: ${name}`, true);
     }
@@ -976,6 +1030,39 @@ var MCP_TOOLS = [
     },
     outputSchema: deliverabilityOutput,
     annotations: readOnly("Get deliverability metrics")
+  },
+  {
+    name: "import_from_provider",
+    description: "Beta. Import templates, suppressions (bounces, complaints, unsubscribes), sending domains and webhooks from SendGrid, Postmark or Mailgun into Groundmail. Ask the user for their provider API key; it is used for this import only and never stored, so do not write it to a file. Run with dry_run first to show the user what will be imported. Imported webhooks start disabled; templates that use logic Groundmail does not convert are imported as drafts. The result includes what needs attention, the code change, and a prompt for making it.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        provider: { type: "string", enum: ["sendgrid", "postmark", "mailgun"], description: "Provider to import from" },
+        api_key: {
+          type: "string",
+          description: "SendGrid API key, Postmark server API token, or Mailgun private API key (read access is enough)"
+        },
+        account_api_key: { type: "string", description: "Postmark only: account API token, needed to import sending domains" },
+        region: { type: "string", enum: ["us", "eu"], description: "SendGrid and Mailgun: eu for EU-region accounts (default us)" },
+        resources: {
+          type: "array",
+          items: { type: "string", enum: ["domains", "webhooks", "templates", "suppressions"] },
+          description: "What to import (default: all four)"
+        },
+        dry_run: { type: "boolean", description: "Preview without writing anything" },
+        cursor: { type: "string", description: "next_cursor from an import that stopped early, to continue it" }
+      },
+      required: ["provider", "api_key"]
+    },
+    outputSchema: migrationOutput,
+    // Re-running skips what already exists, so it is safe to repeat.
+    annotations: {
+      title: "Import from another provider",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
+    }
   }
 ];
 function resolveApiKey() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.5.15",
+  "version": "0.6.1",
   "mcpName": "io.github.Groundmail/groundmail",
   "description": "Groundmail MCP server: send transactional email, manage domains, templates, webhooks and suppressions from Claude, Cursor, ChatGPT and other MCP clients",
   "license": "MIT",
@@ -41,7 +41,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "groundmail": "0.14.5"
+    "groundmail": "0.14.6"
   },
   "devDependencies": {
     "tsup": "^8.5.0",