@magnetlab/mcp 0.1.0

package/dist/tools/funnels.js

@@ -0,0 +1,153 @@
+export const funnelTools = [
+    {
+        name: 'magnetlab_list_funnels',
+        description: 'List all funnel pages for the current user. Returns funnel ID, slug, headline, theme, publish status, and target (lead magnet, library, or external resource).',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'magnetlab_get_funnel',
+        description: 'Get full details of a funnel page including all opt-in and thank-you copy, theme settings, qualification form, and publish status.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Funnel page UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_get_funnel_by_target',
+        description: 'Find the funnel page associated with a specific lead magnet, library, or external resource. Useful to check if a funnel already exists before creating one.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID (for lead_magnet target)' },
+                library_id: { type: 'string', description: 'Library UUID (for library target)' },
+                external_resource_id: {
+                    type: 'string',
+                    description: 'External resource UUID (for external_resource target)',
+                },
+            },
+        },
+    },
+    {
+        name: 'magnetlab_create_funnel',
+        description: 'Create a new funnel/opt-in page. Must target a lead magnet, library, or external resource. Provide a slug (URL-safe name) and optionally customize headline, subline, button text, thank-you copy, theme (light/dark), colors, and VSL/Calendly URLs.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID (for lead_magnet target)' },
+                library_id: { type: 'string', description: 'Library UUID (for library target)' },
+                external_resource_id: {
+                    type: 'string',
+                    description: 'External resource UUID (for external_resource target)',
+                },
+                target_type: {
+                    type: 'string',
+                    enum: ['lead_magnet', 'library', 'external_resource'],
+                    description: 'What this funnel delivers (defaults based on which ID is provided)',
+                },
+                slug: { type: 'string', description: 'URL slug (e.g. "my-free-guide")' },
+                optin_headline: { type: 'string', description: 'Main headline on opt-in page' },
+                optin_subline: { type: 'string', description: 'Subheadline text' },
+                optin_button_text: {
+                    type: 'string',
+                    description: 'CTA button text (default: "Get Free Access")',
+                },
+                optin_social_proof: { type: 'string', description: 'Social proof line (e.g. "500+ downloads")' },
+                thankyou_headline: {
+                    type: 'string',
+                    description: 'Thank you page headline (default: "Thanks! Check your email.")',
+                },
+                thankyou_subline: { type: 'string', description: 'Thank you page subheadline' },
+                vsl_url: { type: 'string', description: 'Video URL to embed on thank-you page' },
+                calendly_url: { type: 'string', description: 'Calendly URL for booking on thank-you page' },
+                theme: { type: 'string', enum: ['light', 'dark'], description: 'Page theme (default: dark)' },
+                primary_color: { type: 'string', description: 'Primary accent color hex (default: #8b5cf6)' },
+                background_style: {
+                    type: 'string',
+                    enum: ['solid', 'gradient', 'pattern'],
+                    description: 'Background style',
+                },
+                logo_url: { type: 'string', description: 'Logo image URL' },
+                qualification_form_id: {
+                    type: 'string',
+                    description: 'Qualification form UUID to attach (filters leads)',
+                },
+            },
+            required: ['slug'],
+        },
+    },
+    {
+        name: 'magnetlab_update_funnel',
+        description: 'Update an existing funnel page. Change copy, theme, colors, URLs, or qualification form. Only provided fields are updated.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Funnel page UUID' },
+                slug: { type: 'string', description: 'New URL slug' },
+                optin_headline: { type: 'string' },
+                optin_subline: { type: 'string' },
+                optin_button_text: { type: 'string' },
+                optin_social_proof: { type: 'string' },
+                thankyou_headline: { type: 'string' },
+                thankyou_subline: { type: 'string' },
+                vsl_url: { type: 'string' },
+                calendly_url: { type: 'string' },
+                theme: { type: 'string', enum: ['light', 'dark'] },
+                primary_color: { type: 'string' },
+                background_style: { type: 'string', enum: ['solid', 'gradient', 'pattern'] },
+                logo_url: { type: 'string' },
+                qualification_form_id: { type: ['string', 'null'] },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_delete_funnel',
+        description: 'Delete a funnel page and all associated leads, page views, and qualification questions. This is permanent.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Funnel page UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_publish_funnel',
+        description: 'Publish a funnel page to make it publicly accessible. Returns the live URL (e.g. /p/username/slug). Requires the user to have a username set. Auto-polishes lead magnet content on first publish.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Funnel page UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_unpublish_funnel',
+        description: 'Take a funnel page offline. The URL will no longer be accessible.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Funnel page UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_generate_funnel_content',
+        description: 'Auto-generate opt-in page copy (headline, subline, button text) based on the lead magnet content using AI.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID to generate funnel copy for' },
+            },
+            required: ['lead_magnet_id'],
+        },
+    },
+];

