@supernova123/resend-mcp-server 1.0.0

package/.github/FUNDING.yml

@@ -0,0 +1,7 @@
+# These funding sources support Nova MCP Servers
+github: [nova]
+# ko_fi: # Replace with a single Ko-fi username
+# patreon: # Replace with a single Patreon username
+# open_collective: # Replace with a single Open Collective username
+# community_bridge: # Replace with a single Community Bridge project name
+# custom: # Replace with up to 4 custom sponsorship URLs e.g., ["link1", "link2"]

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Nova
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/MARKETPLACE-LISTINGS.md

@@ -0,0 +1,84 @@
+# Marketplace Listings — Resend MCP Server
+
+## Listing 1: mcp.so
+
+**Title:** Resend MCP Server
+
+**Category:** Email & Communication
+
+**Description:**
+MCP server for Resend — the modern transactional email API. Send emails, manage sending domains, create API keys, and manage audience contacts through natural language. Works with Claude Desktop, Cursor, Windsurf, and any MCP-compatible client.
+
+Features:
+- Send transactional emails (HTML or plain text, with Cc/Bcc/Reply-To)
+- List and inspect sent emails with delivery status
+- Create and verify sending domains
+- Create and list API keys (full, sending, or domain-scoped)
+- List and add contacts to audiences
+- Rate-limited to 9 req/s, automatic retry on 429
+
+**Tags:** resend, email, transactional, smtp, api, mcp, automation
+
+**Installation:**
+```bash
+npx -y resend-mcp-server
+```
+
+---
+
+## Listing 2: Smithery (smithery.ai)
+
+**Title:** Resend
+
+**Description:**
+Connect AI assistants to Resend's transactional email API. Send emails, manage domains, mint API keys, and manage audience contacts through the Model Context Protocol. Requires a Resend API key.
+
+**Tools:** 10 (send_email, list_emails, get_email, create_domain, list_domains, verify_domain, create_api_key, list_api_keys, list_contacts, create_contact)
+
+**Transport:** stdio
+
+**Config:**
+```json
+{
+  "command": "npx",
+  "args": ["-y", "resend-mcp-server"],
+  "env": {
+    "RESEND_API_KEY": "re_xxxxxxxxxxxx"
+  }
+}
+```
+
+---
+
+## Listing 3: Glama MCP
+
+**Title:** Resend MCP Server
+
+**Description:**
+Access Resend's transactional email API through MCP. Send emails, manage sending domains, create API keys, and manage audience contacts. Works with Claude Desktop, Cursor, and other MCP clients. Requires a Resend API key.
+
+**Category:** Communication
+
+**Tools:** 10
+
+**Tags:** resend, email, transactional, smtp, api, automation
+
+---
+
+## Listing 4: There's An AI For That (TAAIFT)
+
+**Title:** Resend MCP Server
+
+**Category:** Developer Tools → AI Development → MCP Servers
+
+**Description:**
+MCP server that connects AI assistants to Resend's transactional email API. Send emails, manage sending domains, mint API keys, and manage audience contacts by talking to your AI. Requires a Resend API key (free tier supported).
+
+**Price:** Free (open source, MIT)
+
+---
+
+## Listing 5: Awesome MCP Servers (GitHub)
+
+**PR Description:**
+Add Resend MCP Server — send emails, manage domains & API keys for AI assistants. 10 tools: send/list/get email, create/list/verify domain, create/list API key, list/create contact. Resend API, TypeScript, MIT license.

package/README.md

