@magnetlab/mcp 0.1.0

package/README.md

@@ -0,0 +1,119 @@
+# @magnetlab/mcp
+
+MCP server for [MagnetLab](https://magnetlab.ai) -- control your lead magnets, funnels, content pipeline, and analytics from Claude Code or Claude Desktop.
+
+## Quick Setup
+
+### Claude Code
+
+Add to your project's `.mcp.json`:
+
+```json
+{
+  "mcpServers": {
+    "magnetlab": {
+      "command": "npx",
+      "args": ["-y", "@magnetlab/mcp", "serve"],
+      "env": {
+        "MAGNETLAB_API_KEY": "ml_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+### Claude Desktop
+
+Add to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "magnetlab": {
+      "command": "npx",
+      "args": ["-y", "@magnetlab/mcp", "serve"],
+      "env": {
+        "MAGNETLAB_API_KEY": "ml_live_your_key_here"
+      }
+    }
+  }
+}
+```
+
+## Getting Your API Key
+
+1. Log in to [MagnetLab](https://magnetlab.ai)
+2. Go to **Settings > API Keys**
+3. Click **Create API Key**
+4. Copy the key (starts with `ml_live_`)
+
+## Available Tools
+
+| Category | Tools | What You Can Do |
+|----------|------:|-----------------|
+| Lead Magnets | 7 | List, create, delete, get stats, analyze competitors and transcripts |
+| Ideation | 6 | Generate lead magnet ideas, extract and generate content, write LinkedIn posts, polish |
+| Funnels | 9 | Create opt-in pages, customize copy/theme, publish/unpublish, AI-generate funnel content |
+| Leads | 2 | List captured leads with filters, export as CSV |
+| Analytics | 1 | Get per-funnel stats (views, leads, conversion rates) |
+| Brand Kit | 3 | Get/update business context, extract context from raw text |
+| Email Sequences | 4 | Generate AI welcome sequences, edit emails, activate drip campaigns |
+| Content Pipeline | 34 | Transcripts, AI Brain knowledge base, content ideas, pipeline posts, autopilot, writing styles, templates, content planner, business context |
+| Swipe File | 3 | Browse community posts and lead magnets, submit your own |
+| Libraries | 7 | Create content libraries, manage items, gate behind funnels |
+| Qualification Forms | 5 | Create forms with scoring questions, attach to funnels |
+| **Total** | **81** | |
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `MAGNETLAB_API_KEY` | Yes | Your MagnetLab API key (starts with `ml_live_`) |
+| `MAGNETLAB_BASE_URL` | No | Override the API base URL (default: `https://magnetlab.ai`) |
+
+## CLI Usage
+
+Start the MCP server (stdio transport):
+
+```bash
+# Using environment variable
+MAGNETLAB_API_KEY=ml_live_xxx npx @magnetlab/mcp serve
+
+# Using --api-key flag
+npx @magnetlab/mcp serve --api-key ml_live_xxx
+
+# With custom base URL
+npx @magnetlab/mcp serve --base-url http://localhost:3000
+```
+
+## Example Prompts
+
+Once the MCP server is connected, try these in Claude:
+
+**Lead magnets:**
+- "List all my lead magnets"
+- "Create a new lead magnet called 'LinkedIn Growth Playbook' with the focused-toolkit archetype"
+- "What are the stats on my best-performing lead magnet?"
+
+**Funnels:**
+- "Create an opt-in page for my latest lead magnet with a dark theme"
+- "Generate funnel copy for lead magnet [id]"
+- "Publish my funnel and give me the live URL"
+
+**Content pipeline:**
+- "Search my AI Brain for insights about pricing objections"
+- "Write a LinkedIn post about [topic]"
+- "Show me my content buffer and what's scheduled this week"
+- "Trigger autopilot to generate 5 new posts"
+
+**Lead management:**
+- "How many leads did I capture this month?"
+- "Export all qualified leads as CSV"
+
+**Brand kit:**
+- "Extract my business context from this offer document: [paste text]"
+- "Update my brand kit with these pain points: ..."
+
+## License
+
+MIT

package/dist/client.d.ts

@@ -0,0 +1,465 @@
+import type { Archetype, LeadMagnetStatus, FunnelTheme, BackgroundStyle, FunnelTargetType, IdeaStatus, ContentPillar, ContentType, KnowledgeCategory, PipelinePostStatus, ExtractContentType } from './constants.js';
+export interface MagnetLabClientOptions {
+    baseUrl?: string;
+}
+export declare class MagnetLabClient {
+    private apiKey;
+    private baseUrl;
+    constructor(apiKey: string, options?: MagnetLabClientOptions);
+    request<T>(method: string, path: string, body?: unknown): Promise<T>;
+    listLeadMagnets(params?: {
+        status?: LeadMagnetStatus;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        leadMagnets: unknown[];
+        total: number;
+    }>;
+    getLeadMagnet(id: string): Promise<unknown>;
+    createLeadMagnet(params: {
+        title: string;
+        archetype: Archetype;
+        concept?: unknown;
+        extractedContent?: unknown;
+        linkedinPost?: string;
+        postVariations?: unknown;
+        dmTemplate?: string;
+        ctaWord?: string;
+    }): Promise<unknown>;
+    deleteLeadMagnet(id: string): Promise<{
+        success: boolean;
+    }>;
+    ideateLeadMagnets(params: {
+        businessDescription: string;
+        businessType: string;
+        credibilityMarkers?: string[];
+        urgentPains?: string[];
+        templates?: string[];
+        processes?: string[];
+        tools?: string[];
+        frequentQuestions?: string[];
+        results?: string[];
+        successExample?: string;
+    }): Promise<{
+        jobId: string;
+        status: string;
+    }>;
+    extractContent(leadMagnetId: string, params: {
+        archetype: Archetype;
+        concept: unknown;
+        answers: Record<string, string>;
+    }): Promise<unknown>;
+    generateContent(leadMagnetId: string, params: {
+        archetype: Archetype;
+        concept: unknown;
+        answers: Record<string, string>;
+    }): Promise<unknown>;
+    writeLinkedInPosts(leadMagnetId: string, params: {
+        leadMagnetTitle: string;
+        contents: string;
+        problemSolved: string;
+    }): Promise<unknown>;
+    polishLeadMagnetContent(leadMagnetId: string): Promise<unknown>;
+    getLeadMagnetStats(leadMagnetId: string): Promise<{
+        success: boolean;
+        data: {
+            leadMagnetId: string;
+            views: number;
+            leads: number;
+            conversionRate: number;
+        };
+    }>;
+    importLeadMagnet(data: unknown): Promise<unknown>;
+    analyzeCompetitor(params: {
+        url: string;
+    }): Promise<unknown>;
+    analyzeTranscript(params: {
+        transcript: string;
+    }): Promise<unknown>;
+    listFunnels(): Promise<{
+        funnels: unknown[];
+    }>;
+    getFunnel(id: string): Promise<{
+        funnel: unknown;
+    }>;
+    getFunnelByTarget(params: {
+        leadMagnetId?: string;
+        libraryId?: string;
+        externalResourceId?: string;
+    }): Promise<{
+        funnel: unknown | null;
+    }>;
+    createFunnel(params: {
+        leadMagnetId?: string;
+        libraryId?: string;
+        externalResourceId?: string;
+        targetType?: FunnelTargetType;
+        slug: string;
+        optinHeadline?: string;
+        optinSubline?: string;
+        optinButtonText?: string;
+        optinSocialProof?: string;
+        thankyouHeadline?: string;
+        thankyouSubline?: string;
+        vslUrl?: string;
+        calendlyUrl?: string;
+        theme?: FunnelTheme;
+        primaryColor?: string;
+        backgroundStyle?: BackgroundStyle;
+        logoUrl?: string;
+        qualificationFormId?: string;
+    }): Promise<{
+        funnel: unknown;
+    }>;
+    updateFunnel(id: string, params: {
+        slug?: string;
+        optinHeadline?: string;
+        optinSubline?: string;
+        optinButtonText?: string;
+        optinSocialProof?: string;
+        thankyouHeadline?: string;
+        thankyouSubline?: string;
+        vslUrl?: string;
+        calendlyUrl?: string;
+        theme?: FunnelTheme;
+        primaryColor?: string;
+        backgroundStyle?: BackgroundStyle;
+        logoUrl?: string;
+        qualificationFormId?: string | null;
+    }): Promise<{
+        funnel: unknown;
+    }>;
+    deleteFunnel(id: string): Promise<{
+        success: boolean;
+    }>;
+    publishFunnel(id: string): Promise<{
+        funnel: unknown;
+        publicUrl: string | null;
+    }>;
+    unpublishFunnel(id: string): Promise<{
+        funnel: unknown;
+    }>;
+    getFunnelStats(): Promise<{
+        stats: Record<string, unknown>;
+    }>;
+    generateFunnelContent(params: {
+        leadMagnetId: string;
+    }): Promise<unknown>;
+    listLeads(params?: {
+        funnelId?: string;
+        leadMagnetId?: string;
+        qualified?: boolean;
+        search?: string;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        leads: unknown[];
+        total: number;
+    }>;
+    exportLeads(params?: {
+        funnelId?: string;
+        leadMagnetId?: string;
+        qualified?: boolean;
+    }): Promise<{
+        csv: string;
+    }>;
+    getBrandKit(): Promise<{
+        brandKit: unknown | null;
+        savedIdeation: unknown | null;
+        ideationGeneratedAt: string | null;
+    }>;
+    updateBrandKit(params: {
+        businessDescription?: string;
+        businessType?: string;
+        credibilityMarkers?: string[];
+        urgentPains?: string[];
+        templates?: string[];
+        processes?: string[];
+        tools?: string[];
+        frequentQuestions?: string[];
+        results?: string[];
+        successExample?: string;
+        audienceTools?: string[];
+        preferredTone?: string;
+        styleProfile?: unknown;
+    }): Promise<unknown>;
+    extractBusinessContext(params: {
+        content: string;
+        contentType?: ExtractContentType;
+    }): Promise<unknown>;
+    getEmailSequence(leadMagnetId: string): Promise<{
+        emailSequence: unknown | null;
+    }>;
+    generateEmailSequence(params: {
+        leadMagnetId: string;
+        useAI?: boolean;
+    }): Promise<{
+        emailSequence: unknown;
+        generated: boolean;
+    }>;
+    updateEmailSequence(leadMagnetId: string, params: {
+        emails?: Array<{
+            day: number;
+            subject: string;
+            body: string;
+            replyTrigger: string;
+        }>;
+        status?: 'draft' | 'synced' | 'active';
+    }): Promise<{
+        emailSequence: unknown;
+    }>;
+    activateEmailSequence(leadMagnetId: string): Promise<unknown>;
+    listTranscripts(): Promise<{
+        transcripts: unknown[];
+    }>;
+    submitTranscript(params: {
+        transcript: string;
+        title?: string;
+    }): Promise<{
+        success: boolean;
+        transcript_id: string;
+    }>;
+    deleteTranscript(id: string): Promise<{
+        success: boolean;
+    }>;
+    searchKnowledge(params: {
+        query?: string;
+        category?: KnowledgeCategory;
+        view?: 'tags';
+    }): Promise<{
+        entries?: unknown[];
+        tags?: unknown[];
+        total_count?: number;
+    }>;
+    getKnowledgeClusters(): Promise<{
+        clusters: unknown[];
+    }>;
+    listIdeas(params?: {
+        status?: IdeaStatus;
+        pillar?: ContentPillar;
+        contentType?: ContentType;
+        limit?: number;
+    }): Promise<{
+        ideas: unknown[];
+    }>;
+    updateIdeaStatus(ideaId: string, status: IdeaStatus): Promise<{
+        idea: unknown;
+    }>;
+    getIdea(id: string): Promise<{
+        idea: unknown;
+    }>;
+    deleteIdea(id: string): Promise<{
+        success: boolean;
+    }>;
+    writePostFromIdea(ideaId: string): Promise<unknown>;
+    listPosts(params?: {
+        status?: PipelinePostStatus;
+        isBuffer?: boolean;
+        limit?: number;
+    }): Promise<{
+        posts: unknown[];
+    }>;
+    getPost(id: string): Promise<{
+        post: unknown;
+    }>;
+    updatePost(id: string, params: Record<string, unknown>): Promise<{
+        post: unknown;
+    }>;
+    deletePost(id: string): Promise<{
+        success: boolean;
+    }>;
+    polishPost(id: string): Promise<{
+        success: boolean;
+        polishResult: unknown;
+    }>;
+    publishPost(id: string): Promise<unknown>;
+    schedulePost(params: {
+        postId: string;
+        scheduledTime: string;
+    }): Promise<unknown>;
+    getPostsByDateRange(params: {
+        startDate: string;
+        endDate: string;
+    }): Promise<{
+        posts: unknown[];
+    }>;
+    quickWritePost(params: {
+        topic: string;
+        style?: string;
+        template?: string;
+    }): Promise<unknown>;
+    listPostingSlots(): Promise<{
+        slots: unknown[];
+    }>;
+    createPostingSlot(params: {
+        dayOfWeek: number;
+        time: string;
+    }): Promise<{
+        slot: unknown;
+    }>;
+    updatePostingSlot(id: string, params: {
+        dayOfWeek?: number;
+        time?: string;
+    }): Promise<{
+        slot: unknown;
+    }>;
+    deletePostingSlot(id: string): Promise<{
+        success: boolean;
+    }>;
+    getAutopilotStatus(): Promise<{
+        bufferSize: number;
+        nextScheduledSlot: string;
+        pillarCounts: Record<string, number>;
+    }>;
+    triggerAutopilot(params?: {
+        postsPerBatch?: number;
+        bufferTarget?: number;
+        autoPublish?: boolean;
+    }): Promise<{
+        triggered: boolean;
+        runId: string;
+    }>;
+    getBuffer(): Promise<{
+        posts: unknown[];
+    }>;
+    listWritingStyles(): Promise<{
+        styles: unknown[];
+    }>;
+    extractWritingStyle(params: {
+        linkedinUrl: string;
+    }): Promise<unknown>;
+    getWritingStyle(id: string): Promise<{
+        style: unknown;
+    }>;
+    listTemplates(params?: {
+        limit?: number;
+    }): Promise<{
+        templates: unknown[];
+    }>;
+    getTemplate(id: string): Promise<{
+        template: unknown;
+    }>;
+    matchTemplate(params: {
+        ideaId: string;
+    }): Promise<{
+        matches: unknown[];
+    }>;
+    getPlan(): Promise<{
+        plan: unknown;
+    }>;
+    generatePlan(params?: {
+        weekCount?: number;
+    }): Promise<unknown>;
+    approvePlan(params: {
+        planId: string;
+    }): Promise<unknown>;
+    updatePlanItem(id: string, params: Record<string, unknown>): Promise<unknown>;
+    getBusinessContext(): Promise<{
+        businessContext: unknown;
+    }>;
+    updateBusinessContext(params: Record<string, unknown>): Promise<unknown>;
+    browseSwipeFilePosts(params?: {
+        niche?: string;
+        type?: string;
+        featured?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        posts: unknown[];
+        total: number;
+    }>;
+    browseSwipeFileLeadMagnets(params?: {
+        niche?: string;
+        format?: string;
+        featured?: boolean;
+        limit?: number;
+        offset?: number;
+    }): Promise<{
+        leadMagnets: unknown[];
+        total: number;
+    }>;
+    submitToSwipeFile(params: {
+        content: string;
+        type: string;
+        niche: string;
+    }): Promise<unknown>;
+    getFunnelAnalytics(): Promise<{
+        stats: Record<string, unknown>;
+    }>;
+    getLeadMagnetAnalytics(leadMagnetId: string): Promise<{
+        success: boolean;
+        data: {
+            leadMagnetId: string;
+            views: number;
+            leads: number;
+            conversionRate: number;
+        };
+    }>;
+    listLibraries(): Promise<{
+        libraries: unknown[];
+    }>;
+    getLibrary(id: string): Promise<{
+        library: unknown;
+    }>;
+    createLibrary(params: {
+        name: string;
+        description?: string;
+    }): Promise<{
+        library: unknown;
+    }>;
+    updateLibrary(id: string, params: {
+        name?: string;
+        description?: string;
+    }): Promise<{
+        library: unknown;
+    }>;
+    deleteLibrary(id: string): Promise<{
+        success: boolean;
+    }>;
+    listLibraryItems(libraryId: string): Promise<{
+        items: unknown[];
+    }>;
+    createLibraryItem(libraryId: string, params: Record<string, unknown>): Promise<{
+        item: unknown;
+    }>;
+    listExternalResources(): Promise<{
+        resources: unknown[];
+    }>;
+    getExternalResource(id: string): Promise<{
+        resource: unknown;
+    }>;
+    createExternalResource(params: {
+        title: string;
+        url: string;
+        description?: string;
+    }): Promise<{
+        resource: unknown;
+    }>;
+    listQualificationForms(): Promise<{
+        forms: unknown[];
+    }>;
+    getQualificationForm(id: string): Promise<{
+        form: unknown;
+    }>;
+    createQualificationForm(params: {
+        name: string;
+    }): Promise<{
+        form: unknown;
+    }>;
+    listQuestions(formId: string): Promise<{
+        questions: unknown[];
+    }>;
+    createQuestion(formId: string, params: Record<string, unknown>): Promise<{
+        question: unknown;
+    }>;
+    listIntegrations(): Promise<{
+        integrations: unknown[];
+    }>;
+    verifyIntegration(params: {
+        provider: string;
+        apiKey: string;
+    }): Promise<{
+        valid: boolean;
+    }>;
+    getJobStatus(id: string): Promise<unknown>;
+}