package/dist/tools/ideation.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const ideationTools: Tool[];

package/dist/tools/ideation.js

@@ -0,0 +1,161 @@
+export const ideationTools = [
+    {
+        name: 'magnetlab_ideate_lead_magnets',
+        description: 'Generate lead magnet ideas based on your business context. Requires businessDescription and businessType at minimum. Returns a background job ID that you can poll with magnetlab_get_job_status. Ideas are generated using AI and saved to your brand kit.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                business_description: {
+                    type: 'string',
+                    description: 'What your business does and who you serve',
+                },
+                business_type: {
+                    type: 'string',
+                    description: 'Business category (e.g. "B2B SaaS", "Agency", "Coaching")',
+                },
+                credibility_markers: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Social proof, credentials, results (e.g. "Helped 200+ agencies scale")',
+                },
+                urgent_pains: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Top pain points your audience has',
+                },
+                templates: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Templates/frameworks you use with clients',
+                },
+                processes: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Key processes or methods you follow',
+                },
+                tools: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Tools or software you recommend',
+                },
+                frequent_questions: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Questions your prospects frequently ask',
+                },
+                results: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Typical results/outcomes you deliver',
+                },
+                success_example: {
+                    type: 'string',
+                    description: 'A specific client success story',
+                },
+            },
+            required: ['business_description', 'business_type'],
+        },
+    },
+    {
+        name: 'magnetlab_extract_content',
+        description: 'Run AI content extraction for a lead magnet. Provide the archetype, concept (from ideation), and answers to extraction questions. Returns the extracted structured content.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID' },
+                archetype: {
+                    type: 'string',
+                    enum: [
+                        'single-breakdown',
+                        'single-system',
+                        'focused-toolkit',
+                        'single-calculator',
+                        'focused-directory',
+                        'mini-training',
+                        'one-story',
+                        'prompt',
+                        'assessment',
+                        'workflow',
+                    ],
+                    description: 'Content archetype/format',
+                },
+                concept: { type: 'object', description: 'The concept object from ideation' },
+                answers: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                    description: 'Key-value map of extraction question IDs to user answers',
+                },
+            },
+            required: ['lead_magnet_id', 'archetype', 'concept', 'answers'],
+        },
+    },
+    {
+        name: 'magnetlab_generate_content',
+        description: 'Generate the final lead magnet content from extraction data. Provide the archetype, concept, and answers. Returns structured content ready for publishing.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID' },
+                archetype: {
+                    type: 'string',
+                    enum: [
+                        'single-breakdown',
+                        'single-system',
+                        'focused-toolkit',
+                        'single-calculator',
+                        'focused-directory',
+                        'mini-training',
+                        'one-story',
+                        'prompt',
+                        'assessment',
+                        'workflow',
+                    ],
+                    description: 'Content archetype/format',
+                },
+                concept: { type: 'object', description: 'The concept object from ideation' },
+                answers: {
+                    type: 'object',
+                    additionalProperties: { type: 'string' },
+                    description: 'Key-value map of extraction question IDs to user answers',
+                },
+            },
+            required: ['lead_magnet_id', 'archetype', 'concept', 'answers'],
+        },
+    },
+    {
+        name: 'magnetlab_write_linkedin_posts',
+        description: 'Generate 3 LinkedIn post variations to promote a lead magnet. Returns hooks, bodies, and CTAs optimized for LinkedIn engagement.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID' },
+                lead_magnet_title: { type: 'string', description: 'Title of the lead magnet' },
+                contents: { type: 'string', description: 'Summary of what the lead magnet contains' },
+                problem_solved: { type: 'string', description: 'The core problem this lead magnet solves' },
+            },
+            required: ['lead_magnet_id', 'lead_magnet_title', 'contents', 'problem_solved'],
+        },
+    },
+    {
+        name: 'magnetlab_polish_lead_magnet',
+        description: 'Polish/refine the generated content for a lead magnet. Improves formatting, readability, and impact. Runs AI enhancement on the extracted content.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID' },
+            },
+            required: ['lead_magnet_id'],
+        },
+    },
+    {
+        name: 'magnetlab_get_job_status',
+        description: 'Check the status of a background job (e.g. ideation, content generation). Returns current status and result when complete.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                job_id: { type: 'string', description: 'Background job UUID' },
+            },
+            required: ['job_id'],
+        },
+    },
+];

