postmark-mcp 1.0.9 → 1.0.11

package/index.js

@@ -50,10 +50,10 @@ async function initializeServices() {
 
     // Initialize Postmark client
     const client = new postmark.ServerClient(serverToken);
-    
+
     // Verify Postmark client by making a test API call
     await client.getServer();
-    
+
     // Create MCP server
     const mcpServer = new McpServer({
       name: "postmark-mcp",
@@ -73,16 +73,16 @@ async function initializeServices() {
 async function main() {
   try {
     const { postmarkClient, mcpServer: server } = await initializeServices();
-    
+
     // Register tools with validated client
     registerTools(server, postmarkClient);
-    
+
     console.error('Connecting to MCP transport...');
     const transport = new StdioServerTransport();
     await server.connect(transport);
-    
+
     console.error('Postmark MCP server is running and ready!');
-    
+
     // Setup graceful shutdown
     process.on('SIGTERM', () => handleShutdown(server));
     process.on('SIGINT', () => handleShutdown(server));
@@ -122,19 +122,25 @@ function registerTools(server, postmarkClient) {
   server.tool(
     "sendEmail",
     {
-      to: z.string().email().describe("Recipient email address"),
+      to: z.string().describe("Recipient email address"),
       subject: z.string().describe("Email subject"),
       textBody: z.string().describe("Plain text body of the email"),
       htmlBody: z.string().optional().describe("HTML body of the email (optional)"),
-      from: z.string().email().optional().describe("Sender email address (optional, uses default if not provided)"),
-      tag: z.string().optional().describe("Optional tag for categorization")
+      from: z.string().optional().describe("Sender email address (optional, uses default if not provided)"),
+      tag: z.string().optional().describe("Optional tag for categorization"),
+      inReplyTo: z.string().optional().describe("Message ID this email is in reply to (optional)")
     },
     async ({ to, subject, textBody, htmlBody, from, tag }) => {
+      const headers = [
+        { "Name": "In-Reply-To", "Value": inReplyTo },
+        { "Name": "References", "Value": inReplyTo }
+      ];
       const emailData = {
         From: from || defaultSender,
         To: to,
         Subject: subject,
         TextBody: textBody,
+        Headers: inReplyTo ? headers : undefined,
         MessageStream: defaultMessageStream,
         TrackOpens: true,
         TrackLinks: "HtmlAndText"
@@ -146,7 +152,7 @@ function registerTools(server, postmarkClient) {
       console.error('Sending email...', { to, subject });
       const result = await postmarkClient.sendEmail(emailData);
       console.error('Email sent successfully:', result.MessageID);
-      
+
       return {
         content: [{
           type: "text",
@@ -192,10 +198,10 @@ function registerTools(server, postmarkClient) {
       console.error('Sending template email...', { to, templateId: templateId || templateAlias });
       const result = await postmarkClient.sendEmailWithTemplate(emailData);
       console.error('Template email sent successfully:', result.MessageID);
-      
+
       return {
         content: [{
-          type: "text", 
+          type: "text",
           text: `Template email sent successfully!\nMessageID: ${result.MessageID}\nTo: ${to}\nTemplate: ${templateId || templateAlias}`
         }]
       };
@@ -210,11 +216,11 @@ function registerTools(server, postmarkClient) {
       console.error('Fetching templates...');
       const result = await postmarkClient.getTemplates();
       console.error(`Found ${result.Templates.length} templates`);
-      
-      const templateList = result.Templates.map(t => 
+
+      const templateList = result.Templates.map(t =>
         `• **${t.Name}**\n  - ID: ${t.TemplateId}\n  - Alias: ${t.Alias || 'none'}\n  - Subject: ${t.Subject || 'none'}`
       ).join('\n\n');
-      
+
       return {
         content: [{
           type: "text",
@@ -231,18 +237,17 @@ function registerTools(server, postmarkClient) {
       tag: z.string().optional().describe("Filter by tag (optional)"),
       fromDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("Start date in YYYY-MM-DD format (optional)"),
       toDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("End date in YYYY-MM-DD format (optional)"),
-      foo: z.string().optional().describe("Just a test parameter")
     },
     async ({ tag, fromDate, toDate }) => {
       const query = [];
       if (fromDate) query.push(`fromdate=${encodeURIComponent(fromDate)}`);
       if (toDate) query.push(`todate=${encodeURIComponent(toDate)}`);
       if (tag) query.push(`tag=${encodeURIComponent(tag)}`);
-      
+
       const url = `https://api.postmarkapp.com/stats/outbound${query.length ? '?' + query.join('&') : ''}`;
-      
+
       console.error('Fetching delivery stats...');
-      
+
       const response = await fetch(url, {
         headers: {
           "Accept": "application/json",
@@ -256,25 +261,25 @@ function registerTools(server, postmarkClient) {
 
       const data = await response.json();
       console.error('Stats retrieved successfully');
-      
+
       const sent = data.Sent || 0;
       const tracked = data.Tracked || 0;
       const uniqueOpens = data.UniqueOpens || 0;
       const totalTrackedLinks = data.TotalTrackedLinksSent || 0;
       const uniqueLinksClicked = data.UniqueLinksClicked || 0;
-      
+
       const openRate = tracked > 0 ? ((uniqueOpens / tracked) * 100).toFixed(1) : '0.0';
       const clickRate = totalTrackedLinks > 0 ? ((uniqueLinksClicked / totalTrackedLinks) * 100).toFixed(1) : '0.0';
-      
+
       return {
         content: [{
           type: "text",
           text: `Email Statistics Summary\n\n` +
-                `Sent: ${sent} emails\n` +
-                `Open Rate: ${openRate}% (${uniqueOpens}/${tracked} tracked emails)\n` +
-                `Click Rate: ${clickRate}% (${uniqueLinksClicked}/${totalTrackedLinks} tracked links)\n\n` +
-                `${fromDate || toDate ? `Period: ${fromDate || 'start'} to ${toDate || 'now'}\n` : ''}` +
-                `${tag ? `Tag: ${tag}\n` : ''}`
+            `Sent: ${sent} emails\n` +
+            `Open Rate: ${openRate}% (${uniqueOpens}/${tracked} tracked emails)\n` +
+            `Click Rate: ${clickRate}% (${uniqueLinksClicked}/${totalTrackedLinks} tracked links)\n\n` +
+            `${fromDate || toDate ? `Period: ${fromDate || 'start'} to ${toDate || 'now'}\n` : ''}` +
+            `${tag ? `Tag: ${tag}\n` : ''}`
         }]
       };
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "postmark-mcp",
-  "version": "1.0.9",
+  "version": "1.0.11",
   "description": "Universal Postmark MCP server using official SDK",
   "main": "index.js",
   "bin": {