@magnetlab/mcp 0.1.0

package/dist/tools/qualification-forms.js

@@ -0,0 +1,71 @@
+export const qualificationFormTools = [
+    {
+        name: 'magnetlab_list_qualification_forms',
+        description: 'List all qualification forms. These are survey forms attached to funnel pages that filter leads into qualified/unqualified based on their answers.',
+        inputSchema: {
+            type: 'object',
+            properties: {},
+        },
+    },
+    {
+        name: 'magnetlab_get_qualification_form',
+        description: 'Get details of a qualification form.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                id: { type: 'string', description: 'Qualification form UUID' },
+            },
+            required: ['id'],
+        },
+    },
+    {
+        name: 'magnetlab_create_qualification_form',
+        description: 'Create a new qualification form. Add questions to it afterward, then attach it to a funnel page.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                name: { type: 'string', description: 'Form name' },
+            },
+            required: ['name'],
+        },
+    },
+    {
+        name: 'magnetlab_list_questions',
+        description: 'List all questions in a qualification form.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                form_id: { type: 'string', description: 'Qualification form UUID' },
+            },
+            required: ['form_id'],
+        },
+    },
+    {
+        name: 'magnetlab_create_question',
+        description: 'Add a question to a qualification form.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                form_id: { type: 'string', description: 'Qualification form UUID' },
+                question_text: { type: 'string', description: 'The question text' },
+                question_type: {
+                    type: 'string',
+                    enum: ['text', 'single_choice', 'multi_choice'],
+                    description: 'Question type',
+                },
+                options: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Answer options (for choice types)',
+                },
+                qualifying_answers: {
+                    type: 'array',
+                    items: { type: 'string' },
+                    description: 'Which answers qualify the lead',
+                },
+                is_required: { type: 'boolean', description: 'Whether the question is required' },
+            },
+            required: ['form_id', 'question_text', 'question_type'],
+        },
+    },
+];

package/dist/tools/swipe-file.d.ts

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

package/dist/tools/swipe-file.js

@@ -0,0 +1,46 @@
+export const swipeFileTools = [
+    {
+        name: 'magnetlab_browse_swipe_posts',
+        description: 'Browse the community swipe file of high-performing LinkedIn posts. Filter by niche, post type, or featured status. Great for inspiration.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                niche: { type: 'string', description: 'Filter by niche/industry' },
+                type: {
+                    type: 'string',
+                    description: 'Filter by post type (e.g. hook, story, educational, promotional, engagement)',
+                },
+                featured: { type: 'boolean', description: 'Only show featured/top posts' },
+                limit: { type: 'number', default: 20, description: 'Max results (1-50)' },
+                offset: { type: 'number', default: 0, description: 'Pagination offset' },
+            },
+        },
+    },
+    {
+        name: 'magnetlab_browse_swipe_lead_magnets',
+        description: 'Browse the community swipe file of lead magnet examples. Filter by niche or format. See what lead magnets are working for others.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                niche: { type: 'string', description: 'Filter by niche/industry' },
+                format: { type: 'string', description: 'Filter by lead magnet format' },
+                featured: { type: 'boolean', description: 'Only show featured examples' },
+                limit: { type: 'number', default: 20, description: 'Max results (1-50)' },
+                offset: { type: 'number', default: 0, description: 'Pagination offset' },
+            },
+        },
+    },
+    {
+        name: 'magnetlab_submit_to_swipe_file',
+        description: 'Submit content to the community swipe file. Posts are reviewed before being made public.',
+        inputSchema: {
+            type: 'object',
+            properties: {
+                content: { type: 'string', description: 'The post content to share' },
+                type: { type: 'string', description: 'Post type category' },
+                niche: { type: 'string', description: 'Your niche/industry' },
+            },
+            required: ['content', 'type', 'niche'],
+        },
+    },
+];

package/dist/validation.d.ts

