groundmail-mcp 0.5.8 → 0.5.11

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) Groundmail
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.js

@@ -82,10 +82,277 @@ import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js"
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
 import { Groundmail } from "groundmail";
 
+// src/output-schemas.ts
+var nullableString = (description) => ({ type: ["string", "null"], description });
+var string = (description) => ({ type: "string", description });
+var boolean = (description) => ({ type: "boolean", description });
+var number = (description) => ({ type: "number", description });
+var stringArray = (description) => ({
+  type: "array",
+  items: { type: "string" },
+  description
+});
+function object(properties, required = []) {
+  return { type: "object", properties, ...required.length ? { required } : {} };
+}
+function described(schema, description) {
+  return { ...schema, description };
+}
+function arrayOf(items, description) {
+  return { type: "array", items, description };
+}
+var okOutput = object(
+  { ok: boolean("True when the request completed") },
+  ["ok"]
+);
+var paginationOutput = {
+  has_more: boolean("True when another page of results is available"),
+  next_cursor: nullableString("Cursor to pass as `cursor` to fetch the next page; null on the last page")
+};
+function pagedOutput(key, item, description) {
+  return object(
+    {
+      [key]: arrayOf(item, description),
+      ...paginationOutput
+    },
+    [key]
+  );
+}
+var emailItem = object(
+  {
+    id: string("Email id (msg_\u2026)"),
+    from: string("Sender address"),
+    to: stringArray("Recipient addresses"),
+    cc: stringArray("Cc addresses"),
+    bcc: stringArray("Bcc addresses"),
+    reply_to: stringArray("Reply-To addresses"),
+    subject: string("Subject line"),
+    status: string("Current delivery status, for example sent, delivered or bounced"),
+    last_event: nullableString("Most recent delivery event, if any"),
+    bounce_reason: nullableString("Reason reported when the email bounced"),
+    tags: { description: "Tags attached to the email" },
+    scheduled_at: nullableString("When the email is scheduled to send (ISO 8601)"),
+    cancelled_at: nullableString("When the scheduled email was cancelled (ISO 8601)"),
+    created_at: string("When the email was created (ISO 8601)"),
+    sent_at: nullableString("When the email was handed off for delivery (ISO 8601)"),
+    delivered_at: nullableString("When the email was delivered (ISO 8601)"),
+    bounced_at: nullableString("When the email bounced (ISO 8601)"),
+    opened_at: nullableString("First open (ISO 8601); needs open tracking on the sending domain"),
+    clicked_at: nullableString("First tracked-link click (ISO 8601); needs click tracking on the sending domain")
+  },
+  ["id", "from", "to", "subject", "status"]
+);
+var domainItem = object(
+  {
+    id: string("Domain id"),
+    name: string("Domain name, for example example.com"),
+    status: string("Verification status: pending, verified or failed"),
+    created_at: string("When the domain was added (ISO 8601)"),
+    verified_at: nullableString("When the domain was verified (ISO 8601)"),
+    open_tracking: boolean("Whether open tracking is enabled"),
+    click_tracking: boolean("Whether click tracking is enabled"),
+    tracking_status: string("Whether tracking is applied: disabled, pending, active or error"),
+    tracking_error: nullableString("Why tracking is not active yet, when pending or in error"),
+    tls_mode: string("TLS mode for outgoing mail: opportunistic or enforced"),
+    inbound_enabled: boolean("Whether inbound receiving is enabled"),
+    inbound_status: string("Inbound status: disabled, pending, active or error"),
+    inbound_error: nullableString("Inbound setup error, if any")
+  },
+  ["id", "name", "status"]
+);
+var dnsRecordItem = object(
+  {
+    type: string("DNS record type, for example TXT, CNAME or MX"),
+    host: string("Record host name"),
+    value: string("Record value"),
+    purpose: string("What the record is for, for example SPF or DKIM"),
+    priority: number("MX preference, present on MX records")
+  },
+  ["type", "host", "value"]
+);
+var dnsRecords = arrayOf(dnsRecordItem, "DNS records to publish for the domain");
+var webhookItem = object(
+  {
+    id: string("Webhook id (wh_\u2026)"),
+    url: string("URL that receives events"),
+    events: stringArray("Event types delivered to this endpoint"),
+    enabled: boolean("Whether the endpoint receives events"),
+    created_at: string("When the endpoint was created (ISO 8601)"),
+    updated_at: string("When the endpoint was last changed (ISO 8601)")
+  },
+  ["id", "url", "events"]
+);
+var suppressionItem = object(
+  {
+    id: string("Suppression id"),
+    email: string("Suppressed email address"),
+    reason: nullableString("Why the address was suppressed"),
+    source: string("How the suppression was created, for example api or bounce"),
+    created_at: string("When the suppression was created (ISO 8601)"),
+    updated_at: string("When the suppression was last changed (ISO 8601)")
+  },
+  ["id", "email"]
+);
+var templateItem = object(
+  {
+    id: string("Template id (tpl_\u2026)"),
+    name: string("Template name"),
+    alias: nullableString("Alias that can be used in place of the id"),
+    status: string("draft or published"),
+    format: string("html or blocks"),
+    subject: string("Subject line, may contain variables"),
+    preheader: nullableString("Preview text shown after the subject in some inboxes"),
+    html: nullableString("HTML body"),
+    text: nullableString("Plain-text body"),
+    variables: {
+      type: ["array", "null"],
+      items: { type: "string" },
+      description: "Variable names the template uses"
+    },
+    unsubscribe_enabled: boolean("Whether managed unsubscribe is on for sends using this template"),
+    category: string("transactional, product or newsletter"),
+    published_version_id: nullableString("Id of the version sends currently use"),
+    published_at: nullableString("When the template was last published (ISO 8601)"),
+    created_at: string("When the template was created (ISO 8601)"),
+    updated_at: string("When the template was last changed (ISO 8601)"),
+    warnings: arrayOf(
+      object({ code: string("Warning code"), message: string("What to fix") }),
+      "Content warnings found when the template was saved"
+    )
+  },
+  ["id", "name", "status", "subject"]
+);
+var bucketProperties = {
+  total_emails: number("Emails created in the window"),
+  attempted: number("Emails with a delivery attempt"),
+  sent: number("Emails handed off for delivery"),
+  delivered: number("Emails delivered"),
+  bounced: number("Emails that bounced"),
+  complained: number("Emails reported as spam"),
+  failed: number("Emails that failed"),
+  suppressed: number("Emails not sent because the recipient was suppressed"),
+  scheduled: number("Emails still scheduled"),
+  opened: number("Emails opened"),
+  clicked: number("Emails with a tracked click"),
+  bounce_rate: number("Bounced / attempted, as a fraction"),
+  complaint_rate: number("Complained / attempted, as a fraction"),
+  delivery_rate: number("Delivered / attempted, as a fraction"),
+  open_rate: number("Opened / delivered, as a fraction"),
+  click_rate: number("Clicked / delivered, as a fraction")
+};
+var sendEmailOutput = object(
+  {
+    id: string("Email id (msg_\u2026)"),
+    status: string("Status after the request, for example queued or scheduled")
+  },
+  ["id", "status"]
+);
+var getEmailOutput = object({ email: described(emailItem, "The email") }, ["email"]);
+var domainWithRecordsOutput = object(
+  {
+    domain: described(domainItem, "The domain"),
+    records: dnsRecords,
+    inbound_records: arrayOf(dnsRecordItem, "MX records to publish when inbound receiving is enabled"),
+    inbound_note: string("Guidance about adding the inbound MX records")
+  },
+  ["domain", "records"]
+);
+var verifyDomainOutput = object(
+  {
+    domain: described(domainItem, "The domain"),
+    records: dnsRecords,
+    verified: boolean("True when the domain passed verification"),
+    checks: described(
+      object({
+        ownership: boolean("Ownership record found"),
+        spf: boolean("SPF record found"),
+        dkim: boolean("DKIM record found"),
+        dmarc: boolean("DMARC record found")
+      }),
+      "Result of each DNS check"
+    ),
+    signing_ready: boolean("True when outgoing mail can be signed for this domain"),
+    inbound_configured: boolean("True when inbound receiving is set up"),
+    inbound_pending: boolean("True while inbound setup is still in progress"),
+    inbound_error: nullableString("Inbound setup error, if any")
+  },
+  ["domain", "verified"]
+);
+var applyDnsOutput = object(
+  {
+    provider: string("DNS provider the records were written to"),
+    domain: string("Domain the records belong to"),
+    results: arrayOf(
+      object(
+        {
+          purpose: string("What the record is for"),
+          host: string("Record host name"),
+          action: string("created, updated, unchanged or merged"),
+          detail: string("Extra detail about the change")
+        },
+        ["purpose", "host", "action"]
+      ),
+      "Outcome for each record"
+    ),
+    records: dnsRecords
+  },
+  ["provider", "domain", "results"]
+);
+var createWebhookOutput = object(
+  {
+    webhook: described(webhookItem, "The created webhook endpoint"),
+    secret: string("Signing secret for verifying deliveries. Shown only once, so store it")
+  },
+  ["webhook", "secret"]
+);
+var suppressionOutput = object({ suppression: described(suppressionItem, "The suppression entry") }, ["suppression"]);
+var templateOutput = object({ template: described(templateItem, "The template") }, ["template"]);
+var testWebhookOutput = object(
+  {
+    ok: boolean("True when the simulated event was built"),
+    payload: { description: "The event payload that was (or would be) delivered" },
+    delivered: boolean("True when delivery to subscribed endpoints was started"),
+    deliveries: arrayOf(
+      object(
+        {
+          endpoint_id: string("Webhook endpoint id"),
+          url: string("Endpoint URL"),
+          success: boolean("Whether the endpoint accepted the event"),
+          status: number("HTTP status returned by the endpoint"),
+          error: string("Error message when delivery failed")
+        },
+        ["endpoint_id", "url", "success"]
+      ),
+      "Per-endpoint results when delivery ran synchronously; empty otherwise"
+    )
+  },
+  ["ok", "delivered"]
+);
+var deliverabilityOutput = object(
+  {
+    window: string("Window covered: 7d or 30d"),
+    window_start: string("Start of the window (ISO 8601)"),
+    generated_at: string("When the report was generated (ISO 8601)"),
+    summary: { ...object(bucketProperties), description: "Totals across all domains" },
+    by_domain: arrayOf(
+      object({ domain: string("Sending domain"), ...bucketProperties }, ["domain"]),
+      "Metrics for each sending domain"
+    ),
+    top_bounce_reasons: arrayOf(
+      object({ reason: string("Bounce reason"), count: number("Bounces with this reason") }),
+      "Most common bounce reasons"
+    ),
+    notes: stringArray("Caveats about how the metrics were measured")
+  },
+  ["window", "summary"]
+);
+
 // src/tools.ts
 function textResult(value, isError = false) {
+  const isObject = value !== null && typeof value === "object" && !Array.isArray(value);
   return {
     content: [{ type: "text", text: typeof value === "string" ? value : JSON.stringify(value, null, 2) }],
+    ...!isError && isObject ? { structuredContent: value } : {},
     ...isError ? { isError: true } : {}
   };
 }