package/dist/tools/index.d.ts

@@ -0,0 +1,66 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const tools: Tool[];
+export { leadMagnetTools } from './lead-magnets.js';
+export { ideationTools } from './ideation.js';
+export { funnelTools } from './funnels.js';
+export { leadTools } from './leads.js';
+export { analyticsTools } from './analytics.js';
+export { brandKitTools } from './brand-kit.js';
+export { emailSequenceTools } from './email-sequences.js';
+export { contentPipelineTools } from './content-pipeline.js';
+export { swipeFileTools } from './swipe-file.js';
+export { libraryTools } from './libraries.js';
+export { qualificationFormTools } from './qualification-forms.js';
+export declare const toolsByName: Map<string, {
+    inputSchema: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    };
+    name: string;
+    description?: string | undefined;
+    outputSchema?: {
+        [x: string]: unknown;
+        type: "object";
+        properties?: {
+            [x: string]: object;
+        } | undefined;
+        required?: string[] | undefined;
+    } | undefined;
+    annotations?: {
+        title?: string | undefined;
+        readOnlyHint?: boolean | undefined;
+        destructiveHint?: boolean | undefined;
+        idempotentHint?: boolean | undefined;
+        openWorldHint?: boolean | undefined;
+    } | undefined;
+    execution?: {
+        taskSupport?: "optional" | "required" | "forbidden" | undefined;
+    } | undefined;
+    _meta?: {
+        [x: string]: unknown;
+    } | undefined;
+    icons?: {
+        src: string;
+        mimeType?: string | undefined;
+        sizes?: string[] | undefined;
+        theme?: "light" | "dark" | undefined;
+    }[] | undefined;
+    title?: string | undefined;
+}>;
+export declare const toolCategories: {
+    leadMagnets: string[];
+    ideation: string[];
+    funnels: string[];
+    leads: string[];
+    analytics: string[];
+    brandKit: string[];
+    emailSequences: string[];
+    contentPipeline: string[];
+    swipeFile: string[];
+    libraries: string[];
+    qualificationForms: string[];
+};

package/dist/tools/index.js

