@jenny-ouyang/btl-license-mcp 1.0.0

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,92 @@
+#!/usr/bin/env node
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { z } from "zod";
+import { validateLicense, cacheLicense, getCachedLicense, clearCachedLicense, PLUGIN_IDS, } from "./license.js";
+const server = new McpServer({
+    name: "btl-license-mcp",
+    version: "1.0.0",
+});
+server.tool("validate_license", "Validate a Gumroad license key for a Build to Launch premium plugin. Call this at the start of any premium skill. Returns valid/invalid and caches the result so the user doesn't have to re-enter their key.", {
+    plugin_id: z
+        .enum(["newsletter-engine", "ai-builder-toolkit"])
+        .describe("The plugin ID to validate the license for"),
+    license_key: z
+        .string()
+        .optional()
+        .describe("The Gumroad license key. If omitted, checks the local cache first."),
+}, async ({ plugin_id, license_key }) => {
+    // Check cache first if no key provided
+    if (!license_key) {
+        const cached = getCachedLicense(plugin_id);
+        if (cached) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `✅ License active for ${plugin_id}\nAccount: ${cached.email}\n\nYou're good to go — proceed with the skill.`,
+                    },
+                ],
+            };
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `🔒 ${plugin_id} is a premium plugin.\n\nTo unlock it:\n1. Purchase at https://buildtolaunch.gumroad.com/l/${plugin_id}\n2. Copy your license key from the Gumroad receipt email\n3. Run this tool again with your license_key`,
+                },
+            ],
+        };
+    }
+    const result = await validateLicense(plugin_id, license_key);
+    if (!result.valid) {
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `❌ License invalid for ${plugin_id}\n\nReason: ${result.error}\n\nGet access at https://buildtolaunch.gumroad.com/l/${plugin_id}`,
+                },
+            ],
+        };
+    }
+    cacheLicense(plugin_id, license_key, result.email);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `✅ License validated and saved for ${plugin_id}\nAccount: ${result.email}\n\nYour key is cached — you won't need to enter it again on this machine.\n\nProceed with the skill.`,
+            },
+        ],
+    };
+});
+server.tool("check_license_status", "Check which Build to Launch premium plugins are currently unlocked on this machine.", {}, async () => {
+    const lines = ["Build to Launch Premium Plugin Status\n"];
+    for (const pluginId of PLUGIN_IDS) {
+        const cached = getCachedLicense(pluginId);
+        if (cached) {
+            lines.push(`✅ ${pluginId} — active (${cached.email})`);
+        }
+        else {
+            lines.push(`🔒 ${pluginId} — not activated`);
+        }
+    }
+    lines.push("\nTo activate a locked plugin, run validate_license with your license key.");
+    return { content: [{ type: "text", text: lines.join("\n") }] };
+});
+server.tool("revoke_license", "Remove a cached license from this machine. Use if you're moving to a new machine or troubleshooting.", {
+    plugin_id: z
+        .enum(["newsletter-engine", "ai-builder-toolkit"])
+        .describe("The plugin ID to revoke"),
+}, async ({ plugin_id }) => {
+    clearCachedLicense(plugin_id);
+    return {
+        content: [
+            {
+                type: "text",
+                text: `License for ${plugin_id} removed from this machine.`,
+            },
+        ],
+    };
+});
+const transport = new StdioServerTransport();
+await server.connect(transport);

package/dist/license.d.ts

@@ -0,0 +1,14 @@
+export declare const PLUGIN_IDS: readonly ["newsletter-engine", "ai-builder-toolkit"];
+export type PluginId = typeof PLUGIN_IDS[number];
+export declare function getCachedLicense(pluginId: string): {
+    key: string;
+    email: string;
+} | null;
+export declare function cacheLicense(pluginId: string, key: string, email: string): void;
+export declare function clearCachedLicense(pluginId: string): void;
+export interface ValidationResult {
+    valid: boolean;
+    email?: string;
+    error?: string;
+}
+export declare function validateLicense(pluginId: string, licenseKey: string): Promise<ValidationResult>;

package/dist/license.js

@@ -0,0 +1,57 @@
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "fs";
+import { homedir } from "os";
+import { join } from "path";
+const CACHE_DIR = join(homedir(), ".btl-license");
+const CACHE_FILE = join(CACHE_DIR, "licenses.json");
+const LICENSE_API = "https://resources.buildtolaunch.ai/api/licenses/verify";
+export const PLUGIN_IDS = ["newsletter-engine", "ai-builder-toolkit"];
+function readCache() {
+    if (!existsSync(CACHE_FILE))
+        return {};
+    try {
+        return JSON.parse(readFileSync(CACHE_FILE, "utf-8"));
+    }
+    catch {
+        return {};
+    }
+}
+function writeCache(cache) {
+    if (!existsSync(CACHE_DIR)) {
+        mkdirSync(CACHE_DIR, { recursive: true });
+    }
+    writeFileSync(CACHE_FILE, JSON.stringify(cache, null, 2));
+}
+export function getCachedLicense(pluginId) {
+    const cache = readCache();
+    const entry = cache[pluginId];
+    if (!entry)
+        return null;
+    return { key: entry.key, email: entry.email };
+}
+export function cacheLicense(pluginId, key, email) {
+    const cache = readCache();
+    cache[pluginId] = { key, email, validatedAt: new Date().toISOString() };
+    writeCache(cache);
+}
+export function clearCachedLicense(pluginId) {
+    const cache = readCache();
+    delete cache[pluginId];
+    writeCache(cache);
+}
+export async function validateLicense(pluginId, licenseKey) {
+    try {
+        const response = await fetch(LICENSE_API, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({ license_key: licenseKey, plugin_id: pluginId }),
+        });
+        const data = (await response.json());
+        if (!data.valid) {
+            return { valid: false, error: data.error ?? "Invalid license key." };
+        }
+        return { valid: true, email: data.email };
+    }
+    catch {
+        return { valid: false, error: "Could not reach license server. Check your internet connection." };
+    }
+}

package/package.json

@@ -0,0 +1,32 @@
+{
+  "name": "@jenny-ouyang/btl-license-mcp",
+  "version": "1.0.0",
+  "description": "License validation MCP for Build to Launch premium plugins — validates Gumroad license keys and unlocks premium plugin content.",
+  "keywords": ["mcp", "claude", "claude-code", "build-to-launch", "license"],
+  "author": "Build to Launch",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/Build-to-Launch/build-to-launch-plugins"
+  },
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "btl-license-mcp": "dist/index.js"
+  },
+  "files": ["dist"],
+  "scripts": {
+    "build": "tsc",
+    "dev": "node --loader ts-node/esm src/index.ts",
+    "start": "node dist/index.js"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.25.0"
+  },
+  "devDependencies": {
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "ts-node": "^10.9.0"
+  }
+}