groundmail-mcp 0.5.14 → 0.6.0

package/README.md

@@ -55,7 +55,7 @@ When you connect, you choose the access: **Full**, **Send only** or **Read only*
 >
 > "How is my deliverability over the last 7 days?"
 
-Tools cover emails (send, schedule, cancel, look up), domains (add, apply DNS, verify), templates, webhooks, suppressions and deliverability. Each tool carries read-only and destructive annotations and an output schema. Full list: [docs.groundmail.dev/ai/mcp](https://docs.groundmail.dev/ai/mcp).
+Tools cover emails (send, schedule, cancel, look up), domains (add, apply DNS, verify), templates, webhooks, suppressions and deliverability, plus importing your setup from SendGrid, Postmark or Mailgun (beta). Each tool carries read-only and destructive annotations and an output schema. Full list: [docs.groundmail.dev/ai/mcp](https://docs.groundmail.dev/ai/mcp).
 
 ## Transports
 
@@ -148,8 +148,13 @@ Want your coding agent to know Groundmail too? Install the [agent skills](https:
 | Laravel | [Groundmail/groundmail-laravel](https://github.com/Groundmail/groundmail-laravel) |
 | Symfony Mailer | [Groundmail/groundmail-symfony-mailer](https://github.com/Groundmail/groundmail-symfony-mailer) |
 | Nodemailer | [Groundmail/groundmail-nodemailer](https://github.com/Groundmail/groundmail-nodemailer) |
+| NestJS | [Groundmail/nestjs-groundmail](https://github.com/Groundmail/nestjs-groundmail) |
+| 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) |
 | 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.14",
+  "version": "0.6.0",
   "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",