substack-article-mcp 0.1.0

package/README.md

@@ -0,0 +1,124 @@
+# substack-article-mcp
+
+MCP server for Substack — access your articles, notes, and engagement data from Claude, Cursor, Claude Desktop, or any MCP client.
+
+**Authenticated access** means you get full content for premium/paywalled articles, not just the free preview.
+
+## Quick Start
+
+### 1. Authenticate
+
+```bash
+npx substack-article-mcp login
+```
+
+This opens Chrome, you log into Substack, and the session cookie is saved automatically. One-time setup that lasts ~2-4 weeks.
+
+**Alternative** (manual cookie paste):
+
+```bash
+npx substack-article-mcp login --manual "your-substack-sid-cookie-value"
+```
+
+### 2. Configure Your MCP Client
+
+Add to your MCP configuration:
+
+**Cursor** (`~/.cursor/mcp.json`):
+
+```json
+{
+  "mcpServers": {
+    "substack": {
+      "command": "npx",
+      "args": ["-y", "substack-article-mcp"],
+      "env": {
+        "SUBSTACK_SUBDOMAIN": "your-subdomain"
+      }
+    }
+  }
+}
+```
+
+**Claude Desktop** (`~/Library/Application Support/Claude/claude_desktop_config.json`):
+
+```json
+{
+  "mcpServers": {
+    "substack": {
+      "command": "npx",
+      "args": ["-y", "substack-article-mcp"],
+      "env": {
+        "SUBSTACK_SUBDOMAIN": "your-subdomain"
+      }
+    }
+  }
+}
+```
+
+**Claude Code**:
+
+```bash
+claude mcp add substack -- npx -y substack-article-mcp
+```
+
+Then set the environment variable `SUBSTACK_SUBDOMAIN` in your shell or MCP config.
+
+Your **subdomain** is the part before `.substack.com` in your newsletter URL. For example: `buildtolaunch.substack.com` → subdomain is `buildtolaunch`.
+
+### 3. Use It
+
+Just talk to your AI assistant:
+
+- "List my recent Substack articles"
+- "Get the full content of my article about Claude Code"
+- "Search my articles for posts about vibe coding"
+- "Check my Substack auth status"
+
+## Available Tools
+
+| Tool | Description |
+|------|-------------|
+| `substack_auth_status` | Check if authentication is valid, show cookie age |
+| `list_articles` | List published articles with metadata (title, date, slug, engagement, paid/free) |
+| `get_article` | Get full article content as markdown (includes premium content when authenticated) |
+| `search_articles` | Search published articles by keyword |
+
+## CLI Commands
+
+```bash
+substack-article-mcp                         # Start the MCP server
+substack-article-mcp login                   # Authenticate via Chrome (automated)
+substack-article-mcp login --manual <sid>    # Authenticate with a pasted cookie value
+substack-article-mcp login --check           # Check authentication status
+substack-article-mcp --help                  # Show help
+```
+
+## How Authentication Works
+
+Substack doesn't have a public API. This MCP uses the same internal API that the Substack website uses, authenticated with your browser session cookie.
+
+1. **`substack-article-mcp login`** launches Chrome with a dedicated profile
+2. You log into Substack in the browser window
+3. The `substack.sid` cookie is automatically extracted via Chrome DevTools Protocol
+4. The cookie is stored locally at `~/.substack-article-mcp/auth.json`
+5. The MCP server reads this cookie to make authenticated API requests
+
+**Security notes:**
+- Your cookie is stored locally on your machine only (`~/.substack-article-mcp/auth.json`)
+- The cookie is never sent anywhere except to `substack.com` API endpoints
+- Chrome profile data stays in `~/.substack-article-mcp/chrome-profile/`
+- Re-authenticate by running `substack-article-mcp login` again when the cookie expires (~2-4 weeks)
+
+## Requirements
+
+- **Node.js** 18 or later
+- **Google Chrome** (for the `login` command — the MCP server itself doesn't need Chrome)
+
+## Disclaimer
+
+This MCP uses Substack's internal APIs which are undocumented and may change without notice. Use for personal/experimental purposes. Not affiliated with Substack.
+
+## License
+
+MIT

package/dist/auth.d.ts

@@ -0,0 +1,19 @@
+interface StoredAuth {
+    substackSid: string;
+    extractedAt: string;
+    subdomain?: string;
+}
+export declare function getAuthDir(): string;
+export declare function loadAuth(): StoredAuth | null;
+export declare function saveAuth(sid: string, subdomain?: string): void;
+export declare function getCookieHeaders(): Record<string, string>;
+export declare function runLogin(): Promise<void>;
+export declare function runManualLogin(sid: string): Promise<void>;
+export declare function validateStoredAuth(): Promise<boolean>;
+export declare function checkAuthStatus(): Promise<{
+    authenticated: boolean;
+    cookieAge?: string;
+    subdomain?: string;
+}>;
+export {};
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAQA,UAAU,UAAU;IAClB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,UAAU,IAAI,MAAM,CAKnC;AAED,wBAAgB,QAAQ,IAAI,UAAU,GAAG,IAAI,CAU5C;AAED,wBAAgB,QAAQ,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,CAQ9D;AAED,wBAAgB,gBAAgB,IAAI,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAYzD;AAyCD,wBAAsB,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC,CAqE9C;AA+BD,wBAAsB,cAAc,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAY/D;AAED,wBAAsB,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC,CAiB3D;AAED,wBAAsB,eAAe,IAAI,OAAO,CAAC;IAC/C,aAAa,EAAE,OAAO,CAAC;IACvB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,CAAC,CAmBD"}

package/dist/auth.js

@@ -0,0 +1,179 @@
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
+import { join } from "node:path";
+const AUTH_DIR = join(homedir(), ".substack-article-mcp");
+const AUTH_FILE = join(AUTH_DIR, "auth.json");
+const CHROME_PROFILE_DIR = join(AUTH_DIR, "chrome-profile");
+export function getAuthDir() {
+    if (!existsSync(AUTH_DIR)) {
+        mkdirSync(AUTH_DIR, { recursive: true });
+    }
+    return AUTH_DIR;
+}
+export function loadAuth() {
+    try {
+        if (!existsSync(AUTH_FILE))
+            return null;
+        const raw = readFileSync(AUTH_FILE, "utf-8");
+        const data = JSON.parse(raw);
+        if (!data.substackSid)
+            return null;
+        return data;
+    }
+    catch {
+        return null;
+    }
+}
+export function saveAuth(sid, subdomain) {
+    getAuthDir();
+    const data = {
+        substackSid: sid,
+        extractedAt: new Date().toISOString(),
+        subdomain,
+    };
+    writeFileSync(AUTH_FILE, JSON.stringify(data, null, 2), "utf-8");
+}
+export function getCookieHeaders() {
+    const auth = loadAuth();
+    if (!auth) {
+        throw new Error("Not authenticated. Run `substack-article-mcp login` first to connect your Substack account.");
+    }
+    return {
+        Cookie: `substack.sid=${auth.substackSid}; substack.lli=1`,
+        "User-Agent": "Mozilla/5.0 (Macintosh; Intel Mac OS X 10_15_7) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/131.0.0.0 Safari/537.36",
+    };
+}
+function findChrome() {
+    const { platform } = process;
+    const candidates = [];
+    if (platform === "darwin") {
+        candidates.push("/Applications/Google Chrome.app/Contents/MacOS/Google Chrome", "/Applications/Google Chrome Canary.app/Contents/MacOS/Google Chrome Canary", "/Applications/Chromium.app/Contents/MacOS/Chromium");
+    }
+    else if (platform === "linux") {
+        candidates.push("/usr/bin/google-chrome", "/usr/bin/google-chrome-stable", "/usr/bin/chromium-browser", "/usr/bin/chromium", "/snap/bin/chromium");
+    }
+    else if (platform === "win32") {
+        const programFiles = process.env["PROGRAMFILES"] || "C:\\Program Files";
+        const programFilesX86 = process.env["PROGRAMFILES(X86)"] || "C:\\Program Files (x86)";
+        const localAppData = process.env["LOCALAPPDATA"] || join(homedir(), "AppData", "Local");
+        candidates.push(join(programFiles, "Google", "Chrome", "Application", "chrome.exe"), join(programFilesX86, "Google", "Chrome", "Application", "chrome.exe"), join(localAppData, "Google", "Chrome", "Application", "chrome.exe"));
+    }
+    for (const path of candidates) {
+        if (existsSync(path))
+            return path;
+    }
+    return null;
+}
+export async function runLogin() {
+    const chromePath = findChrome();
+    if (!chromePath) {
+        console.error("Could not find Chrome/Chromium on your system.");
+        console.error("Install Google Chrome and try again.");
+        console.error("\nAlternative: run `substack-article-mcp login --manual` to paste your cookie directly.");
+        process.exit(1);
+    }
+    console.log("Launching Chrome for Substack login...");
+    console.log(`Chrome: ${chromePath}`);
+    // Dynamic import to avoid loading puppeteer when running the MCP server
+    const puppeteer = await import("puppeteer-core");
+    getAuthDir();
+    const browser = await puppeteer.launch({
+        executablePath: chromePath,
+        headless: false,
+        userDataDir: CHROME_PROFILE_DIR,
+        args: [
+            "--no-first-run",
+            "--no-default-browser-check",
+            "--window-size=1200,800",
+        ],
+        defaultViewport: null,
+    });
+    const pages = await browser.pages();
+    const page = pages[0] || (await browser.newPage());
+    await page.goto("https://substack.com/sign-in", {
+        waitUntil: "networkidle2",
+    });
+    console.log("\n┌─────────────────────────────────────────────┐");
+    console.log("│  Log in to Substack in the browser window.  │");
+    console.log("│  The window will close automatically once    │");
+    console.log("│  your session cookie is detected.            │");
+    console.log("└─────────────────────────────────────────────┘\n");
+    const sid = await waitForCookie(page, "substack.sid", 300_000);
+    if (!sid) {
+        console.error("Timed out waiting for login. Please try again.");
+        await browser.close();
+        process.exit(1);
+    }
+    saveAuth(sid);
+    console.log("Cookies saved. Validating...");
+    const valid = await validateStoredAuth();
+    await browser.close();
+    if (valid) {
+        console.log("\n✅ Authenticated successfully!");
+        console.log(`   Cookies stored in ${AUTH_FILE}`);
+        console.log("   You can now use the Substack Article MCP server in Cursor, Claude Code, etc.");
+    }
+    else {
+        console.error("\n⚠️  Cookie was saved but validation failed. You may need to try again.");
+    }
+}
+async function waitForCookie(page, cookieName, timeoutMs) {
+    const start = Date.now();
+    while (Date.now() - start < timeoutMs) {
+        try {
+            const client = await page.createCDPSession();
+            const result = (await client.send("Network.getAllCookies"));
+            await client.detach();
+            const match = result.cookies.find((c) => c.name === cookieName);
+            if (match && match.value) {
+                return match.value;
+            }
+        }
+        catch {
+            // Page may have navigated or CDP session failed — retry
+        }
+        await new Promise((r) => setTimeout(r, 2000));
+    }
+    return null;
+}
+export async function runManualLogin(sid) {
+    saveAuth(sid);
+    console.log("Cookie saved. Validating...");
+    const valid = await validateStoredAuth();
+    if (valid) {
+        console.log("\n✅ Authenticated successfully!");
+    }
+    else {
+        console.error("\n⚠️  Cookie saved but validation failed. The cookie may be expired or invalid.");
+    }
+}
+export async function validateStoredAuth() {
+    try {
+        const headers = getCookieHeaders();
+        const subdomain = process.env["SUBSTACK_SUBDOMAIN"] ||
+            loadAuth()?.subdomain ||
+            "substack";
+        const res = await fetch(`https://${subdomain}.substack.com/api/v1/archive?limit=1`, { headers });
+        return res.ok;
+    }
+    catch {
+        return false;
+    }
+}
+export async function checkAuthStatus() {
+    const auth = loadAuth();
+    if (!auth) {
+        return { authenticated: false };
+    }
+    const valid = await validateStoredAuth();
+    const extractedDate = new Date(auth.extractedAt);
+    const ageMs = Date.now() - extractedDate.getTime();
+    const ageDays = Math.floor(ageMs / (1000 * 60 * 60 * 24));
+    const ageHours = Math.floor((ageMs % (1000 * 60 * 60 * 24)) / (1000 * 60 * 60));
+    return {
+        authenticated: valid,
+        cookieAge: `${ageDays}d ${ageHours}h (extracted ${auth.extractedAt})`,
+        subdomain: auth.subdomain,
+    };
+}
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

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

package/dist/client.d.ts

@@ -0,0 +1,31 @@
+export interface SubstackArticle {
+    id: number;
+    title: string;
+    slug: string;
+    subtitle: string;
+    description: string;
+    publishedAt: string;
+    canonicalUrl: string;
+    audience: string;
+    section?: {
+        name: string;
+    };
+    wordCount?: number;
+    postDate: string;
+    likes: number;
+    comments: number;
+    restacks: number;
+}
+export interface SubstackArticleFull extends SubstackArticle {
+    bodyHtml: string;
+    truncatedBodyText?: string;
+}
+export declare function listArticles(options: {
+    limit?: number;
+    offset?: number;
+    sort?: "new" | "top";
+    search?: string;
+}): Promise<SubstackArticle[]>;
+export declare function getArticle(slugOrId: string): Promise<SubstackArticleFull>;
+export declare function searchArticles(query: string, limit?: number): Promise<SubstackArticle[]>;
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,MAAM,CAAC;IACjB,QAAQ,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,CAAC,EAAE,MAAM,CAAC;CAC5B;AA2DD,wBAAsB,YAAY,CAAC,OAAO,EAAE;IAC1C,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC,eAAe,EAAE,CAAC,CAgB7B;AAED,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,mBAAmB,CAAC,CAW9B;AAED,wBAAsB,cAAc,CAClC,KAAK,EAAE,MAAM,EACb,KAAK,GAAE,MAAW,GACjB,OAAO,CAAC,eAAe,EAAE,CAAC,CAE5B"}

package/dist/client.js

@@ -0,0 +1,69 @@
+import { getCookieHeaders, loadAuth } from "./auth.js";
+function getBaseUrl() {
+    const subdomain = process.env["SUBSTACK_SUBDOMAIN"] || loadAuth()?.subdomain;
+    if (!subdomain) {
+        throw new Error("SUBSTACK_SUBDOMAIN environment variable is required. Set it in your MCP config.");
+    }
+    return `https://${subdomain}.substack.com`;
+}
+async function apiGet(endpoint) {
+    const url = `${getBaseUrl()}${endpoint}`;
+    const headers = getCookieHeaders();
+    const res = await fetch(url, {
+        headers: {
+            ...headers,
+            Accept: "application/json",
+        },
+    });
+    if (res.status === 401 || res.status === 403) {
+        throw new Error("Authentication failed. Your cookie may have expired. Run `substack-article-mcp login` to re-authenticate.");
+    }
+    if (!res.ok) {
+        const text = await res.text();
+        throw new Error(`Substack API error ${res.status}: ${text}`);
+    }
+    return res.json();
+}
+function normalizePost(raw) {
+    return {
+        id: raw["id"],
+        title: raw["title"] || "",
+        slug: raw["slug"] || "",
+        subtitle: raw["subtitle"] || "",
+        description: raw["description"] || "",
+        publishedAt: raw["post_date"] || "",
+        canonicalUrl: raw["canonical_url"] || "",
+        audience: raw["audience"] || "everyone",
+        section: raw["publishedBylines"]
+            ? undefined
+            : (raw["section"] || undefined),
+        wordCount: raw["wordcount"],
+        postDate: raw["post_date"] || "",
+        likes: raw["reaction_count"] || 0,
+        comments: raw["comment_count"] || 0,
+        restacks: raw["restacks"] || 0,
+    };
+}
+export async function listArticles(options) {
+    const { limit = 12, offset = 0, sort = "new", search = "" } = options;
+    const params = new URLSearchParams({
+        sort,
+        search,
+        offset: String(offset),
+        limit: String(limit),
+    });
+    const data = (await apiGet(`/api/v1/archive?${params}`));
+    return data.map(normalizePost);
+}
+export async function getArticle(slugOrId) {
+    const raw = (await apiGet(`/api/v1/posts/${slugOrId}`));
+    return {
+        ...normalizePost(raw),
+        bodyHtml: raw["body_html"] || "",
+        truncatedBodyText: raw["truncated_body_text"],
+    };
+}
+export async function searchArticles(query, limit = 12) {
+    return listArticles({ search: query, limit, sort: "new" });
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

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

package/dist/html-to-md.d.ts

@@ -0,0 +1,2 @@
+export declare function htmlToMarkdown(html: string): string;
+//# sourceMappingURL=html-to-md.d.ts.map

package/dist/html-to-md.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"html-to-md.d.ts","sourceRoot":"","sources":["../src/html-to-md.ts"],"names":[],"mappings":"AAGA,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAoHnD"}

package/dist/html-to-md.js

@@ -0,0 +1,111 @@
+import { load } from "cheerio";
+export function htmlToMarkdown(html) {
+    const $ = load(html);
+    $("script, style, .subscription-widget, .subscribe-widget, .paywall, .paywall-jump, .post-footer, .share-dialog, .button-wrapper, .captioned-button-wrap, .footer-wrap, .like-button-container").remove();
+    function processNode(el) {
+        if (el.type === "text") {
+            return el.data || "";
+        }
+        if (el.type !== "tag")
+            return "";
+        const $el = $(el);
+        const tag = el.tagName.toLowerCase();
+        const children = $el.contents().toArray();
+        const innerText = children.map(processNode).join("");
+        switch (tag) {
+            case "h1":
+                return `\n# ${innerText.trim()}\n\n`;
+            case "h2":
+                return `\n## ${innerText.trim()}\n\n`;
+            case "h3":
+                return `\n### ${innerText.trim()}\n\n`;
+            case "h4":
+                return `\n#### ${innerText.trim()}\n\n`;
+            case "h5":
+            case "h6":
+                return `\n##### ${innerText.trim()}\n\n`;
+            case "p":
+                return `\n${innerText.trim()}\n\n`;
+            case "br":
+                return "\n";
+            case "hr":
+                return "\n---\n\n";
+            case "strong":
+            case "b":
+                return `**${innerText}**`;
+            case "em":
+            case "i":
+                return `*${innerText}*`;
+            case "code": {
+                const parent = $el.parent();
+                if (parent.length && parent[0] && parent[0].tagName === "pre") {
+                    return innerText;
+                }
+                return `\`${innerText}\``;
+            }
+            case "pre": {
+                const codeEl = $el.find("code");
+                const content = codeEl.length ? codeEl.text() : innerText;
+                return `\n\`\`\`\n${content.trim()}\n\`\`\`\n\n`;
+            }
+            case "blockquote": {
+                const lines = innerText.trim().split("\n");
+                return "\n" + lines.map((l) => `> ${l}`).join("\n") + "\n\n";
+            }
+            case "a": {
+                const href = $el.attr("href") || "";
+                if (href && !href.startsWith("javascript:")) {
+                    return `[${innerText}](${href})`;
+                }
+                return innerText;
+            }
+            case "img": {
+                const src = $el.attr("src") || $el.data("src") || "";
+                const alt = $el.attr("alt") || "";
+                if (src)
+                    return `\n![${alt}](${src})\n\n`;
+                return "";
+            }
+            case "figure": {
+                const img = $el.find("img");
+                const caption = $el.find("figcaption");
+                if (img.length) {
+                    const src = img.attr("src") || img.data("src") || "";
+                    const alt = img.attr("alt") || "";
+                    let result = `\n![${alt}](${src})\n`;
+                    if (caption.length) {
+                        result += `*${caption.text().trim()}*\n`;
+                    }
+                    return result + "\n";
+                }
+                return innerText;
+            }
+            case "ul":
+            case "ol":
+                return "\n" + innerText + "\n";
+            case "li": {
+                const parent = $el.parent();
+                if (parent.length &&
+                    parent[0] &&
+                    parent[0].tagName === "ol") {
+                    const idx = $el.index() + 1;
+                    return `${idx}. ${innerText.trim()}\n`;
+                }
+                return `- ${innerText.trim()}\n`;
+            }
+            case "div":
+            case "span":
+            case "section":
+            case "article":
+            case "main":
+                return innerText;
+            default:
+                return innerText;
+        }
+    }
+    const body = $("body").contents().toArray();
+    let md = body.map(processNode).join("");
+    md = md.replace(/\n{3,}/g, "\n\n").trim();
+    return md;
+}
+//# sourceMappingURL=html-to-md.js.map

package/dist/html-to-md.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,91 @@
+#!/usr/bin/env node
+const args = process.argv.slice(2);
+const command = args[0];
+async function main() {
+    if (command === "login") {
+        const flag = args[1];
+        if (flag === "--check" || flag === "--status") {
+            const { checkAuthStatus } = await import("./auth.js");
+            const status = await checkAuthStatus();
+            if (status.authenticated) {
+                console.log("✅ Authenticated");
+                console.log(`   Cookie age: ${status.cookieAge}`);
+                console.log(`   Subdomain: ${status.subdomain || process.env["SUBSTACK_SUBDOMAIN"] || "(not set)"}`);
+            }
+            else {
+                console.log("❌ Not authenticated");
+                console.log('   Run "substack-article-mcp login" to connect your account.');
+            }
+            return;
+        }
+        if (flag === "--manual") {
+            const sid = args[2];
+            if (!sid) {
+                console.error("Usage: substack-article-mcp login --manual <substack.sid value>");
+                console.error("\nTo get your cookie value:\n1. Open substack.com in Chrome\n2. Open DevTools (F12) → Application → Cookies\n3. Copy the value of 'substack.sid'");
+                process.exit(1);
+            }
+            const { runManualLogin } = await import("./auth.js");
+            await runManualLogin(sid);
+            return;
+        }
+        const { runLogin } = await import("./auth.js");
+        await runLogin();
+        return;
+    }
+    if (command === "--help" || command === "-h") {
+        printHelp();
+        return;
+    }
+    if (command === "--version" || command === "-v") {
+        console.log("substack-article-mcp v0.1.0");
+        return;
+    }
+    // Default: start MCP server
+    const { startServer } = await import("./server.js");
+    await startServer();
+}
+function printHelp() {
+    console.log(`
+substack-article-mcp — Substack MCP Server
+
+USAGE
+  substack-article-mcp                    Start the MCP server (stdio transport)
+  substack-article-mcp login              Launch Chrome to authenticate with Substack
+  substack-article-mcp login --manual <sid>  Manually provide your substack.sid cookie
+  substack-article-mcp login --check      Check current authentication status
+
+MCP CLIENT CONFIGURATION
+
+  Cursor / Claude Desktop / Claude Code:
+  {
+    "mcpServers": {
+      "substack": {
+        "command": "npx",
+        "args": ["-y", "substack-article-mcp"],
+        "env": {
+          "SUBSTACK_SUBDOMAIN": "your-subdomain"
+        }
+      }
+    }
+  }
+
+  Your subdomain is the part before .substack.com in your newsletter URL.
+  For example: buildtolaunch.substack.com → subdomain is "buildtolaunch"
+
+ENVIRONMENT VARIABLES
+  SUBSTACK_SUBDOMAIN    Your Substack subdomain (required)
+
+MCP TOOLS
+  substack_auth_status  Check authentication status
+  list_articles         List published articles with metadata
+  get_article           Get full article content as markdown
+  search_articles       Search articles by keyword
+`);
+}
+main().catch((error) => {
+    console.error("Fatal error:", error);
+    process.exit(1);
+});
+export {};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AACnC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;AAExB,KAAK,UAAU,IAAI;IACjB,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,MAAM,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QAErB,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YAC9C,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACtD,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;YAEvC,IAAI,MAAM,CAAC,aAAa,EAAE,CAAC;gBACzB,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC,CAAC;gBAC/B,OAAO,CAAC,GAAG,CAAC,kBAAkB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;gBAClD,OAAO,CAAC,GAAG,CACT,iBAAiB,MAAM,CAAC,SAAS,IAAI,OAAO,CAAC,GAAG,CAAC,oBAAoB,CAAC,IAAI,WAAW,EAAE,CACxF,CAAC;YACJ,CAAC;iBAAM,CAAC;gBACN,OAAO,CAAC,GAAG,CAAC,qBAAqB,CAAC,CAAC;gBACnC,OAAO,CAAC,GAAG,CAAC,8DAA8D,CAAC,CAAC;YAC9E,CAAC;YACD,OAAO;QACT,CAAC;QAED,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;YACxB,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;YACpB,IAAI,CAAC,GAAG,EAAE,CAAC;gBACT,OAAO,CAAC,KAAK,CAAC,iEAAiE,CAAC,CAAC;gBACjF,OAAO,CAAC,KAAK,CACX,kJAAkJ,CACnJ,CAAC;gBACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;YAClB,CAAC;YACD,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;YACrD,MAAM,cAAc,CAAC,GAAG,CAAC,CAAC;YAC1B,OAAO;QACT,CAAC;QAED,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,MAAM,CAAC,WAAW,CAAC,CAAC;QAC/C,MAAM,QAAQ,EAAE,CAAC;QACjB,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,QAAQ,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAC7C,SAAS,EAAE,CAAC;QACZ,OAAO;IACT,CAAC;IAED,IAAI,OAAO,KAAK,WAAW,IAAI,OAAO,KAAK,IAAI,EAAE,CAAC;QAChD,OAAO,CAAC,GAAG,CAAC,6BAA6B,CAAC,CAAC;QAC3C,OAAO;IACT,CAAC;IAED,4BAA4B;IAC5B,MAAM,EAAE,WAAW,EAAE,GAAG,MAAM,MAAM,CAAC,aAAa,CAAC,CAAC;IACpD,MAAM,WAAW,EAAE,CAAC;AACtB,CAAC;AAED,SAAS,SAAS;IAChB,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAmCb,CAAC,CAAC;AACH,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,cAAc,EAAE,KAAK,CAAC,CAAC;IACrC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,2 @@
+export declare function startServer(): Promise<void>;
+//# sourceMappingURL=server.d.ts.map

package/dist/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../src/server.ts"],"names":[],"mappings":"AAgOA,wBAAsB,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAIjD"}

package/dist/server.js

@@ -0,0 +1,188 @@
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { checkAuthStatus } from "./auth.js";
+import { listArticles, getArticle, searchArticles, } from "./client.js";
+import { htmlToMarkdown } from "./html-to-md.js";
+function formatArticleList(articles) {
+    if (articles.length === 0)
+        return "No articles found.";
+    return articles
+        .map((a, i) => {
+        const paid = a.audience === "only_paid" ? " [PAID]" : "";
+        const section = a.section?.name ? ` (${a.section.name})` : "";
+        const date = a.postDate
+            ? new Date(a.postDate).toLocaleDateString("en-US", {
+                year: "numeric",
+                month: "short",
+                day: "numeric",
+            })
+            : "";
+        const stats = `${a.likes} likes, ${a.comments} comments`;
+        return `${i + 1}. **${a.title}**${paid}${section}\n   ${date} | ${stats}\n   Slug: ${a.slug}\n   URL: ${a.canonicalUrl}`;
+    })
+        .join("\n\n");
+}
+const server = new McpServer({
+    name: "substack-article-mcp",
+    version: "0.1.0",
+});
+// ─── Tool: substack_auth_status ──────────────────────────────────
+server.tool("substack_auth_status", "Check if the Substack authentication is valid and show cookie age", {}, async () => {
+    const status = await checkAuthStatus();
+    if (!status.authenticated) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Not authenticated. Run `substack-article-mcp login` in your terminal to connect your Substack account.",
+                },
+            ],
+        };
+    }
+    return {
+        content: [
+            {
+                type: "text",
+                text: `Authenticated ✓\nCookie age: ${status.cookieAge}\nSubdomain: ${status.subdomain || process.env["SUBSTACK_SUBDOMAIN"] || "(not set)"}`,
+            },
+        ],
+    };
+});
+// ─── Tool: list_articles ────────────────────────────────────────
+server.tool("list_articles", "List published Substack articles with metadata (title, date, slug, engagement stats, paid/free status). Returns newest first by default.", {
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Number of articles to return (default 12, max 50)"),
+    offset: z
+        .number()
+        .int()
+        .min(0)
+        .optional()
+        .describe("Pagination offset (default 0)"),
+    sort: z
+        .enum(["new", "top"])
+        .optional()
+        .describe("Sort order: 'new' (default) or 'top' by engagement"),
+}, async ({ limit, offset, sort }) => {
+    try {
+        const articles = await listArticles({
+            limit: limit ?? 12,
+            offset: offset ?? 0,
+            sort: sort ?? "new",
+        });
+        const total = articles.length;
+        const text = `Found ${total} article${total === 1 ? "" : "s"}:\n\n${formatArticleList(articles)}`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+});
+// ─── Tool: get_article ──────────────────────────────────────────
+server.tool("get_article", "Get full content of a Substack article as markdown. Requires the article slug (the URL path segment after /p/). Authenticated access includes premium/paywalled content.", {
+    slug: z
+        .string()
+        .describe("Article slug from the URL (the part after /p/ in the article URL, e.g. 'my-article-title')"),
+}, async ({ slug }) => {
+    try {
+        const article = await getArticle(slug);
+        const paid = article.audience === "only_paid" ? " [PAID]" : "";
+        const date = article.postDate
+            ? new Date(article.postDate).toLocaleDateString("en-US", {
+                year: "numeric",
+                month: "long",
+                day: "numeric",
+            })
+            : "";
+        let markdown = "";
+        markdown += `# ${article.title}${paid}\n\n`;
+        if (article.subtitle)
+            markdown += `*${article.subtitle}*\n\n`;
+        if (date)
+            markdown += `Published: ${date}\n`;
+        markdown += `URL: ${article.canonicalUrl}\n`;
+        markdown += `Engagement: ${article.likes} likes, ${article.comments} comments, ${article.restacks} restacks\n`;
+        if (article.wordCount)
+            markdown += `Word count: ${article.wordCount}\n`;
+        markdown += "\n---\n\n";
+        if (article.bodyHtml) {
+            markdown += htmlToMarkdown(article.bodyHtml);
+        }
+        else if (article.truncatedBodyText) {
+            markdown +=
+                article.truncatedBodyText +
+                    "\n\n[Content truncated — authentication may have failed for this premium article]";
+        }
+        else {
+            markdown += "(No article content available)";
+        }
+        return { content: [{ type: "text", text: markdown }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+});
+// ─── Tool: search_articles ──────────────────────────────────────
+server.tool("search_articles", "Search your published Substack articles by keyword. Returns matching articles with metadata.", {
+    query: z.string().describe("Search query to find articles"),
+    limit: z
+        .number()
+        .int()
+        .min(1)
+        .max(50)
+        .optional()
+        .describe("Max results to return (default 12)"),
+}, async ({ query, limit }) => {
+    try {
+        const articles = await searchArticles(query, limit ?? 12);
+        const total = articles.length;
+        if (total === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `No articles found matching "${query}".`,
+                    },
+                ],
+            };
+        }
+        const text = `Found ${total} article${total === 1 ? "" : "s"} matching "${query}":\n\n${formatArticleList(articles)}`;
+        return { content: [{ type: "text", text }] };
+    }
+    catch (error) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Error: ${error instanceof Error ? error.message : String(error)}`,
+                },
+            ],
+        };
+    }
+});
+// ─── Start Server ────────────────────────────────────────────────
+export async function startServer() {
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+    console.error("Substack MCP server running on stdio");
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,54 @@
+{
+  "name": "substack-article-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Substack — access your articles, notes, and engagement data from Claude, Cursor, or any MCP client. Authenticated access to premium/paywalled content.",
+  "type": "module",
+  "bin": {
+    "substack-article-mcp": "dist/index.js"
+  },
+  "main": "./dist/index.js",
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "prepublishOnly": "npm run build"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "substack",
+    "newsletter",
+    "articles",
+    "notes",
+    "claude",
+    "cursor",
+    "claude-desktop",
+    "claude-code",
+    "content",
+    "authenticated",
+    "premium"
+  ],
+  "author": "Jenny Ouyang",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/jenny-ouyang/substack-article-mcp.git"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.26.0",
+    "cheerio": "^1.0.0",
+    "puppeteer-core": "^24.0.0",
+    "zod": "^3.23.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "tsx": "^4.0.0",
+    "typescript": "^5.5.0"
+  },
+  "engines": {
+    "node": ">=18"
+  }
+}