@@ -352,6 +619,13 @@ var paginationProps = {
   limit: { type: "number", description: "Page size (1\u2013100)" },
   cursor: { type: "string", description: "Opaque cursor for the next page" }
 };
+var readOnly = (title) => ({
+  title,
+  readOnlyHint: true,
+  destructiveHint: false,
+  idempotentHint: true,
+  openWorldHint: false
+});
 var MCP_TOOLS = [
   {
     name: "send_email",
@@ -361,10 +635,10 @@ var MCP_TOOLS = [
       properties: {
         from: { type: "string", description: "Sender address (must match a verified domain or sandbox sender)" },
         to: { type: "string", description: "Recipient email address" },
-        subject: { type: "string", description: "Optional when using a published template" },
-        html: { type: "string" },
-        text: { type: "string" },
-        reply_to: { type: "string" },
+        subject: { type: "string", description: "Subject line. Optional when using a published template" },
+        html: { type: "string", description: "HTML body. Do not combine with template_id or template_alias" },
+        text: { type: "string", description: "Plain-text body. Do not combine with template_id or template_alias" },
+        reply_to: { type: "string", description: "Address that replies should go to" },
         template_id: { type: "string", description: "Published template UUID" },
         template_alias: { type: "string", description: "Published template alias" },
         variables: {
@@ -374,6 +648,14 @@ var MCP_TOOLS = [
         }
       },
       required: ["from", "to"]
+    },
+    outputSchema: sendEmailOutput,
+    annotations: {
+      title: "Send email",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
     }
   },
   {
@@ -382,7 +664,9 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: { ...paginationProps }
-    }
+    },
+    outputSchema: pagedOutput("emails", emailItem, "Emails on this page, newest first"),
+    annotations: readOnly("List emails")
   },
   {
     name: "get_email",
@@ -393,7 +677,9 @@ var MCP_TOOLS = [
         id: { type: "string", description: "Email id (msg_\u2026)" }
       },
       required: ["id"]
-    }
+    },
+    outputSchema: getEmailOutput,
+    annotations: readOnly("Get email")
   },
   {
     name: "list_domains",
@@ -401,7 +687,9 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: { ...paginationProps }
-    }
+    },
+    outputSchema: pagedOutput("domains", domainItem, "Sending domains on this page"),
+    annotations: readOnly("List domains")
   },
   {
     name: "create_domain",
@@ -413,6 +701,14 @@ var MCP_TOOLS = [
         inbound_enabled: { type: "boolean", description: "Enable inbound receiving on this domain" }
       },
       required: ["name"]
+    },
+    outputSchema: domainWithRecordsOutput,
+    annotations: {
+      title: "Create domain",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
     }
   },
   {
@@ -421,14 +717,28 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        domain: { type: "string" },
-        provider: { type: "string", enum: ["cloudflare", "godaddy", "vercel"] },
+        domain: { type: "string", description: "Domain name or id of a domain already added to this account (example.com)" },
+        provider: {
+          type: "string",
+          enum: ["cloudflare", "godaddy", "vercel"],
+          description: "DNS provider that hosts the domain"
+        },
         credentials: {
           type: "object",
           description: "Optional inline registrar credentials (GoDaddy api key/secret)"
         }
       },
       required: ["domain", "provider"]
