postmark-mcp 1.0.1 → 1.0.3

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,11 +122,11 @@ function registerTools(server, postmarkClient) {
   server.tool(
     "sendEmail",
     {
-      to: z.string().optional().describe("Recipient email address"),
-      subject: z.string().optional().describe("Email subject"),
-      textBody: z.string().optional().describe("Plain text body of the email"),
+      to: z.string().email().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().optional().describe("Sender email address (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")
     },
     async ({ to, subject, textBody, htmlBody, from, tag }) => {
@@ -146,7 +146,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 +192,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 +210,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",
@@ -237,11 +237,11 @@ function registerTools(server, postmarkClient) {
       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",
@@ -255,25 +255,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.1",
+  "version": "1.0.3",
   "description": "Universal Postmark MCP server using official SDK",
   "main": "index.js",
   "type": "module",