@bencibro/tempmail-mcp 0.0.1

package/dist/index.js

@@ -0,0 +1,519 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { ProviderManager, autoRegister, } from "./provider-manager.js";
+import { MailDropProvider } from "./providers/maildrop.js";
+import { MailCxProvider } from "./providers/mail-cx.js";
+import { extractVerificationCode, stripHtml, } from "./utils.js";
+// ─── In-memory mailbox store ──────────────────────────────────────────────
+// Keeps track of created mailboxes by address for later lookups.
+const mailboxStore = new Map();
+function serializeMailbox(mb) {
+    return {
+        address: mb.address,
+        provider: mb.provider,
+        createdAt: mb.createdAt,
+        password: mb.password,
+        token: mb.token,
+        sessionId: mb.sessionId,
+    };
+}
+// ─── Initialize providers ─────────────────────────────────────────────────
+const manager = new ProviderManager();
+manager.init({
+    maildropApiKey: process.env.MAILDROP_API_KEY,
+    mailCxApiToken: process.env.MAILCX_API_TOKEN,
+});
+// ─── Create MCP Server ────────────────────────────────────────────────────
+const server = new McpServer({
+    name: "tempmail-mcp",
+    version: "0.0.1",
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: list_providers
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("list_providers", "List all available temporary email providers and their capabilities.", {}, async () => {
+    const providers = manager.listProviders();
+    const lines = providers.map((p) => {
+        return `- **${p.name}**: ${p.description} (API key required: ${p.requiresApiKey ? "Yes" : "No"})`;
+    });
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Available temporary email providers:\n\n` +
+                    lines.join("\n") +
+                    `\n\nUse the \`create_mailbox\` tool with one of these provider names.`,
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: create_mailbox
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("create_mailbox", "Create a new temporary email mailbox. Returns the email address and account details.", {
+    provider: z
+        .string()
+        .optional()
+        .describe("Provider name (e.g. 'mail.tm', 'guerrillamail', '1secmail', 'catchmail', 'maildrop', 'mail.cx'). Defaults to 'mail.tm'."),
+    username: z
+        .string()
+        .optional()
+        .describe("Preferred username (local part of the email). If omitted, a random one is generated."),
+    domain: z
+        .string()
+        .optional()
+        .describe("Preferred domain. If omitted, a random one is chosen from the provider's available domains."),
+}, async ({ provider: providerName, username, domain }) => {
+    const provider = manager.getProviderOrThrow(providerName ?? "mail.tm");
+    const mailbox = await provider.createMailbox({ username, domain });
+    mailboxStore.set(mailbox.address, mailbox);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    address: mailbox.address,
+                    provider: mailbox.provider,
+                    createdAt: mailbox.createdAt,
+                    message: `Mailbox created. Use 'get_messages' to check for incoming emails, or 'wait_for_email' to block until one arrives.`,
+                }, null, 2),
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: get_messages
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("get_messages", "Get the list of received emails for a temporary mailbox. Returns message summaries (ID, from, subject, date).", {
+    address: z
+        .string()
+        .describe("The temporary email address to check for messages."),
+}, async ({ address }) => {
+    const mailbox = mailboxStore.get(address);
+    if (!mailbox) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: No mailbox found for address "${address}". Use 'create_mailbox' first, or ensure the address was created by this server.`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const provider = manager.getProviderOrThrow(mailbox.provider);
+    const messages = await provider.getMessages(mailbox);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    address,
+                    count: messages.length,
+                    messages: messages.map((m) => ({
+                        id: m.id,
+                        from: m.from,
+                        fromName: m.fromName,
+                        subject: m.subject,
+                        date: m.date,
+                    })),
+                }, null, 2),
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: get_message
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("get_message", "Get the full content of a specific email message (body text, HTML, attachments metadata).", {
+    address: z
+        .string()
+        .describe("The temporary email address that received the message."),
+    messageId: z
+        .string()
+        .describe("The message ID (from 'get_messages' result)."),
+}, async ({ address, messageId }) => {
+    const mailbox = mailboxStore.get(address);
+    if (!mailbox) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: No mailbox found for address "${address}".`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const provider = manager.getProviderOrThrow(mailbox.provider);
+    const msg = await provider.getMessage(mailbox, messageId);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    id: msg.id,
+                    from: msg.from,
+                    fromName: msg.fromName,
+                    subject: msg.subject,
+                    date: msg.date,
+                    bodyText: msg.bodyText,
+                    bodyHtml: msg.bodyHtml,
+                    bodyTextStripped: msg.bodyHtml
+                        ? stripHtml(msg.bodyHtml)
+                        : undefined,
+                    attachments: msg.attachments,
+                }, null, 2),
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: wait_for_email
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("wait_for_email", "Block (poll/long-poll) until a matching email arrives in the mailbox. Returns the first matching message. Useful for waiting for verification emails during signups.", {
+    address: z
+        .string()
+        .describe("The temporary email address to wait for emails on."),
+    subjectContains: z
+        .string()
+        .optional()
+        .describe("Only return emails whose subject contains this substring."),
+    fromContains: z
+        .string()
+        .optional()
+        .describe("Only return emails whose sender (from) contains this substring."),
+    timeoutMs: z
+        .number()
+        .optional()
+        .describe("Timeout in milliseconds. Default 60000 (60s)."),
+    pollIntervalMs: z
+        .number()
+        .optional()
+        .describe("Poll interval in milliseconds. Default 3000 (3s)."),
+}, async ({ address, subjectContains, fromContains, timeoutMs, pollIntervalMs }) => {
+    const mailbox = mailboxStore.get(address);
+    if (!mailbox) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: No mailbox found for address "${address}".`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const provider = manager.getProviderOrThrow(mailbox.provider);
+    try {
+        const msg = await provider.waitForEmail(mailbox, {
+            subjectContains,
+            fromContains,
+            timeoutMs,
+            pollIntervalMs,
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        found: true,
+                        message: {
+                            id: msg.id,
+                            from: msg.from,
+                            fromName: msg.fromName,
+                            subject: msg.subject,
+                            date: msg.date,
+                            bodyText: msg.bodyText,
+                            bodyHtml: msg.bodyHtml,
+                            bodyTextStripped: msg.bodyHtml
+                                ? stripHtml(msg.bodyHtml)
+                                : undefined,
+                            attachments: msg.attachments,
+                        },
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Timed out or error: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: get_verification_code
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("get_verification_code", "Wait for a verification/confirmation email and automatically extract the verification code from it. Returns the extracted code. This is a convenience tool that combines 'wait_for_email' + code extraction.", {
+    address: z
+        .string()
+        .describe("The temporary email address to check."),
+    subjectContains: z
+        .string()
+        .optional()
+        .describe("Filter: only look at emails whose subject contains this (e.g. 'verification', 'confirm', 'code')."),
+    fromContains: z
+        .string()
+        .optional()
+        .describe("Filter: only look at emails from senders containing this substring."),
+    timeoutMs: z
+        .number()
+        .optional()
+        .describe("Timeout in milliseconds. Default 60000 (60s)."),
+}, async ({ address, subjectContains, fromContains, timeoutMs }) => {
+    const mailbox = mailboxStore.get(address);
+    if (!mailbox) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: No mailbox found for address "${address}".`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const provider = manager.getProviderOrThrow(mailbox.provider);
+    try {
+        const msg = await provider.waitForEmail(mailbox, {
+            subjectContains,
+            fromContains,
+            timeoutMs,
+        });
+        const code = extractVerificationCode(msg);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify({
+                        success: true,
+                        code: code,
+                        messageId: msg.id,
+                        from: msg.from,
+                        subject: msg.subject,
+                        date: msg.date,
+                        bodyPreview: (msg.bodyText ?? stripHtml(msg.bodyHtml ?? ""))
+                            .slice(0, 500),
+                    }, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Failed to get verification code: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: delete_mailbox
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("delete_mailbox", "Delete a temporary mailbox and all its messages (if supported by the provider).", {
+    address: z
+        .string()
+        .describe("The temporary email address to delete."),
+}, async ({ address }) => {
+    const mailbox = mailboxStore.get(address);
+    if (!mailbox) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: No mailbox found for address "${address}".`,
+                },
+            ],
+            isError: true,
+        };
+    }
+    const provider = manager.getProviderOrThrow(mailbox.provider);
+    if (provider.deleteMailbox) {
+        try {
+            await provider.deleteMailbox(mailbox);
+            mailboxStore.delete(address);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: JSON.stringify({ success: true, address, deleted: true }),
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Error deleting mailbox: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    }
+    // Provider doesn't support deletion — just remove from store
+    mailboxStore.delete(address);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({
+                    success: true,
+                    address,
+                    deleted: false,
+                    note: "This provider does not support explicit mailbox deletion. Mailbox auto-expires.",
+                }),
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: list_mailboxes
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("list_mailboxes", "List all temporary mailboxes created in this session.", {}, async () => {
+    const mailboxes = Array.from(mailboxStore.values()).map(serializeMailbox);
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ count: mailboxes.length, mailboxes }, null, 2),
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: get_domains
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("get_domains", "Get the list of available email domains for a given provider.", {
+    provider: z
+        .string()
+        .optional()
+        .describe("Provider name. Defaults to 'mail.tm'."),
+}, async ({ provider: providerName }) => {
+    const provider = manager.getProviderOrThrow(providerName ?? "mail.tm");
+    const domains = await provider.getDomains();
+    return {
+        content: [
+            {
+                type: "text",
+                text: JSON.stringify({ provider: provider.name, domains }, null, 2),
+            },
+        ],
+    };
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Tool: auto_register
+// ═════════════════════════════════════════════════════════════════════════
+server.tool("auto_register", "Automatically register an account and obtain an API key/token for a provider. " +
+    "Uses pure HTTP API calls — no browser automation needed. " +
+    "Supported providers: 'maildrop' and 'mail.cx'. " +
+    "The resulting API key/token is automatically registered in the current session " +
+    "and also returned for the user to save.", {
+    provider: z
+        .enum(["maildrop", "mail.cx"])
+        .describe("The provider to auto-register. " +
+        "'maildrop': uses RSA key generation + HTTP API to register and obtain an md_ API key. " +
+        "'mail.cx': uses magic-link sign-in flow (creates a temp mailbox via mail.tm, receives the magic link, follows it, and creates an API token)."),
+    tokenName: z
+        .string()
+        .optional()
+        .describe("Name for the created API token (mail.cx only). Default: 'tempmail-mcp'."),
+    username: z
+        .string()
+        .optional()
+        .describe("Username for the account (maildrop only). If omitted, a random one is generated."),
+    timeoutMs: z
+        .number()
+        .optional()
+        .describe("Overall timeout in milliseconds. Default: 120000 (2 minutes)."),
+}, async ({ provider, tokenName, username, timeoutMs }) => {
+    try {
+        const result = await autoRegister(provider, {
+            tokenName: tokenName ?? "tempmail-mcp",
+            username,
+            timeoutMs: timeoutMs ?? 120_000,
+        });
+        // Dynamically register the provider with the obtained key
+        if (provider === "maildrop") {
+            manager.registerProvider("maildrop", new MailDropProvider(result.apiKey));
+            process.env.MAILDROP_API_KEY = result.apiKey;
+        }
+        else if (provider === "mail.cx") {
+            manager.registerProvider("mail.cx", new MailCxProvider(result.apiKey));
+            process.env.MAILCX_API_TOKEN = result.apiKey;
+        }
+        // Build a user-friendly summary
+        const summary = {
+            success: true,
+            provider: result.provider,
+            apiKey: result.apiKey,
+            email: result.email,
+            registeredAt: result.registeredAt,
+        };
+        if (result.metadata) {
+            summary.metadata = result.metadata;
+        }
+        if (provider === "maildrop") {
+            summary.instructions =
+                "API key is now active for this session. To make it permanent, set:\n" +
+                    `  MAILDROP_API_KEY=${result.apiKey}\n` +
+                    (result.metadata?.privateKey
+                        ? `  MAILDROP_PRIVATE_KEY=${result.metadata.privateKey}\n` +
+                            "  (Save the private key to re-login later if needed.)"
+                        : "");
+        }
+        else {
+            summary.instructions =
+                "API token is now active for this session. To make it permanent, set:\n" +
+                    `  MAILCX_API_TOKEN=${result.apiKey}`;
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: JSON.stringify(summary, null, 2),
+                },
+            ],
+        };
+    }
+    catch (err) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Auto-registration failed: ${err instanceof Error ? err.message : String(err)}`,
+                },
+            ],
+            isError: true,
+        };
+    }
+});
+// ═════════════════════════════════════════════════════════════════════════
+//  Start the server
+// ═════════════════════════════════════════════════════════════════════════
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("tempmail-mcp server started on stdio");
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/provider-manager.d.ts

@@ -0,0 +1,36 @@
+import type { TempMailProvider } from "./types.js";
+export { MailTmProvider } from "./providers/mail-tm.js";
+export { GuerrillaMailProvider } from "./providers/guerrillamail.js";
+export { OneSecMailProvider } from "./providers/one-secmail.js";
+export { CatchmailProvider } from "./providers/catchmail.js";
+export { MailDropProvider } from "./providers/maildrop.js";
+export { MailCxProvider } from "./providers/mail-cx.js";
+export { autoRegister, autoRegisterMailDrop, autoRegisterMailCx, } from "./providers/auto-register.js";
+export type { AutoRegisterResult } from "./providers/auto-register.js";
+export { BaseProvider } from "./base-provider.js";
+export * from "./types.js";
+export { extractVerificationCode, stripHtml } from "./utils.js";
+/**
+ * Provider manager — creates and caches provider instances.
+ * Provider instances are singleton per provider name.
+ */
+export declare class ProviderManager {
+    private providers;
+    /**
+     * Initialize providers based on available API keys.
+     * Providers without API keys are always available.
+     * Providers that need keys are only registered if the key is provided.
+     */
+    init(options?: {
+        maildropApiKey?: string;
+        mailCxApiToken?: string;
+    }): void;
+    /**
+     * Dynamically register a provider with an API key (e.g. after auto-registration).
+     */
+    registerProvider(name: string, provider: TempMailProvider): void;
+    getProvider(name: string): TempMailProvider | undefined;
+    getProviderOrThrow(name: string): TempMailProvider;
+    listProviders(): TempMailProvider[];
+}
+//# sourceMappingURL=provider-manager.d.ts.map

package/dist/provider-manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manager.d.ts","sourceRoot":"","sources":["../src/provider-manager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AAQnD,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EAAE,qBAAqB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAChE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACxD,OAAO,EACL,YAAY,EACZ,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,8BAA8B,CAAC;AACtC,YAAY,EAAE,kBAAkB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,uBAAuB,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEhE;;;GAGG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAuC;IAExD;;;;OAIG;IACH,IAAI,CAAC,OAAO,CAAC,EAAE;QACb,cAAc,CAAC,EAAE,MAAM,CAAC;QACxB,cAAc,CAAC,EAAE,MAAM,CAAC;KACzB,GAAG,IAAI;IAgBR;;OAEG;IACH,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,gBAAgB,GAAG,IAAI;IAIhE,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAIvD,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,gBAAgB;IAelD,aAAa,IAAI,gBAAgB,EAAE;CAGpC"}

package/dist/provider-manager.js

@@ -0,0 +1,67 @@
+import { MailTmProvider } from "./providers/mail-tm.js";
+import { GuerrillaMailProvider } from "./providers/guerrillamail.js";
+import { OneSecMailProvider } from "./providers/one-secmail.js";
+import { CatchmailProvider } from "./providers/catchmail.js";
+import { MailDropProvider } from "./providers/maildrop.js";
+import { MailCxProvider } from "./providers/mail-cx.js";
+export { MailTmProvider } from "./providers/mail-tm.js";
+export { GuerrillaMailProvider } from "./providers/guerrillamail.js";
+export { OneSecMailProvider } from "./providers/one-secmail.js";
+export { CatchmailProvider } from "./providers/catchmail.js";
+export { MailDropProvider } from "./providers/maildrop.js";
+export { MailCxProvider } from "./providers/mail-cx.js";
+export { autoRegister, autoRegisterMailDrop, autoRegisterMailCx, } from "./providers/auto-register.js";
+export { BaseProvider } from "./base-provider.js";
+export * from "./types.js";
+export { extractVerificationCode, stripHtml } from "./utils.js";
+/**
+ * Provider manager — creates and caches provider instances.
+ * Provider instances are singleton per provider name.
+ */
+export class ProviderManager {
+    providers = new Map();
+    /**
+     * Initialize providers based on available API keys.
+     * Providers without API keys are always available.
+     * Providers that need keys are only registered if the key is provided.
+     */
+    init(options) {
+        // Always-available providers (no API key needed)
+        this.providers.set("mail.tm", new MailTmProvider());
+        this.providers.set("guerrillamail", new GuerrillaMailProvider());
+        this.providers.set("1secmail", new OneSecMailProvider());
+        this.providers.set("catchmail", new CatchmailProvider());
+        // Optional providers (require API key)
+        if (options?.maildropApiKey) {
+            this.providers.set("maildrop", new MailDropProvider(options.maildropApiKey));
+        }
+        if (options?.mailCxApiToken) {
+            this.providers.set("mail.cx", new MailCxProvider(options.mailCxApiToken));
+        }
+    }
+    /**
+     * Dynamically register a provider with an API key (e.g. after auto-registration).
+     */
+    registerProvider(name, provider) {
+        this.providers.set(name, provider);
+    }
+    getProvider(name) {
+        return this.providers.get(name);
+    }
+    getProviderOrThrow(name) {
+        const provider = this.providers.get(name);
+        if (!provider) {
+            throw new Error(`Provider "${name}" not available. ` +
+                `Available providers: ${this.listProviders()
+                    .map((p) => p.name)
+                    .join(", ")}. ` +
+                `If this provider requires an API key, set the corresponding environment variable ` +
+                `or use the 'auto_register' tool.`);
+        }
+        return provider;
+    }
+    listProviders() {
+        return Array.from(this.providers.values());
+    }
+}
+//# sourceMappingURL=provider-manager.js.map

package/dist/provider-manager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"provider-manager.js","sourceRoot":"","sources":["../src/provider-manager.ts"],"names":[],"mappings":"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"}