+    },
+    outputSchema: applyDnsOutput,
+    // Writes to the user's DNS provider and can update records that already exist at the same host.
+    // Re-running it leaves matching records unchanged.
+    annotations: {
+      title: "Apply domain DNS records",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -437,9 +747,18 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        domain: { type: "string" }
+        domain: { type: "string", description: "Domain name or id to check (example.com)" }
       },
       required: ["domain"]
+    },
+    outputSchema: verifyDomainOutput,
+    // Looks up public DNS and records the result on the domain.
+    annotations: {
+      title: "Verify domain",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: true
     }
   },
   {
@@ -448,7 +767,9 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: { ...paginationProps }
-    }
+    },
+    outputSchema: pagedOutput("webhooks", webhookItem, "Webhook endpoints on this page"),
+    annotations: readOnly("List webhooks")
   },
   {
     name: "create_webhook",
@@ -464,6 +785,14 @@ var MCP_TOOLS = [
         }
       },
       required: ["url"]
+    },
+    outputSchema: createWebhookOutput,
+    annotations: {
+      title: "Create webhook",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
     }
   },
   {
@@ -475,6 +804,14 @@ var MCP_TOOLS = [
         id: { type: "string", description: "Webhook id (wh_\u2026)" }
       },
       required: ["id"]
+    },
+    outputSchema: okOutput,
+    annotations: {
+      title: "Delete webhook",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
     }
   },
   {
@@ -486,7 +823,9 @@ var MCP_TOOLS = [
         ...paginationProps,
         email: { type: "string", description: "Optional filter by email" }
       }
-    }
+    },
+    outputSchema: pagedOutput("data", suppressionItem, "Suppressed addresses on this page"),
+    annotations: readOnly("List suppressions")
   },
   {
     name: "add_suppression",
@@ -494,10 +833,19 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        email: { type: "string" },
-        reason: { type: "string" }
+        email: { type: "string", description: "Email address to stop sending to" },
+        reason: { type: "string", description: "Optional note on why the address is suppressed" }
       },
       required: ["email"]
