nitrosend-mcp 0.1.0

package/README.md

@@ -0,0 +1,42 @@
+# nitrosend-mcp
+
+MCP server for [Nitrosend](https://nitrosend.com) — connect Claude to your email marketing platform.
+
+Manage contacts, compose emails, build automated flows, and launch campaigns through natural language.
+
+## Install
+
+```bash
+claude mcp add nitro -e NITROSEND_API_KEY=nskey_live_... -- npx -y nitrosend-mcp
+```
+
+## Get your API key
+
+1. Log in at [nitrosend.com](https://nitrosend.com)
+2. Go to **Settings > API Keys**
+3. Copy your live key (starts with `nskey_live_`)
+
+## What you can do
+
+Once connected, Claude can:
+
+- **Read** — query contacts, segments, flows, campaigns, and account status
+- **Compose** — create emails with sections, build multi-step flows, set up campaigns
+- **Manage** — import contacts, create segments, manage lists and tags
+- **Deliver** — preview emails, run spam checks, send tests, approve and schedule campaigns
+- **Insights** — view open/click/unsubscribe metrics and trends
+
+## Environment variables
+
+| Variable | Required | Description |
+|---|---|---|
+| `NITROSEND_API_KEY` | Yes | Your API key (`nskey_live_...`) |
+| `NITROSEND_API_URL` | No | Override API endpoint (defaults to `https://api.nitrosend.com/mcp`) |
+
+## Requirements
+
+- Node.js 18+
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,2 @@
+export declare function getApiKey(): string;
+export declare function getApiUrl(): string;

package/dist/auth.js

@@ -0,0 +1,24 @@
+const DEFAULT_API_URL = "https://api.nitrosend.com/mcp";
+export function getApiKey() {
+    const key = process.env.NITROSEND_API_KEY;
+    if (!key) {
+        console.error("Error: NITROSEND_API_KEY is not set.\n\n" +
+            "Set your API key:\n" +
+            "  export NITROSEND_API_KEY=nskey_live_...\n\n" +
+            "Get your key at: https://nitrosend.com/settings/api-keys\n\n" +
+            "Or pass it when adding the server:\n" +
+            "  claude mcp add nitro -e NITROSEND_API_KEY=nskey_live_... -- npx -y nitrosend-mcp");
+        process.exit(1);
+    }
+    if (!key.startsWith("nskey_live_")) {
+        console.error("Error: Invalid API key format.\n\n" +
+            "API keys must start with nskey_live_.\n" +
+            "Get your key at: https://nitrosend.com/settings/api-keys");
+        process.exit(1);
+    }
+    return key;
+}
+export function getApiUrl() {
+    return process.env.NITROSEND_API_URL || DEFAULT_API_URL;
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA,MAAM,eAAe,GAAG,+BAA+B,CAAC;AAExD,MAAM,UAAU,SAAS;IACvB,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;IAE1C,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,OAAO,CAAC,KAAK,CACX,0CAA0C;YACxC,qBAAqB;YACrB,+CAA+C;YAC/C,8DAA8D;YAC9D,sCAAsC;YACtC,oFAAoF,CACvF,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,IAAI,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,EAAE,CAAC;QACnC,OAAO,CAAC,KAAK,CACX,oCAAoC;YAClC,yCAAyC;YACzC,0DAA0D,CAC7D,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,UAAU,SAAS;IACvB,OAAO,OAAO,CAAC,GAAG,CAAC,iBAAiB,IAAI,eAAe,CAAC;AAC1D,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/index.js

@@ -0,0 +1,75 @@
+#!/usr/bin/env node
+import { createInterface } from "node:readline";
+import { getApiKey, getApiUrl } from "./auth.js";
+const apiKey = getApiKey();
+const apiUrl = getApiUrl();
+const RETRY_DELAYS = [100, 300];
+async function forward(line) {
+    let lastError = null;
+    for (let attempt = 0; attempt <= RETRY_DELAYS.length; attempt++) {
+        try {
+            const res = await fetch(apiUrl, {
+                method: "POST",
+                headers: {
+                    "Content-Type": "application/json",
+                    Authorization: `Bearer ${apiKey}`,
+                },
+                body: line,
+            });
+            if (res.status === 202) {
+                // JSON-RPC notification — no response body
+                return "";
+            }
+            if (res.ok) {
+                return await res.text();
+            }
+            // 401/403 — don't retry auth errors
+            if (res.status === 401 || res.status === 403) {
+                console.error(`Auth error (${res.status}): Check your NITROSEND_API_KEY`);
+                return jsonRpcError(-32000, `Authentication failed (${res.status})`);
+            }
+            // 5xx — retry
+            if (res.status >= 500 && attempt < RETRY_DELAYS.length) {
+                await sleep(RETRY_DELAYS[attempt]);
+                continue;
+            }
+            return jsonRpcError(-32000, `API returned ${res.status}`);
+        }
+        catch (err) {
+            lastError = err;
+            // Network error — retry
+            if (attempt < RETRY_DELAYS.length) {
+                await sleep(RETRY_DELAYS[attempt]);
+                continue;
+            }
+        }
+    }
+    const msg = lastError?.message || "Unknown network error";
+    console.error(`Network error: ${msg}`);
+    return jsonRpcError(-32000, `Network error: ${msg}`);
+}
+function jsonRpcError(code, message) {
+    return JSON.stringify({
+        jsonrpc: "2.0",
+        error: { code, message },
+        id: null,
+    });
+}
+function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+const rl = createInterface({ input: process.stdin });
+rl.on("line", async (line) => {
+    const trimmed = line.trim();
+    if (!trimmed)
+        return;
+    const response = await forward(trimmed);
+    if (response) {
+        process.stdout.write(response + "\n");
+    }
+});
+rl.on("close", () => {
+    process.exit(0);
+});
+console.error(`Nitrosend MCP bridge started (${apiUrl})`);
+//# 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/package.json

@@ -0,0 +1,26 @@
+{
+  "name": "nitrosend-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Nitrosend — connect Claude to your email marketing platform",
+  "license": "MIT",
+  "type": "module",
+  "bin": {
+    "nitrosend-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsc && shx chmod +x dist/*.js",
+    "prepare": "npm run build",
+    "dev": "tsc --watch"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "devDependencies": {
+    "@types/node": "^22",
+    "shx": "^0.3.4",
+    "typescript": "^5.6.0"
+  }
+}