@soldy_ai/mcp 0.1.6

package/dist/tools/message.js

@@ -0,0 +1,241 @@
+import { z } from "zod";
+import { formatApiError } from "../errors.js";
+import { resolveUrls } from "../files.js";
+export function registerMessageTools(server, client) {
+    server.tool("send_message", `Send a message to the project agent to start or continue generation.
+
+Required: ratio — the video aspect ratio. Choose based on target platform:
+- 9:16 → TikTok, Reels, Shorts (vertical)
+- 16:9 → YouTube, landscape video
+- 1:1 → Instagram, square
+- 4:3, 3:4, 3:2, 2:3, 21:9 → other formats
+
+Also supports:
+- material_urls: local file paths (auto-uploaded), GCS URLs, or external http URLs
+- brand_id: pass for brand-aware generation (get from list_brands or extract_brand)
+
+The agent starts processing and project status becomes "running".
+After sending, use watch_project(project_id) to subscribe for real-time status/message/material updates. Alternatively, poll get_project_status.`, {
+        project_id: z.string(),
+        content: z
+            .string()
+            .describe("Message to the agent describing what to generate or modify"),
+        material_urls: z
+            .array(z.string())
+            .optional()
+            .describe("Image/video/audio URLs or local file paths"),
+        ratio: z
+            .enum(["9:16", "16:9", "1:1", "4:3", "3:4", "3:2", "2:3", "21:9"])
+            .describe("Video aspect ratio (required). Common: '9:16' (TikTok/Reels/Shorts), '16:9' (YouTube/landscape), '1:1' (Instagram/square), '4:3'/'3:4', '3:2'/'2:3', '21:9' (ultra-wide)"),
+        brand_id: z
+            .string()
+            .optional()
+            .describe("Brand ID for generation context. Get from list_brands or extract_brand."),
+    }, async ({ project_id, content, material_urls, ratio, brand_id }) => {
+        let resolvedUrls;
+        if (material_urls?.length) {
+            try {
+                resolvedUrls = await resolveUrls(client, material_urls);
+            }
+            catch (err) {
+                return {
+                    content: [
+                        {
+                            type: "text",
+                            text: `Failed to process materials: ${err instanceof Error ? err.message : String(err)}`,
+                        },
+                    ],
+                    isError: true,
+                };
+            }
+        }
+        const body = {
+            project_id,
+            content,
+            options: {
+                ratio,
+                ...(brand_id ? { brand_id } : {}),
+            },
+        };
+        if (resolvedUrls?.length)
+            body.material_urls = resolvedUrls;
+        const resp = await client.post("/public/project/message/send", body);
+        if (resp.code !== 0 || !resp.data) {
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        }
+        const matInfo = resolvedUrls?.length
+            ? ` with ${resolvedUrls.length} material(s)`
+            : "";
+        const brandInfo = brand_id ? ` (brand: ${brand_id})` : "";
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Message sent${matInfo}${brandInfo}, ratio: ${ratio}. Status: ${resp.data.status}\nUse watch_project to subscribe for updates, or poll with get_project_status.`,
+                },
+            ],
+        };
+    });
+    server.tool("pause_project", "Pause the currently running agent generation. Use when the user wants to stop the agent temporarily without losing progress.", { project_id: z.string(), run_id: z.string().optional() }, async ({ project_id, run_id }) => {
+        const resp = await client.post("/public/project/pause", {
+            project_id,
+            run_id: run_id ?? "",
+        });
+        if (resp.code !== 0)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Project paused. Use continue_project to resume.",
+                },
+            ],
+        };
+    });
+    server.tool("continue_project", "Resume a paused project. Use after pause_project or when the agent paused due to credits/approval. If paused for credits, ensure the account has been topped up first.", {
+        project_id: z.string(),
+        run_id: z.string().optional(),
+        should_remind: z
+            .boolean()
+            .optional()
+            .describe("Set to false to skip future pause reminders for this project"),
+    }, async ({ project_id, run_id, should_remind }) => {
+        const body = { project_id };
+        if (run_id)
+            body.run_id = run_id;
+        if (should_remind !== undefined)
+            body.should_remind = should_remind;
+        const resp = await client.post("/public/project/continue", body);
+        if (resp.code !== 0 || !resp.data)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Project resumed. Status: ${resp.data.status}\nPoll with get_project_status.`,
+                },
+            ],
+        };
+    });
+    server.tool("stop_project", "Stop a running or paused project completely. The project can be restarted later with send_message.", { project_id: z.string() }, async ({ project_id }) => {
+        const resp = await client.post("/public/project/stop", { project_id });
+        if (resp.code !== 0)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: "Project stopped. Use send_message to start a new run.",
+                },
+            ],
+        };
+    });
+    server.tool("list_messages", "Get conversation history for a project. Shows messages with role, content, materials, and tool calls.", {
+        project_id: z.string(),
+        page: z.number().optional(),
+        page_size: z.number().optional(),
+    }, async ({ project_id, page, page_size }) => {
+        const params = { project_id };
+        if (page)
+            params.page = String(page);
+        if (page_size)
+            params.page_size = String(page_size);
+        const resp = await client.get("/public/project/message/list", params);
+        if (resp.code !== 0)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const messages = resp.data ?? [];
+        if (messages.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No messages. Use send_message to start.",
+                    },
+                ],
+            };
+        }
+        const total = resp.page?.total_count ?? messages.length;
+        const lines = [`Page ${page ?? 1} (${total} total)\n`];
+        for (const msg of messages) {
+            const role = msg.role === "user" ? "[user]" : "[agent]";
+            const time = msg.created_at?.slice(11, 16) ?? "";
+            let line = `${time} ${role}`;
+            if (msg.event && msg.event !== "ClientProjectMessage")
+                line += ` (${msg.event})`;
+            if (msg.content) {
+                const preview = msg.content.length > 120
+                    ? `${msg.content.slice(0, 120)}...`
+                    : msg.content;
+                line += ` ${preview}`;
+            }
+            if (msg.tool?.name)
+                line += `\n  Tool: ${msg.tool.name}`;
+            if (msg.materials?.length) {
+                const counts = {};
+                for (const m of msg.materials)
+                    counts[m.type] = (counts[m.type] ?? 0) + 1;
+                line += `\n  Materials: ${Object.entries(counts)
+                    .map(([t, n]) => `${n} ${t}`)
+                    .join(", ")}`;
+            }
+            // Show pause reason if present
+            if (msg.event === "RunPaused" && msg.metadata) {
+                const reason = msg.metadata.reason;
+                if (reason)
+                    line += `\n  Pause reason: ${reason}`;
+            }
+            lines.push(line);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+    server.tool("get_project_materials", "Get all generated assets (videos, images, audio, documents). Use after generation completes to see deliverables.", { project_id: z.string() }, async ({ project_id }) => {
+        const resp = await client.get("/public/project/materials", {
+            project_id,
+        });
+        if (resp.code !== 0)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const materials = resp.data ?? [];
+        if (materials.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No materials yet. Check get_project_status for progress.",
+                    },
+                ],
+            };
+        }
+        const lines = [`${materials.length} material(s):\n`];
+        for (let i = 0; i < materials.length; i++) {
+            const m = materials[i];
+            let line = `${i + 1}. [${m.type}] ${m.url}`;
+            if (m.thumbnail)
+                line += `\n   Thumbnail: ${m.thumbnail}`;
+            if (m.display_title)
+                line += `\n   Title: ${m.display_title}`;
+            if (m.asset_category)
+                line += `\n   Category: ${m.asset_category}`;
+            lines.push(line);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+}
+//# sourceMappingURL=message.js.map