+    },
+    outputSchema: suppressionOutput,
+    // Adding an address that is already suppressed updates that entry instead of creating a second one.
+    annotations: {
+      title: "Add suppression",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: true,
+      openWorldHint: false
     }
   },
   {
@@ -509,6 +857,14 @@ var MCP_TOOLS = [
         id: { type: "string", description: "Suppression id" },
         email: { type: "string", description: "Email address (alternative to id)" }
       }
+    },
+    outputSchema: okOutput,
+    annotations: {
+      title: "Remove suppression",
+      readOnlyHint: false,
+      destructiveHint: true,
+      idempotentHint: true,
+      openWorldHint: false
     }
   },
   {
@@ -518,9 +874,11 @@ var MCP_TOOLS = [
       type: "object",
       properties: {
         ...paginationProps,
-        status: { type: "string", enum: ["draft", "published"] }
+        status: { type: "string", enum: ["draft", "published"], description: "Optional filter by template status" }
       }
-    }
+    },
+    outputSchema: pagedOutput("data", templateItem, "Templates on this page"),
+    annotations: readOnly("List templates")
   },
   {
     name: "get_template",
@@ -531,7 +889,9 @@ var MCP_TOOLS = [
         id: { type: "string", description: "Template id (tpl_\u2026)" },
         alias: { type: "string", description: "Published alias (alternative to id)" }
       }
-    }
+    },
+    outputSchema: templateOutput,
+    annotations: readOnly("Get template")
   },
   {
     name: "create_template",
@@ -539,14 +899,22 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        name: { type: "string" },
-        subject: { type: "string" },
-        format: { type: "string", enum: ["html", "blocks"] },
-        html: { type: "string" },
-        text: { type: "string" },
-        alias: { type: "string" }
+        name: { type: "string", description: "Template name" },
+        subject: { type: "string", description: "Subject line, may contain {{variables}}" },
+        format: { type: "string", enum: ["html", "blocks"], description: "Template format (html or blocks)" },
+        html: { type: "string", description: "HTML body" },
+        text: { type: "string", description: "Plain-text body" },
+        alias: { type: "string", description: "Optional short alias to reference the template by instead of its id" }
       },
       required: ["name", "subject"]