@@ -0,0 +1,183 @@
+# Resend MCP Server
+
+> An MCP server for [Resend](https://resend.com) — connect any MCP-compatible client to the Resend transactional email API.
+
+[![MCP Compatible](https://img.shields.io/badge/MCP-compatible-blueviolet)](https://modelcontextprotocol.io)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.5-blue)](https://www.typescriptlang.org/)
+[![License: MIT](https://img.shields.io/badge/License-MIT-green.svg)](LICENSE)
+
+## What is this?
+
+An [MCP (Model Context Protocol)](https://modelcontextprotocol.io) server that gives AI assistants and agents access to [Resend](https://resend.com)'s email API — send transactional emails, manage sending domains, create API keys, and manage audience contacts — through natural language.
+
+Use it with **Claude Desktop**, **Cursor**, **Windsurf**, **Cline**, **Continue**, or any MCP-compatible client to send emails, manage infrastructure, and build automation around email.
+
+## Why use this?
+
+- **10 built-in tools** — covers sending, domains, API keys, and audiences
+- **Send emails by talking** — "send a welcome email to jane@example.com" just works
+- **Manage your infrastructure** — create/verify domains, mint API keys, manage contacts
+- **Rate-limited automatically** — respects Resend's 10 req/s free tier, retries on 429
+- **Works with every MCP client** — Claude Desktop, Cursor, Windsurf, Cline, Continue, and more
+
+## Tools
+
+| Tool | Description |
+|------|-------------|
+| `send_email` | Send a transactional email (HTML or plain text, with Cc/Bcc/Reply-To) |
+| `list_emails` | List recent sent emails with their delivery status |
+| `get_email` | Get details for a specific email by ID |
+| `create_domain` | Add a new sending domain |
+| `list_domains` | List all sending domains in your account |
+| `verify_domain` | Trigger DNS verification for a domain |
+| `create_api_key` | Create a new API key (full, sending, or domain-scoped) |
+| `list_api_keys` | List all API keys (tokens are hidden) |
+| `list_contacts` | List contacts in an audience |
+| `create_contact` | Add a new contact to an audience |
+
+## Quick Start
+
+### 1. Get a Resend API key
+
+Sign up at [resend.com](https://resend.com) and grab an API key from [resend.com/api-keys](https://resend.com/api-keys).
+
+### 2. Install
+
+```bash
+npm install -g resend-mcp-server
+```
+
+Or run directly with npx:
+
+```bash
+npx -y resend-mcp-server
+```
+
+### 3. Configure your MCP client
+
+Add to your MCP client config (e.g. `claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "resend": {
+      "command": "npx",
+      "args": ["-y", "resend-mcp-server"],
+      "env": {
+        "RESEND_API_KEY": "re_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+Or with global install:
+
+```json
+{
+  "mcpServers": {
+    "resend": {
+      "command": "resend-mcp-server",
+      "env": {
+        "RESEND_API_KEY": "re_xxxxxxxxxxxx"
+      }
+    }
+  }
+}
+```
+
+### 4. Use it
+
+Ask your AI assistant things like:
+
+- "Send an email to jane@example.com thanking her for signing up"
+- "List the last 5 emails I sent"
+- "What happened to email ID `abc-123`?"
+- "Create a new sending domain for `mail.acme.com`"
+- "Verify domain `domain-xyz`"
+- "List all my sending domains"
+- "Mint a new API key called 'production-server'"
+- "List all my API keys"
+- "Add jane@example.com to audience `audience-1`"
+- "Show me the contacts in audience `audience-1`"
+
+## Example Output
+
+### `send_email`
+
+```
+✅ Email sent
+
+- ID: `a1b2c3d4-...`
+```
+
+### `list_emails`
+
+```
+📧 Recent Emails (3):
+
+1. Welcome to Acme!
+   From: Acme <hello@acme.com> → To: jane@example.com
+   ID: `a1b2c3d4-...` | Last Event: delivered | Created: 2026-01-15T10:30:00Z
+
+2. Your receipt
+   From: Acme <billing@acme.com> → To: bob@example.com
+   ID: `e5f6g7h8-...` | Last Event: opened | Created: 2026-01-15T09:15:00Z
+```
+
+### `create_domain`
+
+```
+✅ Domain created
+
+mail.acme.com
+- ID: `domain-xyz-...`
+- Status: pending
+- Region: us-east-1
+- Created: 2026-01-15T10:30:00Z
+
+DNS Records:
+- `mail.acme.com` `MX` → `feedback-smtp.us-east-1.amazonses.com`
+- `resend._domainkey.mail.acme.com` `TXT` → `v=DKIM1; k=rsa; p=MIGfMA0GCSq...`
+- `mail.acme.com` `TXT` → `v=spf1 include:amazonses.com ~all`
+```
+
+## Requirements
+
+- Node.js 18+
+- A [Resend](https://resend.com) account and API key (`RESEND_API_KEY`)
+
+## Rate Limits
+
+The server automatically rate-limits requests to ~9 calls/second to stay safely under Resend's free-tier limit of 10 req/s. If you hit a 429 anyway, it waits 2s and retries once.
+
+## API Reference
+
+All endpoints hit `https://api.resend.com` with a `Bearer` token. See the [Resend docs](https://resend.com/docs) for full details.
+
+| Tool | Method | Path |
+|------|--------|------|
+| `send_email` | POST | `/emails` |
+| `list_emails` | GET | `/emails` |
+| `get_email` | GET | `/emails/{id}` |
+| `create_domain` | POST | `/domains` |
+| `list_domains` | GET | `/domains` |
+| `verify_domain` | POST | `/domains/{id}/verify` |
+| `create_api_key` | POST | `/api-keys` |
+| `list_api_keys` | GET | `/api-keys` |
+| `list_contacts` | GET | `/audiences/{id}/contacts` |
+| `create_contact` | POST | `/audiences/{id}/contacts` |
+
+## Development
+
+```bash
+git clone https://github.com/nova/resend-mcp-server.git
+cd resend-mcp-server
+npm install
+npm run build
+RESEND_API_KEY=re_xxxx npm start
+```
+
+## License
+
+MIT

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+/**
+ * Resend MCP Server
+ *
+ * Connect AI assistants to Resend's transactional email API.
+ * Send emails, manage domains, create API keys, and manage contacts
+ * through the Model Context Protocol.
+ *
+ * Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.
+ */
+export {};

package/dist/index.js

@@ -0,0 +1,400 @@
+#!/usr/bin/env node
+/**
+ * Resend MCP Server
+ *
+ * Connect AI assistants to Resend's transactional email API.
+ * Send emails, manage domains, create API keys, and manage contacts
+ * through the Model Context Protocol.
+ *
+ * Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.
+ */
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+const RESEND_BASE = "https://api.resend.com";
+// Rate limiter: Resend free tier = 10 req/s. We use 110ms (~9 req/s) to stay safely under.
+let lastCall = 0;
+const MIN_INTERVAL = 110; // ~9 req/s, safe for free tier (10 req/s)
+async function rateLimitedFetch(path, init = {}) {
+    const apiKey = process.env.RESEND_API_KEY;
+    if (!apiKey) {
+        throw new Error("RESEND_API_KEY environment variable is not set. Get an API key at https://resend.com/api-keys");
+    }
+    const now = Date.now();
+    const wait = MIN_INTERVAL - (now - lastCall);
+    if (wait > 0) {
+        await new Promise((r) => setTimeout(r, wait));
+    }
+    lastCall = Date.now();
+    const res = await fetch(`${RESEND_BASE}${path}`, {
+        ...init,
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            Accept: "application/json",
+            ...(init.headers || {}),
+        },
+    });
+    if (res.status === 429) {
+        // Rate limited — wait and retry once
+        await new Promise((r) => setTimeout(r, 2000));
+        const retry = await fetch(`${RESEND_BASE}${path}`, {
+            ...init,
+            headers: {
+                Authorization: `Bearer ${apiKey}`,
+                "Content-Type": "application/json",
+                Accept: "application/json",
+                ...(init.headers || {}),
+            },
+        });
+        if (!retry.ok) {
+            const text = await retry.text();
+            throw new Error(`Resend API error (${retry.status}): ${text}`);
+        }
+        return retry.json();
+    }
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Resend API error (${res.status}): ${text}`);
+    }
+    // 204 No Content (e.g. some DELETE/PUT endpoints)
+    if (res.status === 204) {
+        return null;
+    }
+    return res.json();
+}
+// ── Formatting helpers ──
+function formatEmail(e) {
+    const lines = [];
+    lines.push(`**${e.subject || "(no subject)"}**`);
+    lines.push(`- **ID:** \`${e.id}\``);
+    lines.push(`- **From:** ${e.from}`);
+    lines.push(`- **To:** ${Array.isArray(e.to) ? e.to.join(", ") : e.to}`);
+    if (e.cc)
+        lines.push(`- **Cc:** ${Array.isArray(e.cc) ? e.cc.join(", ") : e.cc}`);
+    if (e.bcc)
+        lines.push(`- **Bcc:** ${Array.isArray(e.bcc) ? e.bcc.join(", ") : e.bcc}`);
+    if (e.reply_to)
+        lines.push(`- **Reply-To:** ${Array.isArray(e.reply_to) ? e.reply_to.join(", ") : e.reply_to}`);
+    lines.push(`- **Created:** ${e.created_at || "N/A"}`);
+    if (e.last_event)
+        lines.push(`- **Last Event:** ${e.last_event}`);
+    if (e.status)
+        lines.push(`- **Status:** ${e.status}`);
+    if (e.scheduled_at)
+        lines.push(`- **Scheduled:** ${e.scheduled_at}`);
+    return lines.join("\n");
+}
+function formatDomain(d) {
+    const lines = [];
+    lines.push(`**${d.name}**`);
+    lines.push(`- **ID:** \`${d.id}\``);
+    lines.push(`- **Status:** ${d.status || "N/A"}`);
+    lines.push(`- **Region:** ${d.region || "N/A"}`);
+    lines.push(`- **Created:** ${d.created_at || "N/A"}`);
+    if (d.records && d.records.length) {
+        lines.push("");
+        lines.push("**DNS Records:**");
+        for (const r of d.records) {
+            lines.push(`- \`${r.record}\` \`${r.type}\` → \`${r.value}\`${r.ttl ? ` (TTL ${r.ttl})` : ""}`);
+        }
+    }
+    return lines.join("\n");
+}
+function formatApiKey(k) {
+    const lines = [];
+    lines.push(`**${k.name}**`);
+    lines.push(`- **ID:** \`${k.id}\``);
+    lines.push(`- **Token:** \`${k.token || "(hidden — only shown on create)"}\``);
+    lines.push(`- **Created:** ${k.created_at || "N/A"}`);
+    return lines.join("\n");
+}
+function formatContact(c) {
+    const lines = [];
+    lines.push(`**${c.first_name || ""}${c.last_name ? " " + c.last_name : ""}** <${c.email}>`);
+    lines.push(`- **ID:** \`${c.id}\``);
+    if (c.unsubscribed)
+        lines.push(`- **Status:** Unsubscribed`);
+    else
+        lines.push(`- **Status:** Subscribed`);
+    lines.push(`- **Created:** ${c.created_at || "N/A"}`);
+    return lines.join("\n");
+}
+// Create server
+const server = new McpServer({
+    name: "resend",
+    version: "1.0.0",
+});
+// ── Tool: send_email ──
+server.tool("send_email", "Send a transactional email via Resend", {
+    from: z.string().describe("Sender address (e.g. 'Acme <noreply@acme.com>')"),
+    to: z.union([z.string(), z.array(z.string())]).describe("Recipient address(es)"),
+    subject: z.string().describe("Email subject line"),
+    html: z.string().optional().describe("HTML body"),
+    text: z.string().optional().describe("Plain text body"),
+    cc: z.union([z.string(), z.array(z.string())]).optional().describe("Cc address(es)"),
+    bcc: z.union([z.string(), z.array(z.string())]).optional().describe("Bcc address(es)"),
+    reply_to: z.union([z.string(), z.array(z.string())]).optional().describe("Reply-To address(es)"),
+    scheduled_at: z.string().optional().describe("ISO 8601 datetime to schedule the email"),
+    headers: z.record(z.string()).optional().describe("Custom headers as key/value pairs"),
+}, async ({ from, to, subject, html, text, cc, bcc, reply_to, scheduled_at, headers }) => {
+    try {
+        if (!html && !text) {
+            return {
+                content: [
+                    { type: "text", text: "Error: Provide either `html` or `text` body." },
+                ],
+            };
+        }
+        const body = { from, to, subject };
+        if (html)
+            body.html = html;
+        if (text)
+            body.text = text;
+        if (cc)
+            body.cc = cc;
+        if (bcc)
+            body.bcc = bcc;
+        if (reply_to)
+            body.reply_to = reply_to;
+        if (scheduled_at)
+            body.scheduled_at = scheduled_at;
+        if (headers)
+            body.headers = headers;
+        const data = await rateLimitedFetch("/emails", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ **Email sent**\n\n- **ID:** \`${data.id}\``,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: list_emails ──
+server.tool("list_emails", "List recent emails sent via Resend", {
+    limit: z.number().optional().default(20).describe("Max emails to return (default 20)"),
+}, async ({ limit }) => {
+    try {
+        const data = await rateLimitedFetch(`/emails?limit=${Math.min(limit, 100)}`);
+        const emails = data.data || [];
+        if (emails.length === 0) {
+            return { content: [{ type: "text", text: "No emails found." }] };
+        }
+        const lines = emails.map((e, i) => {
+            const to = Array.isArray(e.to) ? e.to.join(", ") : e.to;
+            return `**${i + 1}. ${e.subject || "(no subject)"}**\n   From: ${e.from} → To: ${to}\n   ID: \`${e.id}\` | Last Event: ${e.last_event || "N/A"} | Created: ${e.created_at}`;
+        });
+        return {
+            content: [
+                { type: "text", text: `**📧 Recent Emails (${emails.length}):**\n\n${lines.join("\n\n")}` },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: get_email ──
+server.tool("get_email", "Get details about a specific email by ID", {
+    email_id: z.string().describe("Email ID (from send_email or list_emails)"),
+}, async ({ email_id }) => {
+    try {
+        const data = await rateLimitedFetch(`/emails/${email_id}`);
+        return { content: [{ type: "text", text: formatEmail(data) }] };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: create_domain ──
+server.tool("create_domain", "Create a new sending domain in Resend", {
+    name: z.string().describe("Domain name (e.g. 'mail.acme.com')"),
+    region: z.enum(["us-east-1", "eu-west-1", "sa-east-1", "ap-northeast-1"]).optional().describe("AWS region (default: us-east-1)"),
+}, async ({ name, region }) => {
+    try {
+        const body = { name };
+        if (region)
+            body.region = region;
+        const data = await rateLimitedFetch("/domains", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ **Domain created**\n\n${formatDomain(data)}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: list_domains ──
+server.tool("list_domains", "List all sending domains in your Resend account", {
+    limit: z.number().optional().default(20).describe("Max domains to return (default 20)"),
+}, async ({ limit }) => {
+    try {
+        const data = await rateLimitedFetch(`/domains?limit=${Math.min(limit, 100)}`);
+        const domains = data.data || [];
+        if (domains.length === 0) {
+            return { content: [{ type: "text", text: "No domains found." }] };
+        }
+        const lines = domains.map((d, i) => `**${i + 1}. ${d.name}** — Status: ${d.status || "N/A"} | Region: ${d.region || "N/A"} | ID: \`${d.id}\``);
+        return {
+            content: [
+                { type: "text", text: `**🌐 Domains (${domains.length}):**\n\n${lines.join("\n")}` },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: verify_domain ──
+server.tool("verify_domain", "Trigger verification of a domain's DNS records", {
+    domain_id: z.string().describe("Domain ID (from create_domain or list_domains)"),
+}, async ({ domain_id }) => {
+    try {
+        const data = await rateLimitedFetch(`/domains/${domain_id}/verify`, {
+            method: "POST",
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ **Verification triggered**\n\n${formatDomain(data)}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: create_api_key ──
+server.tool("create_api_key", "Create a new Resend API key (token is only returned once)", {
+    name: z.string().describe("Friendly name for the key (e.g. 'production-server')"),
+    permission: z.enum(["full_access", "sending_access", "domain_read"]).optional().default("full_access").describe("Permission scope (default: full_access)"),
+    domain_id: z.string().optional().describe("Restrict key to a specific domain (for sending_access)"),
+}, async ({ name, permission, domain_id }) => {
+    try {
+        const body = { name };
+        if (permission)
+            body.permission = permission;
+        if (domain_id)
+            body.domain_id = domain_id;
+        const data = await rateLimitedFetch("/api-keys", {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ **API key created**\n\n${formatApiKey(data)}\n\n⚠️ **Save the token now — it will not be shown again.**`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: list_api_keys ──
+server.tool("list_api_keys", "List all API keys in your Resend account (tokens are hidden)", {}, async () => {
+    try {
+        const data = await rateLimitedFetch("/api-keys");
+        const keys = data.data || [];
+        if (keys.length === 0) {
+            return { content: [{ type: "text", text: "No API keys found." }] };
+        }
+        const lines = keys.map((k, i) => `**${i + 1}. ${k.name}** — ID: \`${k.id}\` | Created: ${k.created_at || "N/A"}`);
+        return {
+            content: [
+                { type: "text", text: `**🔑 API Keys (${keys.length}):**\n\n${lines.join("\n")}` },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: list_contacts ──
+server.tool("list_contacts", "List contacts in a Resend audience", {
+    audience_id: z.string().describe("Audience ID (e.g. from your Resend dashboard)"),
+    limit: z.number().optional().default(20).describe("Max contacts to return (default 20)"),
+}, async ({ audience_id, limit }) => {
+    try {
+        const data = await rateLimitedFetch(`/audiences/${audience_id}/contacts?limit=${Math.min(limit, 100)}`);
+        const contacts = data.data || [];
+        if (contacts.length === 0) {
+            return { content: [{ type: "text", text: "No contacts found." }] };
+        }
+        const lines = contacts.map((c, i) => {
+            const name = `${c.first_name || ""}${c.last_name ? " " + c.last_name : ""}`.trim() || "(no name)";
+            return `**${i + 1}. ${name}** <${c.email}> — ${c.unsubscribed ? "Unsubscribed" : "Subscribed"} | ID: \`${c.id}\``;
+        });
+        return {
+            content: [
+                { type: "text", text: `**👥 Contacts (${contacts.length}):**\n\n${lines.join("\n")}` },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// ── Tool: create_contact ──
+server.tool("create_contact", "Add a new contact to a Resend audience", {
+    audience_id: z.string().describe("Audience ID"),
+    email: z.string().email().describe("Contact email address"),
+    first_name: z.string().optional().describe("First name"),
+    last_name: z.string().optional().describe("Last name"),
+    unsubscribed: z.boolean().optional().default(false).describe("Whether the contact is unsubscribed"),
+}, async ({ audience_id, email, first_name, last_name, unsubscribed }) => {
+    try {
+        const body = { email };
+        if (first_name)
+            body.first_name = first_name;
+        if (last_name)
+            body.last_name = last_name;
+        if (unsubscribed !== undefined)
+            body.unsubscribed = unsubscribed;
+        const data = await rateLimitedFetch(`/audiences/${audience_id}/contacts`, {
+            method: "POST",
+            body: JSON.stringify(body),
+        });
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `✅ **Contact created**\n\n${formatContact(data)}`,
+                },
+            ],
+        };
+    }
+    catch (e) {
+        return { content: [{ type: "text", text: `Error: ${e.message}` }] };
+    }
+});
+// Start server
+async function main() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    console.error("Fatal error:", err);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/package.json

@@ -0,0 +1,48 @@
+{
+  "name": "@supernova123/resend-mcp-server",
+  "version": "1.0.0",
+  "description": "MCP server for Resend \u2014 transactional email API for AI assistants",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "resend-mcp-server": "dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "dev": "tsc && node dist/index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "resend",
+    "email",
+    "transactional",
+    "api",
+    "ai",
+    "claude",
+    "cursor"
+  ],
+  "author": "Nova",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "typescript": "^5.5.0",
+    "@types/node": "^20.0.0"
+  },
+  "mcpName": "io.github.friendlygeorge/resend-mcp-server",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/friendlygeorge/resend-mcp-server.git"
+  },
+  "homepage": "https://github.com/friendlygeorge/resend-mcp-server#readme",
+  "bugs": {
+    "url": "https://github.com/friendlygeorge/resend-mcp-server/issues"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/src/index.ts

@@ -0,0 +1,457 @@
+#!/usr/bin/env node
+/**
+ * Resend MCP Server
+ *
+ * Connect AI assistants to Resend's transactional email API.
+ * Send emails, manage domains, create API keys, and manage contacts
+ * through the Model Context Protocol.
+ *
+ * Works with Claude Desktop, Cursor, Windsurf, Cline, and any MCP client.
+ */
+
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+
+const RESEND_BASE = "https://api.resend.com";
+
+// Rate limiter: Resend free tier = 10 req/s. We use 110ms (~9 req/s) to stay safely under.
+let lastCall = 0;
+const MIN_INTERVAL = 110; // ~9 req/s, safe for free tier (10 req/s)
+
+async function rateLimitedFetch(
+  path: string,
+  init: RequestInit = {}
+): Promise<any> {
+  const apiKey = process.env.RESEND_API_KEY;
+  if (!apiKey) {
+    throw new Error(
+      "RESEND_API_KEY environment variable is not set. Get an API key at https://resend.com/api-keys"
+    );
+  }
+
+  const now = Date.now();
+  const wait = MIN_INTERVAL - (now - lastCall);
+  if (wait > 0) {
+    await new Promise((r) => setTimeout(r, wait));
+  }
+  lastCall = Date.now();
+
+  const res = await fetch(`${RESEND_BASE}${path}`, {
+    ...init,
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      "Content-Type": "application/json",
+      Accept: "application/json",
+      ...(init.headers || {}),
+    },
+  });
+
+  if (res.status === 429) {
+    // Rate limited — wait and retry once
+    await new Promise((r) => setTimeout(r, 2000));
+    const retry = await fetch(`${RESEND_BASE}${path}`, {
+      ...init,
+      headers: {
+        Authorization: `Bearer ${apiKey}`,
+        "Content-Type": "application/json",
+        Accept: "application/json",
+        ...(init.headers || {}),
+      },
+    });
+    if (!retry.ok) {
+      const text = await retry.text();
+      throw new Error(`Resend API error (${retry.status}): ${text}`);
+    }
+    return retry.json();
+  }
+
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`Resend API error (${res.status}): ${text}`);
+  }
+
+  // 204 No Content (e.g. some DELETE/PUT endpoints)
+  if (res.status === 204) {
+    return null;
+  }
+  return res.json();
+}
+
+// ── Formatting helpers ──
+
+function formatEmail(e: any): string {
+  const lines: string[] = [];
+  lines.push(`**${e.subject || "(no subject)"}**`);
+  lines.push(`- **ID:** \`${e.id}\``);
+  lines.push(`- **From:** ${e.from}`);
+  lines.push(`- **To:** ${Array.isArray(e.to) ? e.to.join(", ") : e.to}`);
+  if (e.cc) lines.push(`- **Cc:** ${Array.isArray(e.cc) ? e.cc.join(", ") : e.cc}`);
+  if (e.bcc) lines.push(`- **Bcc:** ${Array.isArray(e.bcc) ? e.bcc.join(", ") : e.bcc}`);
+  if (e.reply_to) lines.push(`- **Reply-To:** ${Array.isArray(e.reply_to) ? e.reply_to.join(", ") : e.reply_to}`);
+  lines.push(`- **Created:** ${e.created_at || "N/A"}`);
+  if (e.last_event) lines.push(`- **Last Event:** ${e.last_event}`);
+  if (e.status) lines.push(`- **Status:** ${e.status}`);
+  if (e.scheduled_at) lines.push(`- **Scheduled:** ${e.scheduled_at}`);
+  return lines.join("\n");
+}
+
+function formatDomain(d: any): string {
+  const lines: string[] = [];
+  lines.push(`**${d.name}**`);
+  lines.push(`- **ID:** \`${d.id}\``);
+  lines.push(`- **Status:** ${d.status || "N/A"}`);
+  lines.push(`- **Region:** ${d.region || "N/A"}`);
+  lines.push(`- **Created:** ${d.created_at || "N/A"}`);
+  if (d.records && d.records.length) {
+    lines.push("");
+    lines.push("**DNS Records:**");
+    for (const r of d.records) {
+      lines.push(`- \`${r.record}\` \`${r.type}\` → \`${r.value}\`${r.ttl ? ` (TTL ${r.ttl})` : ""}`);
+    }
+  }
+  return lines.join("\n");
+}
+
+function formatApiKey(k: any): string {
+  const lines: string[] = [];
+  lines.push(`**${k.name}**`);
+  lines.push(`- **ID:** \`${k.id}\``);
+  lines.push(`- **Token:** \`${k.token || "(hidden — only shown on create)"}\``);
+  lines.push(`- **Created:** ${k.created_at || "N/A"}`);
+  return lines.join("\n");
+}
+
+function formatContact(c: any): string {
+  const lines: string[] = [];
+  lines.push(`**${c.first_name || ""}${c.last_name ? " " + c.last_name : ""}** <${c.email}>`);
+  lines.push(`- **ID:** \`${c.id}\``);
+  if (c.unsubscribed) lines.push(`- **Status:** Unsubscribed`);
+  else lines.push(`- **Status:** Subscribed`);
+  lines.push(`- **Created:** ${c.created_at || "N/A"}`);
+  return lines.join("\n");
+}
+
+// Create server
+const server = new McpServer({
+  name: "resend",
+  version: "1.0.0",
+});
+
+// ── Tool: send_email ──
+server.tool(
+  "send_email",
+  "Send a transactional email via Resend",
+  {
+    from: z.string().describe("Sender address (e.g. 'Acme <noreply@acme.com>')"),
+    to: z.union([z.string(), z.array(z.string())]).describe("Recipient address(es)"),
+    subject: z.string().describe("Email subject line"),
+    html: z.string().optional().describe("HTML body"),
+    text: z.string().optional().describe("Plain text body"),
+    cc: z.union([z.string(), z.array(z.string())]).optional().describe("Cc address(es)"),
+    bcc: z.union([z.string(), z.array(z.string())]).optional().describe("Bcc address(es)"),
+    reply_to: z.union([z.string(), z.array(z.string())]).optional().describe("Reply-To address(es)"),
+    scheduled_at: z.string().optional().describe("ISO 8601 datetime to schedule the email"),
+    headers: z.record(z.string()).optional().describe("Custom headers as key/value pairs"),
+  },
+  async ({ from, to, subject, html, text, cc, bcc, reply_to, scheduled_at, headers }) => {
+    try {
+      if (!html && !text) {
+        return {
+          content: [
+            { type: "text" as const, text: "Error: Provide either `html` or `text` body." },
+          ],
+        };
+      }
+      const body: any = { from, to, subject };
+      if (html) body.html = html;
+      if (text) body.text = text;
+      if (cc) body.cc = cc;
+      if (bcc) body.bcc = bcc;
+      if (reply_to) body.reply_to = reply_to;
+      if (scheduled_at) body.scheduled_at = scheduled_at;
+      if (headers) body.headers = headers;
+
+      const data = await rateLimitedFetch("/emails", {
+        method: "POST",
+        body: JSON.stringify(body),
+      });
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `✅ **Email sent**\n\n- **ID:** \`${data.id}\``,
+          },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: list_emails ──
+server.tool(
+  "list_emails",
+  "List recent emails sent via Resend",
+  {
+    limit: z.number().optional().default(20).describe("Max emails to return (default 20)"),
+  },
+  async ({ limit }) => {
+    try {
+      const data = await rateLimitedFetch(`/emails?limit=${Math.min(limit, 100)}`);
+      const emails = data.data || [];
+      if (emails.length === 0) {
+        return { content: [{ type: "text" as const, text: "No emails found." }] };
+      }
+      const lines = emails.map((e: any, i: number) => {
+        const to = Array.isArray(e.to) ? e.to.join(", ") : e.to;
+        return `**${i + 1}. ${e.subject || "(no subject)"}**\n   From: ${e.from} → To: ${to}\n   ID: \`${e.id}\` | Last Event: ${e.last_event || "N/A"} | Created: ${e.created_at}`;
+      });
+      return {
+        content: [
+          { type: "text" as const, text: `**📧 Recent Emails (${emails.length}):**\n\n${lines.join("\n\n")}` },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: get_email ──
+server.tool(
+  "get_email",
+  "Get details about a specific email by ID",
+  {
+    email_id: z.string().describe("Email ID (from send_email or list_emails)"),
+  },
+  async ({ email_id }) => {
+    try {
+      const data = await rateLimitedFetch(`/emails/${email_id}`);
+      return { content: [{ type: "text" as const, text: formatEmail(data) }] };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: create_domain ──
+server.tool(
+  "create_domain",
+  "Create a new sending domain in Resend",
+  {
+    name: z.string().describe("Domain name (e.g. 'mail.acme.com')"),
+    region: z.enum(["us-east-1", "eu-west-1", "sa-east-1", "ap-northeast-1"]).optional().describe("AWS region (default: us-east-1)"),
+  },
+  async ({ name, region }) => {
+    try {
+      const body: any = { name };
+      if (region) body.region = region;
+      const data = await rateLimitedFetch("/domains", {
+        method: "POST",
+        body: JSON.stringify(body),
+      });
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `✅ **Domain created**\n\n${formatDomain(data)}`,
+          },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: list_domains ──
+server.tool(
+  "list_domains",
+  "List all sending domains in your Resend account",
+  {
+    limit: z.number().optional().default(20).describe("Max domains to return (default 20)"),
+  },
+  async ({ limit }) => {
+    try {
+      const data = await rateLimitedFetch(`/domains?limit=${Math.min(limit, 100)}`);
+      const domains = data.data || [];
+      if (domains.length === 0) {
+        return { content: [{ type: "text" as const, text: "No domains found." }] };
+      }
+      const lines = domains.map((d: any, i: number) =>
+        `**${i + 1}. ${d.name}** — Status: ${d.status || "N/A"} | Region: ${d.region || "N/A"} | ID: \`${d.id}\``
+      );
+      return {
+        content: [
+          { type: "text" as const, text: `**🌐 Domains (${domains.length}):**\n\n${lines.join("\n")}` },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: verify_domain ──
+server.tool(
+  "verify_domain",
+  "Trigger verification of a domain's DNS records",
+  {
+    domain_id: z.string().describe("Domain ID (from create_domain or list_domains)"),
+  },
+  async ({ domain_id }) => {
+    try {
+      const data = await rateLimitedFetch(`/domains/${domain_id}/verify`, {
+        method: "POST",
+      });
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `✅ **Verification triggered**\n\n${formatDomain(data)}`,
+          },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: create_api_key ──
+server.tool(
+  "create_api_key",
+  "Create a new Resend API key (token is only returned once)",
+  {
+    name: z.string().describe("Friendly name for the key (e.g. 'production-server')"),
+    permission: z.enum(["full_access", "sending_access", "domain_read"]).optional().default("full_access").describe("Permission scope (default: full_access)"),
+    domain_id: z.string().optional().describe("Restrict key to a specific domain (for sending_access)"),
+  },
+  async ({ name, permission, domain_id }) => {
+    try {
+      const body: any = { name };
+      if (permission) body.permission = permission;
+      if (domain_id) body.domain_id = domain_id;
+      const data = await rateLimitedFetch("/api-keys", {
+        method: "POST",
+        body: JSON.stringify(body),
+      });
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `✅ **API key created**\n\n${formatApiKey(data)}\n\n⚠️ **Save the token now — it will not be shown again.**`,
+          },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: list_api_keys ──
+server.tool(
+  "list_api_keys",
+  "List all API keys in your Resend account (tokens are hidden)",
+  {},
+  async () => {
+    try {
+      const data = await rateLimitedFetch("/api-keys");
+      const keys = data.data || [];
+      if (keys.length === 0) {
+        return { content: [{ type: "text" as const, text: "No API keys found." }] };
+      }
+      const lines = keys.map((k: any, i: number) =>
+        `**${i + 1}. ${k.name}** — ID: \`${k.id}\` | Created: ${k.created_at || "N/A"}`
+      );
+      return {
+        content: [
+          { type: "text" as const, text: `**🔑 API Keys (${keys.length}):**\n\n${lines.join("\n")}` },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: list_contacts ──
+server.tool(
+  "list_contacts",
+  "List contacts in a Resend audience",
+  {
+    audience_id: z.string().describe("Audience ID (e.g. from your Resend dashboard)"),
+    limit: z.number().optional().default(20).describe("Max contacts to return (default 20)"),
+  },
+  async ({ audience_id, limit }) => {
+    try {
+      const data = await rateLimitedFetch(
+        `/audiences/${audience_id}/contacts?limit=${Math.min(limit, 100)}`
+      );
+      const contacts = data.data || [];
+      if (contacts.length === 0) {
+        return { content: [{ type: "text" as const, text: "No contacts found." }] };
+      }
+      const lines = contacts.map((c: any, i: number) => {
+        const name = `${c.first_name || ""}${c.last_name ? " " + c.last_name : ""}`.trim() || "(no name)";
+        return `**${i + 1}. ${name}** <${c.email}> — ${c.unsubscribed ? "Unsubscribed" : "Subscribed"} | ID: \`${c.id}\``;
+      });
+      return {
+        content: [
+          { type: "text" as const, text: `**👥 Contacts (${contacts.length}):**\n\n${lines.join("\n")}` },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// ── Tool: create_contact ──
+server.tool(
+  "create_contact",
+  "Add a new contact to a Resend audience",
+  {
+    audience_id: z.string().describe("Audience ID"),
+    email: z.string().email().describe("Contact email address"),
+    first_name: z.string().optional().describe("First name"),
+    last_name: z.string().optional().describe("Last name"),
+    unsubscribed: z.boolean().optional().default(false).describe("Whether the contact is unsubscribed"),
+  },
+  async ({ audience_id, email, first_name, last_name, unsubscribed }) => {
+    try {
+      const body: any = { email };
+      if (first_name) body.first_name = first_name;
+      if (last_name) body.last_name = last_name;
+      if (unsubscribed !== undefined) body.unsubscribed = unsubscribed;
+      const data = await rateLimitedFetch(`/audiences/${audience_id}/contacts`, {
+        method: "POST",
+        body: JSON.stringify(body),
+      });
+      return {
+        content: [
+          {
+            type: "text" as const,
+            text: `✅ **Contact created**\n\n${formatContact(data)}`,
+          },
+        ],
+      };
+    } catch (e: any) {
+      return { content: [{ type: "text" as const, text: `Error: ${e.message}` }] };
+    }
+  }
+);
+
+// Start server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+}
+
+main().catch((err) => {
+  console.error("Fatal error:", err);
+  process.exit(1);
+});

package/tsconfig.json

@@ -0,0 +1,16 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "esModuleInterop": true,
+    "strict": true,
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "sourceMap": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true
+  },
+  "include": ["src/**/*"]
+}