package/dist/tools/message.js.map

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

package/dist/tools/project.d.ts

@@ -0,0 +1,3 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SoldyAPIClient } from "../client.js";
+export declare function registerProjectTools(server: McpServer, client: SoldyAPIClient): void;

package/dist/tools/project.js

@@ -0,0 +1,240 @@
+import { z } from "zod";
+import { formatApiError } from "../errors.js";
+export function registerProjectTools(server, client) {
+    server.tool("create_project", "Create a conversation project. After creation, use send_message to start generating.", {
+        name: z.string(),
+        brand_id: z.string().optional(),
+        ratio: z
+            .enum(["9:16", "16:9", "1:1", "4:3", "3:4", "3:2", "2:3", "21:9"])
+            .optional()
+            .describe("Default video ratio. Can be overridden per message in send_message."),
+        description: z.string().optional(),
+    }, async ({ name, brand_id, ratio, description }) => {
+        const wsId = await client.getDefaultWorkspaceId();
+        const resp = await client.post("/public/project", {
+            name,
+            slug: name
+                .toLowerCase()
+                .replace(/\s+/g, "-")
+                .replace(/[^a-z0-9-]/g, ""),
+            description: description ?? "",
+            ratio: ratio ?? "9:16",
+            workspace_id: wsId,
+        });
+        if (resp.code !== 0 || !resp.data)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const p = resp.data;
+        // Link brand if provided
+        if (brand_id) {
+            await client
+                .post("/public/project/brand", { project_id: p.id, brand_id })
+                .catch(() => { });
+        }
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Project created: **${p.name}** (ID: \`${p.id}\`, status: ${p.status})\nUse send_message to start generating.\nWeb: https://soldy.ai/app/chat/${p.id}`,
+                },
+            ],
+        };
+    });
+    server.tool("get_project", "Get project details including name, status, ratio, brand, timestamps.", { project_id: z.string() }, async ({ project_id }) => {
+        const resp = await client.get("/public/project", {
+            id: project_id,
+        });
+        if (resp.code !== 0 || !resp.data)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const p = resp.data;
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `| Field | Value |\n|---|---|\n| ID | \`${p.id}\` |\n| Name | ${p.name} |\n| Status | ${p.status} |\n| Ratio | ${p.ratio} |\n| Created | ${p.created_at} |\n\nWeb: https://soldy.ai/app/chat/${p.id}`,
+                },
+            ],
+        };
+    });
+    server.tool("list_projects", "List all projects with status.", { page: z.number().optional(), page_size: z.number().optional() }, async ({ page, page_size }) => {
+        const wsId = await client.getDefaultWorkspaceId();
+        const params = { workspace_id: wsId };
+        if (page)
+            params.page = String(page);
+        if (page_size)
+            params.page_size = String(page_size);
+        const resp = await client.get("/public/project/list", params);
+        if (resp.code !== 0)
+            return {
+                content: [{ type: "text", text: formatApiError(resp) }],
+                isError: true,
+            };
+        const projects = resp.data ?? [];
+        if (projects.length === 0) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: "No projects yet. Use create_project to start.",
+                    },
+                ],
+            };
+        }
+        const total = resp.page?.total_count ?? projects.length;
+        const lines = [
+            `Total: ${total} (page ${page ?? 1})\n`,
+            "| Name | ID | Status | Created |",
+            "|---|---|---|---|",
+        ];
+        for (const p of projects) {
+            lines.push(`| ${p.name} | \`${p.id}\` | ${p.status} | ${p.created_at?.slice(0, 16)} |`);
+        }
+        return { content: [{ type: "text", text: lines.join("\n") }] };
+    });
+    server.tool("get_project_status", `Get project status and latest run activity.
+
+For long-running jobs, prefer watch_project(project_id) to subscribe for real-time status updates via resource notifications instead of polling this tool. You can also read the resource URI soldy://project/{project_id}/status directly.
+
+Status meanings:
+- ready: waiting for send_message
+- running: agent is processing
+- completed: generation finished — use get_project_materials or read soldy://project/{id}/materials
+- pause: agent paused (credits or approval needed) — use continue_project to resume
+- error: generation failed — use send_message to retry`, { project_id: z.string() }, async ({ project_id }) => {
+        const [projResp, msgResp] = await Promise.all([
+            client.get("/public/project", { id: project_id }),
+            client.get("/public/project/message/list", {
+                project_id,
+                page: "1",
+                page_size: "30",
+                sort: "created_at desc",
+            }),
+        ]);
+        if (projResp.code !== 0 || !projResp.data) {
+            return {
+                content: [{ type: "text", text: formatApiError(projResp) }],
+                isError: true,
+            };
+        }
+        const p = projResp.data;
+        const messages = msgResp.data ?? [];
+        let output = `**${p.name}** — Status: ${p.status}\n`;
+        // Add actionable guidance per status
+        switch (p.status) {
+            case "pause":
+                output += "⏸ Agent paused. Use continue_project to resume.\n";
+                break;
+            case "error":
+                output +=
+                    "❌ Generation failed. Use send_message to start a new run.\n";
+                break;
+            case "completed":
+                output +=
+                    "✅ Complete. Use get_project_materials to view results, or send_message to iterate.\n";
+                break;
+            case "running":
+                output += "⏳ Processing. Poll again in a few seconds.\n";
+                break;
+        }
+        if (messages.length > 0) {
+            let latestRunId = "";
+            for (const msg of messages) {
+                if (msg.run_id) {
+                    latestRunId = msg.run_id;
+                    break;
+                }
+            }
+            if (latestRunId) {
+                const runMsgs = messages
+                    .filter((m) => m.run_id === latestRunId)
+                    .reverse();
+                if (runMsgs.length > 0) {
+                    output += `\nLatest run (${runMsgs.length} events):\n`;
+                    for (const msg of runMsgs) {
+                        output += formatMessage(msg);
+                    }
+                }
+            }
+        }
+        output += `\nWeb: https://soldy.ai/app/chat/${project_id}`;
+        return { content: [{ type: "text", text: output }] };
+    });
+}
+const eventMap = {
+    RunStarted: "Started processing",
+    TeamRunStarted: "Started processing",
+    ToolCallStarted: "Tool",
+    ToolCallCompleted: "Tool completed",
+    TeamToolCallStarted: "Tool",
+    TeamToolCallCompleted: "Tool completed",
+    RunContent: "",
+    RunContentCompleted: "",
+    RunCompleted: "Generation complete",
+    TeamRunCompleted: "Generation complete",
+    RunError: "Error",
+    TeamRunError: "Error",
+    RunPaused: "⏸ Paused",
+    RunCancelled: "🚫 Cancelled",
+    AgentSystemError: "⚠️ System error",
+};
+function formatMessage(msg) {
+    const role = msg.role === "user" ? "[user]" : "[agent]";
+    // Tool call events
+    if (msg.event === "ToolCallStarted" || msg.event === "TeamToolCallStarted") {
+        const toolName = msg.tool?.name ?? "unknown";
+        return `  🔧 ${toolName}\n`;
+    }
+    if (msg.event === "ToolCallCompleted" ||
+        msg.event === "TeamToolCallCompleted") {
+        if (msg.content)
+            return `  ✓ ${msg.content.slice(0, 120)}\n`;
+        return "";
+    }
+    // Pause with reason
+    if (msg.event === "RunPaused") {
+        let pauseInfo = "⏸ Paused";
+        if (msg.metadata) {
+            const reason = msg.metadata.reason ?? msg.metadata.paused_reason;
+            if (reason)
+                pauseInfo += ` — ${reason}`;
+        }
+        return `${pauseInfo}\n  → Use continue_project to resume\n`;
+    }
+    // Status events
+    const mapped = eventMap[msg.event];
+    if (mapped === "") {
+        if (msg.content) {
+            const preview = msg.content.length > 200
+                ? `${msg.content.slice(0, 200)}...`
+                : msg.content;
+            return `${role} ${preview}\n`;
+        }
+        return "";
+    }
+    if (mapped) {
+        const extra = msg.content ? `: ${msg.content.slice(0, 100)}` : "";
+        return `${mapped}${extra}\n`;
+    }
+    // Materials
+    if (msg.materials?.length > 0) {
+        const counts = {};
+        for (const m of msg.materials)
+            counts[m.type] = (counts[m.type] ?? 0) + 1;
+        return `  📎 ${Object.entries(counts)
+            .map(([t, n]) => `${n} ${t}`)
+            .join(", ")}\n`;
+    }
+    if (msg.content) {
+        const preview = msg.content.length > 200
+            ? `${msg.content.slice(0, 200)}...`
+            : msg.content;
+        return `${role} ${preview}\n`;
+    }
+    return "";
+}
+//# sourceMappingURL=project.js.map