+    },
+    outputSchema: templateOutput,
+    annotations: {
+      title: "Create template",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
     }
   },
   {
@@ -555,9 +923,18 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        id: { type: "string" },
-        alias: { type: "string" }
+        id: { type: "string", description: "Template id (tpl_\u2026)" },
+        alias: { type: "string", description: "Template alias (alternative to id)" }
       }
+    },
+    outputSchema: templateOutput,
+    // Each publish snapshots a new version; earlier versions are kept.
+    annotations: {
+      title: "Publish template",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: false
     }
   },
   {
@@ -578,6 +955,14 @@ var MCP_TOOLS = [
         }
       },
       required: ["event"]
+    },
+    outputSchema: testWebhookOutput,
+    annotations: {
+      title: "Send test webhook event",
+      readOnlyHint: false,
+      destructiveHint: false,
+      idempotentHint: false,
+      openWorldHint: true
     }
   },
   {
@@ -586,9 +971,11 @@ var MCP_TOOLS = [
     inputSchema: {
       type: "object",
       properties: {
-        window: { type: "string", enum: ["7d", "30d"] }
+        window: { type: "string", enum: ["7d", "30d"], description: "Time window to summarize (default 30d)" }
       }
-    }
+    },
+    outputSchema: deliverabilityOutput,
+    annotations: readOnly("Get deliverability metrics")
   }
 ];
 function resolveApiKey() {
@@ -603,7 +990,7 @@ function resolveApiKey() {
 }
 
 // src/server.ts
-var MCP_SERVER_VERSION = "0.5.8";
+var MCP_SERVER_VERSION = "0.5.11";
 var MCP_SERVER_INSTRUCTIONS = [
   "Groundmail sends transactional email from domains the user has verified.",
   'To test before a domain is verified, call send_email with from "noreply@mail.groundmail.dev" and to set to the Groundmail account email; sandbox sends to any other address are rejected.',
@@ -621,7 +1008,10 @@ function createMcpServer(apiKey, baseUrl) {
     tools: MCP_TOOLS.map((tool) => ({
       name: tool.name,
       description: tool.description,
-      inputSchema: tool.inputSchema
+      title: tool.annotations.title,
+      inputSchema: tool.inputSchema,
+      outputSchema: tool.outputSchema,
+      annotations: tool.annotations
     }))
   }));
   server.setRequestHandler(CallToolRequestSchema, async (request) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "groundmail-mcp",
-  "version": "0.5.8",
+  "version": "0.5.11",
   "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",
@@ -11,11 +11,12 @@
   "files": [
     "dist",
     "README.md",
-    "smithery.yaml"
+    "smithery.yaml",
+    "LICENSE"
   ],
   "repository": {
     "type": "git",
-    "url": "git+https://github.com/Groundmail/groundmail-sdks.git"
+    "url": "git+https://github.com/Groundmail/groundmail-mcp.git"
   },
   "homepage": "https://docs.groundmail.dev/ai/mcp",
   "keywords": [
@@ -40,11 +41,15 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.30.0",
-    "groundmail": "0.14.3"
+    "groundmail": "0.14.4"
   },
   "devDependencies": {
     "tsup": "^8.5.0",
     "typescript": "^5",
-    "vitest": "^3.2.4"
+    "vitest": "^3.2.4",
+    "@types/node": "^20"
+  },
+  "bugs": {
+    "url": "https://github.com/Groundmail/groundmail-mcp/issues"
   }
 }