@@ -0,0 +1,52 @@
+import { leadMagnetTools } from './lead-magnets.js';
+import { ideationTools } from './ideation.js';
+import { funnelTools } from './funnels.js';
+import { leadTools } from './leads.js';
+import { analyticsTools } from './analytics.js';
+import { brandKitTools } from './brand-kit.js';
+import { emailSequenceTools } from './email-sequences.js';
+import { contentPipelineTools } from './content-pipeline.js';
+import { swipeFileTools } from './swipe-file.js';
+import { libraryTools } from './libraries.js';
+import { qualificationFormTools } from './qualification-forms.js';
+export const tools = [
+    ...leadMagnetTools,
+    ...ideationTools,
+    ...funnelTools,
+    ...leadTools,
+    ...analyticsTools,
+    ...brandKitTools,
+    ...emailSequenceTools,
+    ...contentPipelineTools,
+    ...swipeFileTools,
+    ...libraryTools,
+    ...qualificationFormTools,
+];
+// Re-export individual tool arrays for selective imports
+export { leadMagnetTools } from './lead-magnets.js';
+export { ideationTools } from './ideation.js';
+export { funnelTools } from './funnels.js';
+export { leadTools } from './leads.js';
+export { analyticsTools } from './analytics.js';
+export { brandKitTools } from './brand-kit.js';
+export { emailSequenceTools } from './email-sequences.js';
+export { contentPipelineTools } from './content-pipeline.js';
+export { swipeFileTools } from './swipe-file.js';
+export { libraryTools } from './libraries.js';
+export { qualificationFormTools } from './qualification-forms.js';
+// Tool lookup by name for handler routing
+export const toolsByName = new Map(tools.map((tool) => [tool.name, tool]));
+// Get tool names by category
+export const toolCategories = {
+    leadMagnets: leadMagnetTools.map((t) => t.name),
+    ideation: ideationTools.map((t) => t.name),
+    funnels: funnelTools.map((t) => t.name),
+    leads: leadTools.map((t) => t.name),
+    analytics: analyticsTools.map((t) => t.name),
+    brandKit: brandKitTools.map((t) => t.name),
+    emailSequences: emailSequenceTools.map((t) => t.name),
+    contentPipeline: contentPipelineTools.map((t) => t.name),
+    swipeFile: swipeFileTools.map((t) => t.name),
+    libraries: libraryTools.map((t) => t.name),
+    qualificationForms: qualificationFormTools.map((t) => t.name),
+};

package/dist/tools/lead-magnets.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const leadMagnetTools: Tool[];

package/dist/tools/lead-magnets.js

@@ -0,0 +1,101 @@
+export const leadMagnetTools = [
+    {
+        name: 'magnetlab_list_lead_magnets',
+        description: 'List all lead magnets for the current user. Returns title, archetype, status, and creation date. Use the status filter to find drafts, published, or in-progress lead magnets.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                status: {
+                    type: 'string',
+                    enum: ['draft', 'extracting', 'generating', 'content_ready', 'complete', 'published'],
+                    description: 'Filter by lead magnet status',
+                },
+                limit: { type: 'number', default: 50, description: 'Max results to return (1-100)' },
+                offset: { type: 'number', default: 0, description: 'Offset for pagination' },
+            },
+        },
+    },
+    {
+        name: 'magnetlab_get_lead_magnet',
+        description: 'Get full details of a single lead magnet including its concept, extracted content, generated content, LinkedIn posts, post variations, DM template, and CTA word.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Lead magnet UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_create_lead_magnet',
+        description: 'Create a new lead magnet. Choose an archetype (e.g. single-breakdown, focused-toolkit, assessment) and provide a title. Optionally include concept data, extracted content, or post variations if pre-generated.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                title: { type: 'string', description: 'Lead magnet title' },
+                archetype: {
+                    type: 'string',
+                    enum: [
+                        'single-breakdown',
+                        'single-system',
+                        'focused-toolkit',
+                        'single-calculator',
+                        'focused-directory',
+                        'mini-training',
+                        'one-story',
+                        'prompt',
+                        'assessment',
+                        'workflow',
+                    ],
+                    description: 'Content archetype/format',
+                },
+                concept: { type: 'object', description: 'Concept data (optional, from ideation)' },
+            },
+            required: ['title', 'archetype'],
+        },
+    },
+    {
+        name: 'magnetlab_delete_lead_magnet',
+        description: 'Permanently delete a lead magnet. This also removes associated funnel pages and leads.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Lead magnet UUID to delete' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_get_lead_magnet_stats',
+        description: 'Get performance statistics for a specific lead magnet: page views, leads captured, and conversion rate.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                lead_magnet_id: { type: 'string', description: 'Lead magnet UUID' },
+            },
+            required: ['lead_magnet_id'],
+        },
+    },
+    {
+        name: 'magnetlab_analyze_competitor',
+        description: 'Analyze a competitor URL to extract insights for lead magnet ideation. Provide a URL to a landing page, lead magnet, or content piece.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                url: { type: 'string', description: 'URL of the competitor content to analyze' },
+            },
+            required: ['url'],
+        },
+    },
+    {
+        name: 'magnetlab_analyze_transcript',
+        description: 'Analyze a sales call or podcast transcript to extract lead magnet ideas, pain points, and content themes.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                transcript: { type: 'string', description: 'Full text of the transcript to analyze' },
+            },
+            required: ['transcript'],
+        },
+    },
+];

