postmark-mcp 1.0.0 → 1.0.1

package/.env.example

@@ -1,4 +1,4 @@
-# Postmark Configuration
-POSTMARK_SERVER_TOKEN=your-postmark-server-token-here
-DEFAULT_SENDER_EMAIL=your-sender-email@example.com
-DEFAULT_MESSAGE_STREAM=outbound
+# Secure your tokens properly! We advise not putting your tokens directly in code if it will be hosted.
+POSTMARK_SERVER_TOKEN=your-postmark-server-token
+DEFAULT_SENDER_EMAIL=info@example.com
+DEFAULT_MESSAGE_STREAM=outbound

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().email().describe("Recipient email address"),
-      subject: z.string().describe("Email subject"),
-      textBody: z.string().describe("Plain text body of the email"),
+      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"),
       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)"),
+      from: z.string().optional().describe("Sender email address (optional)"),
       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` : ''}`
         }]
       };
     }
@@ -284,4 +284,4 @@ function registerTools(server, postmarkClient) {
 main().catch((error) => {
   console.error('💥 Failed to start server:', error.message);
   process.exit(1);
-});
+});

package/package.json

@@ -1,31 +1,19 @@
 {
   "name": "postmark-mcp",
-  "version": "1.0.0",
+  "version": "1.0.1",
   "description": "Universal Postmark MCP server using official SDK",
   "main": "index.js",
   "type": "module",
-  "bin": {
-    "postmark-mcp": "./index.js"
-  },
-  "files": [
-    "index.js",
-    "README.md",
-    "LICENSE",
-    ".env.example"
-  ],
   "scripts": {
     "start": "node index.js",
     "inspector": "npx @modelcontextprotocol/inspector index.js"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/ActiveCampaign/postmark-mcp.git"
-  },
-  "homepage": "https://github.com/ActiveCampaign/postmark-mcp#readme",
-  "bugs": {
-    "url": "https://github.com/ActiveCampaign/postmark-mcp/issues"
-  },
-  "keywords": ["postmark", "email", "mcp", "ai", "model-context-protocol"],
+  "keywords": [
+    "postmark",
+    "email",
+    "mcp",
+    "ai"
+  ],
   "author": "Jabal Torres",
   "license": "MIT",
   "dependencies": {
@@ -35,4 +23,4 @@
     "postmark": "^4.0.5",
     "zod": "^3.23.8"
   }
-}
+}