package/dist/tools/project.js.map

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

package/dist/tools/subscribe.d.ts

@@ -0,0 +1,12 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import type { SubscriptionBridge } from "../subscriptions.js";
+/**
+ * Registers subscription tools that expose MCP resource subscriptions
+ * as discoverable tools for agents.
+ *
+ * Agents can only see tools in the tool list — MCP resources and their
+ * subscribe capability are invisible at the tool level. These tools
+ * bridge that gap by letting agents subscribe to real-time updates
+ * instead of polling.
+ */
+export declare function registerSubscribeTools(server: McpServer, bridge: SubscriptionBridge): void;

package/dist/tools/subscribe.js

@@ -0,0 +1,74 @@
+import { z } from "zod";
+/**
+ * Registers subscription tools that expose MCP resource subscriptions
+ * as discoverable tools for agents.
+ *
+ * Agents can only see tools in the tool list — MCP resources and their
+ * subscribe capability are invisible at the tool level. These tools
+ * bridge that gap by letting agents subscribe to real-time updates
+ * instead of polling.
+ */
+export function registerSubscribeTools(server, bridge) {
+    server.tool("watch_project", `Subscribe to real-time updates for a project. Returns immediately and pushes notifications when project status, messages, or materials change.
+
+**Use this instead of polling get_project_status in a loop.** After calling watch_project, you will receive resource update notifications for:
+- \`soldy://project/{project_id}/status\` — when status changes (running → completed, paused, error)
+- \`soldy://project/{project_id}/messages\` — when new messages arrive
+- \`soldy://project/{project_id}/materials\` — when new assets are generated
+- \`soldy://project/{project_id}/runs/{run_id}/messages\` — per-run message updates
+- \`soldy://project/{project_id}/runs/{run_id}/materials\` — per-run material updates
+
+When you receive a notification, read the corresponding resource URI to get updated data.
+
+Typical flow: send_message → watch_project → wait for notifications → read resources when notified.`, {
+        project_id: z.string().describe("Project ID to watch for updates"),
+    }, async ({ project_id }) => {
+        try {
+            await bridge.subscribeProject(project_id);
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Watching project \`${project_id}\`. You will receive resource update notifications when status, messages, or materials change.\n\nAvailable resource URIs:\n- soldy://project/${project_id}/status\n- soldy://project/${project_id}/messages\n- soldy://project/${project_id}/materials`,
+                    },
+                ],
+            };
+        }
+        catch (err) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Failed to watch project: ${err instanceof Error ? err.message : String(err)}`,
+                    },
+                ],
+                isError: true,
+            };
+        }
+    });
+    server.tool("watch_brand_task", `Subscribe to real-time updates for a brand extraction task. Returns immediately and pushes notifications when task status changes.
+
+**Use this instead of polling get_brand_task_result in a loop.** After calling watch_brand_task, you will receive resource update notifications for:
+- \`soldy://brand/task/{task_id}\` — when task progress or status changes (running → finished/failed)
+
+When the task finishes, you will also receive notifications for:
+- \`soldy://brands\` — brand list updated with newly extracted brand
+- \`soldy://brand/{brand_id}\` — new brand details available
+
+Polling automatically stops when the task completes or fails.
+
+Typical flow: extract_brand → watch_brand_task → wait for notification → read resource to get brand_id.`, {
+        task_id: z.string().describe("Brand extraction task ID to watch"),
+    }, async ({ task_id }) => {
+        bridge.subscribeBrandTask(task_id);
+        return {
+            content: [
+                {
+                    type: "text",
+                    text: `Watching brand task \`${task_id}\`. You will receive a resource update notification when the extraction completes or fails.\n\nResource URI: soldy://brand/task/${task_id}`,
+                },
+            ],
+        };
+    });
+}
+//# sourceMappingURL=subscribe.js.map

