postmark-mcp 1.0.9 → 1.0.10
This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
- package/index.js +26 -26
- package/package.json +1 -1
package/index.js
CHANGED
@@ -50,10 +50,10 @@ async function initializeServices() {
|
|
50
50
|
|
51
51
|
// Initialize Postmark client
|
52
52
|
const client = new postmark.ServerClient(serverToken);
|
53
|
-
|
53
|
+
|
54
54
|
// Verify Postmark client by making a test API call
|
55
55
|
await client.getServer();
|
56
|
-
|
56
|
+
|
57
57
|
// Create MCP server
|
58
58
|
const mcpServer = new McpServer({
|
59
59
|
name: "postmark-mcp",
|
@@ -73,16 +73,16 @@ async function initializeServices() {
|
|
73
73
|
async function main() {
|
74
74
|
try {
|
75
75
|
const { postmarkClient, mcpServer: server } = await initializeServices();
|
76
|
-
|
76
|
+
|
77
77
|
// Register tools with validated client
|
78
78
|
registerTools(server, postmarkClient);
|
79
|
-
|
79
|
+
|
80
80
|
console.error('Connecting to MCP transport...');
|
81
81
|
const transport = new StdioServerTransport();
|
82
82
|
await server.connect(transport);
|
83
|
-
|
83
|
+
|
84
84
|
console.error('Postmark MCP server is running and ready!');
|
85
|
-
|
85
|
+
|
86
86
|
// Setup graceful shutdown
|
87
87
|
process.on('SIGTERM', () => handleShutdown(server));
|
88
88
|
process.on('SIGINT', () => handleShutdown(server));
|
@@ -122,11 +122,11 @@ function registerTools(server, postmarkClient) {
|
|
122
122
|
server.tool(
|
123
123
|
"sendEmail",
|
124
124
|
{
|
125
|
-
to: z.string().
|
125
|
+
to: z.string().describe("Recipient email address"),
|
126
126
|
subject: z.string().describe("Email subject"),
|
127
127
|
textBody: z.string().describe("Plain text body of the email"),
|
128
128
|
htmlBody: z.string().optional().describe("HTML body of the email (optional)"),
|
129
|
-
from: z.string().
|
129
|
+
from: z.string().optional().describe("Sender email address (optional, uses default if not provided)"),
|
130
130
|
tag: z.string().optional().describe("Optional tag for categorization")
|
131
131
|
},
|
132
132
|
async ({ to, subject, textBody, htmlBody, from, tag }) => {
|
@@ -146,7 +146,7 @@ function registerTools(server, postmarkClient) {
|
|
146
146
|
console.error('Sending email...', { to, subject });
|
147
147
|
const result = await postmarkClient.sendEmail(emailData);
|
148
148
|
console.error('Email sent successfully:', result.MessageID);
|
149
|
-
|
149
|
+
|
150
150
|
return {
|
151
151
|
content: [{
|
152
152
|
type: "text",
|
@@ -192,10 +192,10 @@ function registerTools(server, postmarkClient) {
|
|
192
192
|
console.error('Sending template email...', { to, templateId: templateId || templateAlias });
|
193
193
|
const result = await postmarkClient.sendEmailWithTemplate(emailData);
|
194
194
|
console.error('Template email sent successfully:', result.MessageID);
|
195
|
-
|
195
|
+
|
196
196
|
return {
|
197
197
|
content: [{
|
198
|
-
type: "text",
|
198
|
+
type: "text",
|
199
199
|
text: `Template email sent successfully!\nMessageID: ${result.MessageID}\nTo: ${to}\nTemplate: ${templateId || templateAlias}`
|
200
200
|
}]
|
201
201
|
};
|
@@ -210,11 +210,11 @@ function registerTools(server, postmarkClient) {
|
|
210
210
|
console.error('Fetching templates...');
|
211
211
|
const result = await postmarkClient.getTemplates();
|
212
212
|
console.error(`Found ${result.Templates.length} templates`);
|
213
|
-
|
214
|
-
const templateList = result.Templates.map(t =>
|
213
|
+
|
214
|
+
const templateList = result.Templates.map(t =>
|
215
215
|
`• **${t.Name}**\n - ID: ${t.TemplateId}\n - Alias: ${t.Alias || 'none'}\n - Subject: ${t.Subject || 'none'}`
|
216
216
|
).join('\n\n');
|
217
|
-
|
217
|
+
|
218
218
|
return {
|
219
219
|
content: [{
|
220
220
|
type: "text",
|
@@ -231,18 +231,18 @@ function registerTools(server, postmarkClient) {
|
|
231
231
|
tag: z.string().optional().describe("Filter by tag (optional)"),
|
232
232
|
fromDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("Start date in YYYY-MM-DD format (optional)"),
|
233
233
|
toDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("End date in YYYY-MM-DD format (optional)"),
|
234
|
-
|
234
|
+
foob: z.string().optional().describe("Just a test parameter")
|
235
235
|
},
|
236
236
|
async ({ tag, fromDate, toDate }) => {
|
237
237
|
const query = [];
|
238
238
|
if (fromDate) query.push(`fromdate=${encodeURIComponent(fromDate)}`);
|
239
239
|
if (toDate) query.push(`todate=${encodeURIComponent(toDate)}`);
|
240
240
|
if (tag) query.push(`tag=${encodeURIComponent(tag)}`);
|
241
|
-
|
241
|
+
|
242
242
|
const url = `https://api.postmarkapp.com/stats/outbound${query.length ? '?' + query.join('&') : ''}`;
|
243
|
-
|
243
|
+
|
244
244
|
console.error('Fetching delivery stats...');
|
245
|
-
|
245
|
+
|
246
246
|
const response = await fetch(url, {
|
247
247
|
headers: {
|
248
248
|
"Accept": "application/json",
|
@@ -256,25 +256,25 @@ function registerTools(server, postmarkClient) {
|
|
256
256
|
|
257
257
|
const data = await response.json();
|
258
258
|
console.error('Stats retrieved successfully');
|
259
|
-
|
259
|
+
|
260
260
|
const sent = data.Sent || 0;
|
261
261
|
const tracked = data.Tracked || 0;
|
262
262
|
const uniqueOpens = data.UniqueOpens || 0;
|
263
263
|
const totalTrackedLinks = data.TotalTrackedLinksSent || 0;
|
264
264
|
const uniqueLinksClicked = data.UniqueLinksClicked || 0;
|
265
|
-
|
265
|
+
|
266
266
|
const openRate = tracked > 0 ? ((uniqueOpens / tracked) * 100).toFixed(1) : '0.0';
|
267
267
|
const clickRate = totalTrackedLinks > 0 ? ((uniqueLinksClicked / totalTrackedLinks) * 100).toFixed(1) : '0.0';
|
268
|
-
|
268
|
+
|
269
269
|
return {
|
270
270
|
content: [{
|
271
271
|
type: "text",
|
272
272
|
text: `Email Statistics Summary\n\n` +
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
277
|
-
|
273
|
+
`Sent: ${sent} emails\n` +
|
274
|
+
`Open Rate: ${openRate}% (${uniqueOpens}/${tracked} tracked emails)\n` +
|
275
|
+
`Click Rate: ${clickRate}% (${uniqueLinksClicked}/${totalTrackedLinks} tracked links)\n\n` +
|
276
|
+
`${fromDate || toDate ? `Period: ${fromDate || 'start'} to ${toDate || 'now'}\n` : ''}` +
|
277
|
+
`${tag ? `Tag: ${tag}\n` : ''}`
|
278
278
|
}]
|
279
279
|
};
|
280
280
|
}
|