@@ -0,0 +1,476 @@
+import { z } from 'zod';
+export declare const toolSchemas: {
+    readonly magnetlab_get_lead_magnet: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_create_lead_magnet: z.ZodObject<{
+        title: z.ZodString;
+        archetype: z.ZodEnum<[string, ...string[]]>;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        archetype: string;
+    }, {
+        title: string;
+        archetype: string;
+    }>;
+    readonly magnetlab_delete_lead_magnet: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_get_lead_magnet_stats: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_analyze_competitor: z.ZodObject<{
+        url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        url: string;
+    }, {
+        url: string;
+    }>;
+    readonly magnetlab_analyze_transcript: z.ZodObject<{
+        transcript: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        transcript: string;
+    }, {
+        transcript: string;
+    }>;
+    readonly magnetlab_ideate_lead_magnets: z.ZodObject<{
+        business_description: z.ZodString;
+        business_type: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        business_description: string;
+        business_type: string;
+    }, {
+        business_description: string;
+        business_type: string;
+    }>;
+    readonly magnetlab_extract_content: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+        archetype: z.ZodEnum<[string, ...string[]]>;
+        concept: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        answers: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        archetype: string;
+        concept: Record<string, unknown>;
+        lead_magnet_id: string;
+        answers: Record<string, string>;
+    }, {
+        archetype: string;
+        concept: Record<string, unknown>;
+        lead_magnet_id: string;
+        answers: Record<string, string>;
+    }>;
+    readonly magnetlab_generate_content: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+        archetype: z.ZodEnum<[string, ...string[]]>;
+        concept: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        answers: z.ZodRecord<z.ZodString, z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        archetype: string;
+        concept: Record<string, unknown>;
+        lead_magnet_id: string;
+        answers: Record<string, string>;
+    }, {
+        archetype: string;
+        concept: Record<string, unknown>;
+        lead_magnet_id: string;
+        answers: Record<string, string>;
+    }>;
+    readonly magnetlab_write_linkedin_posts: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+        lead_magnet_title: z.ZodString;
+        contents: z.ZodString;
+        problem_solved: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+        lead_magnet_title: string;
+        contents: string;
+        problem_solved: string;
+    }, {
+        lead_magnet_id: string;
+        lead_magnet_title: string;
+        contents: string;
+        problem_solved: string;
+    }>;
+    readonly magnetlab_polish_lead_magnet: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_get_job_status: z.ZodObject<{
+        job_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        job_id: string;
+    }, {
+        job_id: string;
+    }>;
+    readonly magnetlab_get_funnel: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_create_funnel: z.ZodObject<{
+        slug: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        slug: string;
+    }, {
+        slug: string;
+    }>;
+    readonly magnetlab_update_funnel: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_delete_funnel: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_publish_funnel: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_unpublish_funnel: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_generate_funnel_content: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_get_email_sequence: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_generate_email_sequence: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_update_email_sequence: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_activate_email_sequence: z.ZodObject<{
+        lead_magnet_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        lead_magnet_id: string;
+    }, {
+        lead_magnet_id: string;
+    }>;
+    readonly magnetlab_submit_transcript: z.ZodObject<{
+        transcript: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        transcript: string;
+    }, {
+        transcript: string;
+    }>;
+    readonly magnetlab_delete_transcript: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_search_knowledge: z.ZodObject<{
+        query: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+    }, {
+        query: string;
+    }>;
+    readonly magnetlab_get_idea: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_update_idea_status: z.ZodObject<{
+        idea_id: z.ZodString;
+        status: z.ZodEnum<[string, ...string[]]>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        idea_id: string;
+    }, {
+        status: string;
+        idea_id: string;
+    }>;
+    readonly magnetlab_delete_idea: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_write_post_from_idea: z.ZodObject<{
+        idea_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        idea_id: string;
+    }, {
+        idea_id: string;
+    }>;
+    readonly magnetlab_get_post: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_update_post: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_delete_post: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_polish_post: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_publish_post: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_schedule_post: z.ZodObject<{
+        post_id: z.ZodString;
+        scheduled_time: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        post_id: string;
+        scheduled_time: string;
+    }, {
+        post_id: string;
+        scheduled_time: string;
+    }>;
+    readonly magnetlab_get_posts_by_date_range: z.ZodObject<{
+        start_date: z.ZodString;
+        end_date: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        start_date: string;
+        end_date: string;
+    }, {
+        start_date: string;
+        end_date: string;
+    }>;
+    readonly magnetlab_quick_write: z.ZodObject<{
+        topic: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        topic: string;
+    }, {
+        topic: string;
+    }>;
+    readonly magnetlab_create_posting_slot: z.ZodObject<{
+        day_of_week: z.ZodNumber;
+        time: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        day_of_week: number;
+        time: string;
+    }, {
+        day_of_week: number;
+        time: string;
+    }>;
+    readonly magnetlab_delete_posting_slot: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_approve_plan: z.ZodObject<{
+        plan_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        plan_id: string;
+    }, {
+        plan_id: string;
+    }>;
+    readonly magnetlab_update_business_context: z.ZodObject<{
+        context: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strip", z.ZodTypeAny, {
+        context: Record<string, unknown>;
+    }, {
+        context: Record<string, unknown>;
+    }>;
+    readonly magnetlab_extract_writing_style: z.ZodObject<{
+        linkedin_url: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        linkedin_url: string;
+    }, {
+        linkedin_url: string;
+    }>;
+    readonly magnetlab_get_writing_style: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_match_template: z.ZodObject<{
+        idea_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        idea_id: string;
+    }, {
+        idea_id: string;
+    }>;
+    readonly magnetlab_extract_business_context: z.ZodObject<{
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        content: string;
+    }, {
+        content: string;
+    }>;
+    readonly magnetlab_submit_to_swipe_file: z.ZodObject<{
+        content: z.ZodString;
+        type: z.ZodString;
+        niche: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        niche: string;
+        type: string;
+        content: string;
+    }, {
+        niche: string;
+        type: string;
+        content: string;
+    }>;
+    readonly magnetlab_get_library: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_create_library: z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>;
+    readonly magnetlab_update_library: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_delete_library: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_list_library_items: z.ZodObject<{
+        library_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        library_id: string;
+    }, {
+        library_id: string;
+    }>;
+    readonly magnetlab_create_library_item: z.ZodObject<{
+        library_id: z.ZodString;
+        title: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        library_id: string;
+    }, {
+        title: string;
+        library_id: string;
+    }>;
+    readonly magnetlab_get_qualification_form: z.ZodObject<{
+        id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+    }, {
+        id: string;
+    }>;
+    readonly magnetlab_create_qualification_form: z.ZodObject<{
+        name: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        name: string;
+    }, {
+        name: string;
+    }>;
+    readonly magnetlab_list_questions: z.ZodObject<{
+        form_id: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        form_id: string;
+    }, {
+        form_id: string;
+    }>;
+    readonly magnetlab_create_question: z.ZodObject<{
+        form_id: z.ZodString;
+        question_text: z.ZodString;
+        question_type: z.ZodEnum<["text", "single_choice", "multi_choice"]>;
+    }, "strip", z.ZodTypeAny, {
+        form_id: string;
+        question_text: string;
+        question_type: "text" | "single_choice" | "multi_choice";
+    }, {
+        form_id: string;
+        question_text: string;
+        question_type: "text" | "single_choice" | "multi_choice";
+    }>;
+};
+export type ToolName = keyof typeof toolSchemas;
+export type ValidationResult<T> = {
+    success: true;
+    data: T;
+} | {
+    success: false;
+    error: string;
+};
+/**
+ * Validate tool arguments against the schema for the given tool.
+ * Returns success with parsed data if valid, or failure with error message.
+ * Tools without schemas pass through unchanged.
+ */
+export declare function validateToolArgs<T>(toolName: string, args: unknown): ValidationResult<T>;