package/dist/tools/subscribe.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"subscribe.js","sourceRoot":"","sources":["../../src/tools/subscribe.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;;;;;GAQG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAA0B;IAE1B,MAAM,CAAC,IAAI,CACT,eAAe,EACf;;;;;;;;;;;oGAWgG,EAChG;QACE,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,iCAAiC,CAAC;KACnE,EACD,KAAK,EAAE,EAAE,UAAU,EAAE,EAAE,EAAE;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,CAAC,gBAAgB,CAAC,UAAU,CAAC,CAAC;YAC1C,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,sBAAsB,UAAU,iJAAiJ,UAAU,8BAA8B,UAAU,gCAAgC,UAAU,YAAY;qBAChS;iBACF;aACF,CAAC;QACJ,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAe;wBACrB,IAAI,EAAE,4BAA4B,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE;qBACrF;iBACF;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;IACH,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,IAAI,CACT,kBAAkB,EAClB;;;;;;;;;;;wGAWoG,EACpG;QACE,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,mCAAmC,CAAC;KAClE,EACD,KAAK,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE;QACpB,MAAM,CAAC,kBAAkB,CAAC,OAAO,CAAC,CAAC;QACnC,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAe;oBACrB,IAAI,EAAE,yBAAyB,OAAO,mIAAmI,OAAO,EAAE;iBACnL;aACF;SACF,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,37 @@
+{
+  "name": "@soldy_ai/mcp",
+  "version": "0.1.6",
+  "description": "Soldy AI MCP Server — video ad generation via Claude Desktop, Cursor, Claude Code",
+  "type": "module",
+  "bin": {
+    "soldy-mcp": "./dist/index.js"
+  },
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "start": "node dist/index.js",
+    "pack:dist": "npm run build && npm pack --pack-destination ../web/public/mcp",
+    "lint": "biome check src/",
+    "lint:fix": "biome check --write src/"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "@types/node": "^22.0.0",
+    "typescript": "^5.7.0",
+    "zod": "^4.0.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.19.0"
+  },
+  "files": [
+    "dist",
+    "README.md"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/solgers/soldy-mcp.git"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}