solostack-mcp 0.1.0

package/llms.txt

@@ -0,0 +1,80 @@
+# SoloStack — MCP Email Marketing Server
+
+> Email marketing that your AI agent deploys and runs. MCP server on Cloudflare Workers.
+
+## Endpoints
+
+### Provisioner (local, stdio transport)
+Connect via MCP stdio for provisioning and gateway proxy to deployed worker.
+
+### Worker (remote, HTTP transport)
+POST /mcp — Streamable HTTP MCP transport
+Authorization: Bearer <SOLOSTACK_API_KEY>
+Accept: application/json, text/event-stream
+
+## Provisioning Tools
+
+### provision_solostack
+Create a complete email marketing stack on Cloudflare (Worker + D1 + secrets).
+- cloudflare_api_token (string, required): CF API token with Workers + D1 permissions
+- cloudflare_account_id (string, required): CF account ID
+- resend_api_key (string, required): Resend API key
+- worker_name (string, optional): Worker name (default: solostack-<random>)
+- sending_domain (string, required): Domain to send from
+- from_email (string, optional): From address (default: hello@<domain>)
+
+### check_status
+Check health and deployment info of the provisioned worker.
+
+### setup_email_domain
+Add a sending domain to Resend. Returns DNS records to add.
+- sending_domain (string, required): Domain to send from
+- resend_api_key (string, optional): Reads from config if omitted
+
+### verify_email_domain
+Poll Resend until domain is verified. Auto-registers webhook on success.
+- domain_id (string, optional): Reads from config if omitted
+- max_attempts (number, optional): Polling attempts at 30s intervals (default: 10)
+
+### migrate_subscribers
+Import subscribers from CSV data.
+- csv_data (string, required): CSV with email column + optional name, tags columns
+
+### upgrade_solostack
+Upload new worker bundle. Rolls back on health failure.
+
+## Email Tools (proxied to deployed worker)
+
+### subscribe
+Add or re-activate a subscriber. Idempotent.
+- email (string, required): Subscriber email
+- source (string, optional): Signup source
+- tags (string[], optional): Tags to apply
+
+### unsubscribe
+Mark a subscriber as unsubscribed.
+- email (string, required): Email to unsubscribe
+
+### list_subscribers
+List subscribers with filtering.
+- status (enum, optional): active | unsubscribed | bounced (default: active)
+- tag (string, optional): Filter by tag
+- limit (number, optional): Max results 1-500 (default: 50)
+- offset (number, optional): Pagination offset (default: 0)
+
+### get_subscriber_count
+Count subscribers.
+- status (enum, optional): active | unsubscribed | bounced (default: active)
+- tag (string, optional): Filter by tag
+
+### send_email
+Send a single email via Resend.
+- to (string, required): Recipient email
+- subject (string, required): Subject line
+- html (string, required): HTML body
+
+### send_broadcast
+Send to all active subscribers (max 100).
+- subject (string, required): Subject line
+- html (string, required): HTML body
+- tag (string, optional): Filter recipients by tag

package/package.json

@@ -0,0 +1,57 @@
+{
+  "name": "solostack-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for solo founder email marketing — subscriber management, email sending, broadcasts, analytics. Zero dashboards.",
+  "type": "module",
+  "bin": {
+    "solostack": "dist/provisioner.mjs"
+  },
+  "files": [
+    "dist/provisioner.mjs",
+    "dist/worker.mjs",
+    "src/db/schema.sql",
+    "llms.txt",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "dev": "wrangler dev",
+    "deploy": "wrangler deploy",
+    "build": "tsx scripts/build-provisioner.ts && tsx scripts/build-bundle.ts",
+    "build:provisioner": "tsx scripts/build-provisioner.ts",
+    "build:bundle": "tsx scripts/build-bundle.ts",
+    "test:bundle": "tsx scripts/test-bundle.ts",
+    "test:e2e": "tsx scripts/e2e-test.ts",
+    "prepublishOnly": "npm run build",
+    "db:local": "wrangler d1 execute solostack --local --file=src/db/schema.sql",
+    "db:remote": "wrangler d1 execute solostack --remote --file=src/db/schema.sql"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.27.1",
+    "agents": "^0.7.5",
+    "zod": "^3.24.2"
+  },
+  "devDependencies": {
+    "@cloudflare/workers-types": "^4.20260310.1",
+    "esbuild": "^0.27.4",
+    "tsx": "^4.19.0",
+    "typescript": "^5.7.3",
+    "wrangler": "^4.71.0"
+  },
+  "keywords": [
+    "mcp",
+    "email-marketing",
+    "cloudflare-workers",
+    "solo-founder",
+    "ai-agent",
+    "model-context-protocol"
+  ],
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/stue/solostack.git"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}

package/src/db/schema.sql

@@ -0,0 +1,31 @@
+-- SoloStack D1 Schema — Tier 1 MVP
+
+CREATE TABLE IF NOT EXISTS subscribers (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  email TEXT UNIQUE NOT NULL COLLATE NOCASE,
+  source TEXT,
+  tags TEXT DEFAULT '[]',
+  status TEXT DEFAULT 'active' CHECK (status IN ('active', 'unsubscribed', 'bounced')),
+  subscribed_at TEXT DEFAULT (datetime('now')),
+  unsubscribed_at TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_subscribers_status ON subscribers(status);
+CREATE INDEX IF NOT EXISTS idx_subscribers_email ON subscribers(email);
+
+CREATE TABLE IF NOT EXISTS email_log (
+  id INTEGER PRIMARY KEY AUTOINCREMENT,
+  subscriber_id INTEGER,
+  resend_id TEXT,
+  subject TEXT,
+  type TEXT DEFAULT 'transactional' CHECK (type IN ('broadcast', 'drip', 'transactional')),
+  status TEXT DEFAULT 'sent' CHECK (status IN ('sent', 'delivered', 'opened', 'clicked', 'bounced', 'complained')),
+  sent_at TEXT DEFAULT (datetime('now')),
+  delivered_at TEXT,
+  opened_at TEXT,
+  clicked_at TEXT,
+  FOREIGN KEY (subscriber_id) REFERENCES subscribers(id)
+);
+
+CREATE INDEX IF NOT EXISTS idx_email_log_resend_id ON email_log(resend_id);
+CREATE INDEX IF NOT EXISTS idx_email_log_subscriber ON email_log(subscriber_id);