postmark-mcp 1.0.8 → 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 +27 -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",
|
@@ -230,18 +230,19 @@ function registerTools(server, postmarkClient) {
|
|
230
230
|
{
|
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
|
-
toDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("End date in YYYY-MM-DD format (optional)")
|
233
|
+
toDate: z.string().regex(/^\d{4}-\d{2}-\d{2}$/).optional().describe("End date in YYYY-MM-DD format (optional)"),
|
234
|
+
foob: z.string().optional().describe("Just a test parameter")
|
234
235
|
},
|
235
236
|
async ({ tag, fromDate, toDate }) => {
|
236
237
|
const query = [];
|
237
238
|
if (fromDate) query.push(`fromdate=${encodeURIComponent(fromDate)}`);
|
238
239
|
if (toDate) query.push(`todate=${encodeURIComponent(toDate)}`);
|
239
240
|
if (tag) query.push(`tag=${encodeURIComponent(tag)}`);
|
240
|
-
|
241
|
+
|
241
242
|
const url = `https://api.postmarkapp.com/stats/outbound${query.length ? '?' + query.join('&') : ''}`;
|
242
|
-
|
243
|
+
|
243
244
|
console.error('Fetching delivery stats...');
|
244
|
-
|
245
|
+
|
245
246
|
const response = await fetch(url, {
|
246
247
|
headers: {
|
247
248
|
"Accept": "application/json",
|
@@ -255,25 +256,25 @@ function registerTools(server, postmarkClient) {
|
|
255
256
|
|
256
257
|
const data = await response.json();
|
257
258
|
console.error('Stats retrieved successfully');
|
258
|
-
|
259
|
+
|
259
260
|
const sent = data.Sent || 0;
|
260
261
|
const tracked = data.Tracked || 0;
|
261
262
|
const uniqueOpens = data.UniqueOpens || 0;
|
262
263
|
const totalTrackedLinks = data.TotalTrackedLinksSent || 0;
|
263
264
|
const uniqueLinksClicked = data.UniqueLinksClicked || 0;
|
264
|
-
|
265
|
+
|
265
266
|
const openRate = tracked > 0 ? ((uniqueOpens / tracked) * 100).toFixed(1) : '0.0';
|
266
267
|
const clickRate = totalTrackedLinks > 0 ? ((uniqueLinksClicked / totalTrackedLinks) * 100).toFixed(1) : '0.0';
|
267
|
-
|
268
|
+
|
268
269
|
return {
|
269
270
|
content: [{
|
270
271
|
type: "text",
|
271
272
|
text: `Email Statistics Summary\n\n` +
|
272
|
-
|
273
|
-
|
274
|
-
|
275
|
-
|
276
|
-
|
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` : ''}`
|
277
278
|
}]
|
278
279
|
};
|
279
280
|
}
|