package/dist/tools/leads.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const leadTools: Tool[];

package/dist/tools/leads.js

@@ -0,0 +1,32 @@
+export const leadTools = [
+    {
+        name: 'magnetlab_list_leads',
+        description: 'List captured leads with filtering and pagination. Returns email, name, qualification status, UTM data, and which funnel/lead magnet they came from. Use search to find leads by email or name.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                funnel_id: { type: 'string', description: 'Filter by specific funnel page UUID' },
+                lead_magnet_id: { type: 'string', description: 'Filter by lead magnet UUID' },
+                qualified: {
+                    type: 'boolean',
+                    description: 'Filter by qualification status (true = qualified, false = unqualified)',
+                },
+                search: { type: 'string', description: 'Search by email or name (case-insensitive)' },
+                limit: { type: 'number', default: 50, description: 'Max results (1-100)' },
+                offset: { type: 'number', default: 0, description: 'Pagination offset' },
+            },
+        },
+    },
+    {
+        name: 'magnetlab_export_leads',
+        description: 'Export leads as CSV file. Filter by funnel, lead magnet, or qualification status. Returns CSV text with headers: email, name, qualified, lead_magnet, funnel_slug, answers, utm_source, utm_medium, utm_campaign, created_at.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                funnel_id: { type: 'string', description: 'Filter by funnel page UUID' },
+                lead_magnet_id: { type: 'string', description: 'Filter by lead magnet UUID' },
+                qualified: { type: 'boolean', description: 'Filter by qualification status' },
+            },
+        },
+    },
+];

package/dist/tools/libraries.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const libraryTools: Tool[];

package/dist/tools/libraries.js

@@ -0,0 +1,83 @@
+export const libraryTools = [
+    {
+        name: 'magnetlab_list_libraries',
+        description: 'List all content libraries. Libraries are collections of resources (links, files, documents) that can be gated behind funnel pages.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'magnetlab_get_library',
+        description: 'Get full details of a content library including its name, description, and metadata.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Library UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_create_library',
+        description: 'Create a new content library. Add items to it afterward, then create a funnel page to gate access.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Library name' },
+                description: { type: 'string', description: 'Library description' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'magnetlab_update_library',
+        description: 'Update a library\'s name or description.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Library UUID' },
+                name: { type: 'string', description: 'New name' },
+                description: { type: 'string', description: 'New description' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_delete_library',
+        description: 'Delete a content library and all its items.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Library UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_list_library_items',
+        description: 'List all items in a content library.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                library_id: { type: 'string', description: 'Library UUID' },
+            },
+            required: ['library_id'],
+        },
+    },
+    {
+        name: 'magnetlab_create_library_item',
+        description: 'Add a new item to a content library.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                library_id: { type: 'string', description: 'Library UUID' },
+                title: { type: 'string', description: 'Item title' },
+                url: { type: 'string', description: 'Resource URL' },
+                description: { type: 'string', description: 'Item description' },
+                type: { type: 'string', description: 'Item type (e.g. link, file, video)' },
+            },
+            required: ['library_id', 'title'],
+        },
+    },
+];

package/dist/tools/qualification-forms.d.ts

@@ -0,0 +1,2 @@
+import { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare const qualificationFormTools: Tool[];