vugola-mcp 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Vadim Strizheus
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,108 @@
+# vugola-mcp
+
+Official MCP server for [Vugola](https://www.vugolaai.com) — the AI video clipping tool.
+
+Let Claude (or any MCP-capable agent) clip videos, check your credits, and schedule posts on your Vugola account.
+
+---
+
+## Requires
+
+- Node.js 20 or higher.
+- A paid Vugola account. Generate a key at [vugolaai.com/dashboard/api-key](https://www.vugolaai.com/dashboard/api-key).
+
+---
+
+## Install
+
+Drop one block into your agent's MCP config. Every block below pins to version `1.0.0` on purpose — always pin a specific version, never install "latest."
+
+### Claude Desktop
+
+Open `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\Claude\claude_desktop_config.json` (Windows) and add:
+
+```json
+{
+  "mcpServers": {
+    "vugola": {
+      "command": "npx",
+      "args": ["-y", "vugola-mcp@1.0.0"],
+      "env": { "VUGOLA_API_KEY": "vug_sk_your_key_here" }
+    }
+  }
+}
+```
+
+Restart Claude Desktop.
+
+### Claude Code
+
+```bash
+claude mcp add vugola -- npx -y vugola-mcp@1.0.0
+```
+
+Then export your key in your shell or `.env`:
+
+```bash
+export VUGOLA_API_KEY=vug_sk_your_key_here
+```
+
+### Cursor / Cline
+
+Same JSON shape as Claude Desktop. Paste the block above into each client's MCP config file.
+
+---
+
+## Tools
+
+### `clip_video`
+
+Start a clipping job. Takes 20–40 minutes. Vugola emails you when it's done.
+
+Inputs: `video_url`, `aspect_ratio` (`9:16` | `16:9` | `1:1`), `caption_style` (`none` | `highlighted` | `scale` | `minimalist` | `box`).
+
+### `get_clip_status`
+
+Check a running job. Agent calls this when you ask "is that clip done?"
+
+Inputs: `job_id`.
+
+### `get_usage`
+
+Show credits remaining, monthly usage, and plan.
+
+No inputs.
+
+### `schedule_post`
+
+Schedule one or more social posts. Supports x, instagram, tiktok, youtube, facebook, linkedin, threads, bluesky. Instagram carousels supported with 2–10 items.
+
+Inputs: `posts[]` (max 25 per call). See the tool description for full fields.
+
+---
+
+## Security
+
+- **Never commit your `VUGOLA_API_KEY`.** Your agent's config file contains a secret. Add it to `.gitignore`, or use a secrets manager (1Password CLI, direnv) instead of inline env vars.
+- **Always pin the version** (`vugola-mcp@1.0.0`) in your install. Don't install "latest."
+- If you accidentally leak your key, regenerate it at [vugolaai.com/dashboard/api-key](https://www.vugolaai.com/dashboard/api-key) immediately.
+- Download URLs returned by `get_clip_status` require the same `Authorization: Bearer <key>` header and expire in ~1 hour. Save clips promptly or re-fetch the status before downloading.
+
+---
+
+## Pricing
+
+This MCP requires a paid Vugola account (Creator plan or above). See [pricing](https://www.vugolaai.com/pricing).
+
+---
+
+## Links
+
+- Vugola: https://www.vugolaai.com
+- Dashboard: https://www.vugolaai.com/dashboard/api-key
+
+---
+
+## License
+
+MIT © 2026 Vadim Strizheus

package/dist/client.d.ts

@@ -0,0 +1,25 @@
+export interface ClientConfig {
+    baseUrl: string;
+    apiKey: string;
+    fetch?: typeof fetch;
+}
+export interface RequestOptions {
+    method: "GET" | "POST" | "DELETE";
+    body?: unknown;
+    timeoutMs: number;
+    retryIdempotent: boolean;
+    retryDelayMs?: number;
+}
+export type RequestResult = {
+    ok: true;
+    httpStatus: number;
+    body: unknown;
+} | {
+    ok: false;
+    httpStatus: number;
+    body: unknown;
+};
+export interface Client {
+    request(path: string, opts: RequestOptions): Promise<RequestResult>;
+}
+export declare function createClient(cfg: ClientConfig): Client;

package/dist/client.js

@@ -0,0 +1,57 @@
+export function createClient(cfg) {
+    const fetchFn = cfg.fetch ?? fetch;
+    async function doRequest(path, opts) {
+        if (!cfg.apiKey) {
+            throw new Error("VUGOLA_API_KEY not set");
+        }
+        const controller = new AbortController();
+        const timeout = setTimeout(() => controller.abort(), opts.timeoutMs);
+        try {
+            const headers = {
+                Authorization: `Bearer ${cfg.apiKey}`,
+            };
+            const init = {
+                method: opts.method,
+                headers,
+                signal: controller.signal,
+            };
+            if (opts.body !== undefined) {
+                headers["content-type"] = "application/json";
+                init.body = JSON.stringify(opts.body);
+            }
+            const res = await fetchFn(cfg.baseUrl + path, init);
+            const text = await res.text();
+            let body = {};
+            if (text.length > 0) {
+                try {
+                    body = JSON.parse(text);
+                }
+                catch {
+                    body = { raw: text.slice(0, 500) };
+                }
+            }
+            return {
+                ok: res.ok,
+                httpStatus: res.status,
+                body,
+            };
+        }
+        finally {
+            clearTimeout(timeout);
+        }
+    }
+    return {
+        async request(path, opts) {
+            const first = await doRequest(path, opts);
+            if (first.ok)
+                return first;
+            const isRetryable5xx = first.httpStatus >= 500 && first.httpStatus < 600;
+            if (opts.retryIdempotent && opts.method === "GET" && isRetryable5xx) {
+                await new Promise((r) => setTimeout(r, opts.retryDelayMs ?? 3000));
+                return doRequest(path, opts);
+            }
+            return first;
+        },
+    };
+}
+//# sourceMappingURL=client.js.map

package/dist/client.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.js","sourceRoot":"","sources":["../src/client.ts"],"names":[],"mappings":"AAsBA,MAAM,UAAU,YAAY,CAAC,GAAiB;IAC5C,MAAM,OAAO,GAAG,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC;IAEnC,KAAK,UAAU,SAAS,CACtB,IAAY,EACZ,IAAoB;QAEpB,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,IAAI,KAAK,CAAC,wBAAwB,CAAC,CAAC;QAC5C,CAAC;QACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;QACzC,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,UAAU,CAAC,KAAK,EAAE,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC;QACrE,IAAI,CAAC;YACH,MAAM,OAAO,GAA2B;gBACtC,aAAa,EAAE,UAAU,GAAG,CAAC,MAAM,EAAE;aACtC,CAAC;YACF,MAAM,IAAI,GAAgB;gBACxB,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,OAAO;gBACP,MAAM,EAAE,UAAU,CAAC,MAAM;aAC1B,CAAC;YACF,IAAI,IAAI,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;gBAC5B,OAAO,CAAC,cAAc,CAAC,GAAG,kBAAkB,CAAC;gBAC7C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACxC,CAAC;YACD,MAAM,GAAG,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,OAAO,GAAG,IAAI,EAAE,IAAI,CAAC,CAAC;YACpD,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;YAC9B,IAAI,IAAI,GAAY,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;gBAC1B,CAAC;gBAAC,MAAM,CAAC;oBACP,IAAI,GAAG,EAAE,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,GAAG,CAAC,EAAE,CAAC;gBACrC,CAAC;YACH,CAAC;YACD,OAAO;gBACL,EAAE,EAAE,GAAG,CAAC,EAAE;gBACV,UAAU,EAAE,GAAG,CAAC,MAAM;gBACtB,IAAI;aACL,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,OAAO,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IAED,OAAO;QACL,KAAK,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI;YACtB,MAAM,KAAK,GAAG,MAAM,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC1C,IAAI,KAAK,CAAC,EAAE;gBAAE,OAAO,KAAK,CAAC;YAC3B,MAAM,cAAc,GAAG,KAAK,CAAC,UAAU,IAAI,GAAG,IAAI,KAAK,CAAC,UAAU,GAAG,GAAG,CAAC;YACzE,IAAI,IAAI,CAAC,eAAe,IAAI,IAAI,CAAC,MAAM,KAAK,KAAK,IAAI,cAAc,EAAE,CAAC;gBACpE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,UAAU,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC;gBACnE,OAAO,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;YAC/B,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/errors.d.ts

@@ -0,0 +1,2 @@
+export declare function translateHttpError(status: number, body: unknown): string;
+export declare function translateNetworkError(err: unknown): string;

package/dist/errors.js

@@ -0,0 +1,51 @@
+const DASHBOARD = "https://www.vugolaai.com/dashboard/api-key";
+const PRICING = "https://www.vugolaai.com/pricing";
+const KNOWN_400_CODES = {
+    video_too_short: "Videos must be at least 2 minutes long.",
+    video_too_long: "Videos must be 3 hours or shorter.",
+    invalid_url: "That video URL isn't supported.",
+    missing_fields: "Vugola rejected the request. A required field was missing.",
+    invalid_aspect_ratio: "aspect_ratio must be one of: 9:16, 16:9, 1:1.",
+    invalid_caption_style: "caption_style must be one of: none, highlighted, scale, minimalist, box.",
+};
+export function translateHttpError(status, body) {
+    const errObj = (body && typeof body === "object" ? body : {});
+    const code = typeof errObj.error === "string" ? errObj.error : "";
+    switch (status) {
+        case 401:
+            return `Your API key was rejected. Check or regenerate it at ${DASHBOARD}`;
+        case 402:
+            return `Out of credits. They may have been used by another session. Upgrade or top up at ${PRICING}`;
+        case 403:
+            return `Your Vugola plan doesn't include this feature. See ${PRICING} for plans.`;
+        case 404:
+            return "Job or post not found. The ID may be wrong or the job may have been deleted.";
+        case 408:
+            return "Vugola took too long to respond. Try again shortly.";
+        case 429:
+            return "Vugola rate limit hit. Try again in about a minute.";
+        case 400: {
+            const canned = KNOWN_400_CODES[code];
+            if (canned)
+                return canned;
+            return "Vugola rejected the request. Check the input and try again.";
+        }
+        case 500:
+        case 502:
+        case 503:
+        case 504:
+            return "Vugola is having a temporary problem. Try again in a few minutes.";
+        default:
+            return `Vugola returned an unexpected response (status ${status}). Try again shortly.`;
+    }
+}
+export function translateNetworkError(err) {
+    if (err &&
+        typeof err === "object" &&
+        "name" in err &&
+        err.name === "AbortError") {
+        return "Vugola took too long to respond. Try again shortly.";
+    }
+    return "Couldn't reach Vugola. Check your internet connection.";
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,MAAM,SAAS,GAAG,4CAA4C,CAAC;AAC/D,MAAM,OAAO,GAAG,kCAAkC,CAAC;AAEnD,MAAM,eAAe,GAA2B;IAC9C,eAAe,EAAE,yCAAyC;IAC1D,cAAc,EAAE,oCAAoC;IACpD,WAAW,EAAE,iCAAiC;IAC9C,cAAc,EAAE,4DAA4D;IAC5E,oBAAoB,EAAE,+CAA+C;IACrE,qBAAqB,EACnB,0EAA0E;CAC7E,CAAC;AAEF,MAAM,UAAU,kBAAkB,CAAC,MAAc,EAAE,IAAa;IAC9D,MAAM,MAAM,GAAG,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAE3D,CAAC;IACF,MAAM,IAAI,GAAG,OAAO,MAAM,CAAC,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;IAElE,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,GAAG;YACN,OAAO,wDAAwD,SAAS,EAAE,CAAC;QAC7E,KAAK,GAAG;YACN,OAAO,oFAAoF,OAAO,EAAE,CAAC;QACvG,KAAK,GAAG;YACN,OAAO,sDAAsD,OAAO,aAAa,CAAC;QACpF,KAAK,GAAG;YACN,OAAO,8EAA8E,CAAC;QACxF,KAAK,GAAG;YACN,OAAO,qDAAqD,CAAC;QAC/D,KAAK,GAAG;YACN,OAAO,qDAAqD,CAAC;QAC/D,KAAK,GAAG,CAAC,CAAC,CAAC;YACT,MAAM,MAAM,GAAG,eAAe,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,MAAM;gBAAE,OAAO,MAAM,CAAC;YAC1B,OAAO,6DAA6D,CAAC;QACvE,CAAC;QACD,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG,CAAC;QACT,KAAK,GAAG;YACN,OAAO,mEAAmE,CAAC;QAC7E;YACE,OAAO,kDAAkD,MAAM,uBAAuB,CAAC;IAC3F,CAAC;AACH,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,GAAY;IAChD,IACE,GAAG;QACH,OAAO,GAAG,KAAK,QAAQ;QACvB,MAAM,IAAI,GAAG;QACZ,GAAyB,CAAC,IAAI,KAAK,YAAY,EAChD,CAAC;QACD,OAAO,qDAAqD,CAAC;IAC/D,CAAC;IACD,OAAO,wDAAwD,CAAC;AAClE,CAAC"}

package/dist/index.d.ts

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

package/dist/index.js

@@ -0,0 +1,86 @@
+#!/usr/bin/env node
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { CallToolRequestSchema, ListToolsRequestSchema, } from "@modelcontextprotocol/sdk/types.js";
+import { zodToJsonSchema } from "zod-to-json-schema";
+import { createClient } from "./client.js";
+import { createRateLimiter } from "./rate-limit.js";
+import { createClipVideoTool } from "./tools/clip-video.js";
+import { createGetClipStatusTool } from "./tools/get-clip-status.js";
+import { createGetUsageTool } from "./tools/get-usage.js";
+import { createSchedulePostTool } from "./tools/schedule-post.js";
+const MISSING_KEY_MSG = "Set VUGOLA_API_KEY in your MCP config. Get one at https://www.vugolaai.com/dashboard/api-key";
+function lastFour(s) {
+    return s.slice(-4);
+}
+async function main() {
+    const apiKey = process.env["VUGOLA_API_KEY"] ?? "";
+    if (!apiKey) {
+        process.stderr.write("[vugola-mcp] VUGOLA_API_KEY not set — tools will return a setup message.\n");
+    }
+    else {
+        process.stderr.write(`[vugola-mcp] ready — key loaded (last 4: ...${lastFour(apiKey)})\n`);
+    }
+    const client = createClient({
+        baseUrl: "https://api.vugolaai.com",
+        apiKey,
+    });
+    const rateLimiter = createRateLimiter({
+        clip_video: { max: 5, windowMs: 60_000 },
+        schedule_post: { max: 10, windowMs: 60_000 },
+        get_clip_status: { max: 30, windowMs: 60_000 },
+        get_usage: { max: 30, windowMs: 60_000 },
+    });
+    const tools = [
+        createClipVideoTool({ client, rateLimiter }),
+        createGetClipStatusTool({ client, rateLimiter }),
+        createGetUsageTool({ client, rateLimiter }),
+        createSchedulePostTool({ client, rateLimiter }),
+    ];
+    const byName = new Map(tools.map((t) => [t.name, t]));
+    const server = new Server({ name: "vugola-mcp", version: "1.0.0" }, { capabilities: { tools: {} } });
+    server.setRequestHandler(ListToolsRequestSchema, async () => ({
+        tools: tools.map((t) => ({
+            name: t.name,
+            description: t.description,
+            inputSchema: zodToJsonSchema(t.inputSchema),
+        })),
+    }));
+    server.setRequestHandler(CallToolRequestSchema, async (req) => {
+        if (!apiKey) {
+            return { content: [{ type: "text", text: MISSING_KEY_MSG }] };
+        }
+        const tool = byName.get(req.params.name);
+        if (!tool) {
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Unknown tool: ${req.params.name}`,
+                    },
+                ],
+            };
+        }
+        try {
+            return await tool.handler((req.params.arguments ?? {}));
+        }
+        catch (err) {
+            const msg = err instanceof Error ? err.message : "Invalid arguments for this tool.";
+            return {
+                content: [
+                    {
+                        type: "text",
+                        text: `Invalid input: ${msg}`,
+                    },
+                ],
+            };
+        }
+    });
+    const transport = new StdioServerTransport();
+    await server.connect(transport);
+}
+main().catch((err) => {
+    process.stderr.write(`[vugola-mcp] fatal error: ${err instanceof Error ? err.message : String(err)}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/rate-limit.d.ts

@@ -0,0 +1,14 @@
+export interface BucketConfig {
+    max: number;
+    windowMs: number;
+}
+export type RateLimitResult = {
+    allowed: true;
+} | {
+    allowed: false;
+    retryAfterMs: number;
+};
+export interface RateLimiter {
+    check(tool: string): RateLimitResult;
+}
+export declare function createRateLimiter(config: Record<string, BucketConfig>): RateLimiter;

package/dist/rate-limit.js

@@ -0,0 +1,22 @@
+export function createRateLimiter(config) {
+    const history = {};
+    return {
+        check(tool) {
+            const cfg = config[tool];
+            if (!cfg)
+                return { allowed: true };
+            const now = Date.now();
+            const cutoff = now - cfg.windowMs;
+            const calls = (history[tool] ??= []);
+            while (calls.length > 0 && calls[0] < cutoff)
+                calls.shift();
+            if (calls.length >= cfg.max) {
+                const oldest = calls[0];
+                return { allowed: false, retryAfterMs: oldest + cfg.windowMs - now };
+            }
+            calls.push(now);
+            return { allowed: true };
+        },
+    };
+}
+//# sourceMappingURL=rate-limit.js.map

package/dist/rate-limit.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"rate-limit.js","sourceRoot":"","sources":["../src/rate-limit.ts"],"names":[],"mappings":"AAaA,MAAM,UAAU,iBAAiB,CAC/B,MAAoC;IAEpC,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,OAAO;QACL,KAAK,CAAC,IAAY;YAChB,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC;YACzB,IAAI,CAAC,GAAG;gBAAE,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;YACnC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YACvB,MAAM,MAAM,GAAG,GAAG,GAAG,GAAG,CAAC,QAAQ,CAAC;YAClC,MAAM,KAAK,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;YACrC,OAAO,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,CAAC,CAAE,GAAG,MAAM;gBAAE,KAAK,CAAC,KAAK,EAAE,CAAC;YAC7D,IAAI,KAAK,CAAC,MAAM,IAAI,GAAG,CAAC,GAAG,EAAE,CAAC;gBAC5B,MAAM,MAAM,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;gBACzB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,YAAY,EAAE,MAAM,GAAG,GAAG,CAAC,QAAQ,GAAG,GAAG,EAAE,CAAC;YACvE,CAAC;YACD,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YAChB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC;QAC3B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/sanitize.d.ts

@@ -0,0 +1,4 @@
+export interface SanitizeOptions {
+    maxLength: number;
+}
+export declare function sanitize(input: unknown, opts: SanitizeOptions): string;

package/dist/sanitize.js

@@ -0,0 +1,18 @@
+const INJECTION_PATTERN = /^(ignore|forget|system:|assistant:|user:|new instructions?)/im;
+export function sanitize(input, opts) {
+    if (input === null || input === undefined)
+        return "";
+    const str = typeof input === "string" ? input : String(input);
+    if (INJECTION_PATTERN.test(str)) {
+        return "<content-suppressed: possible injection>";
+    }
+    const escaped = str
+        .replace(/&/g, "&amp;")
+        .replace(/</g, "&lt;")
+        .replace(/>/g, "&gt;");
+    if (escaped.length > opts.maxLength) {
+        return escaped.slice(0, opts.maxLength) + "…";
+    }
+    return escaped;
+}
+//# sourceMappingURL=sanitize.js.map

package/dist/sanitize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sanitize.js","sourceRoot":"","sources":["../src/sanitize.ts"],"names":[],"mappings":"AAAA,MAAM,iBAAiB,GAAG,+DAA+D,CAAC;AAM1F,MAAM,UAAU,QAAQ,CAAC,KAAc,EAAE,IAAqB;IAC5D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS;QAAE,OAAO,EAAE,CAAC;IACrD,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9D,IAAI,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,0CAA0C,CAAC;IACpD,CAAC;IAED,MAAM,OAAO,GAAG,GAAG;SAChB,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC;SACtB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC;SACrB,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;IAEzB,IAAI,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;QACpC,OAAO,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,CAAC;IAChD,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/tools/clip-video.d.ts

@@ -0,0 +1,44 @@
+import { z } from "zod";
+import type { Client } from "../client.js";
+import type { RateLimiter } from "../rate-limit.js";
+export interface ToolDeps {
+    client: Client;
+    rateLimiter: RateLimiter;
+}
+declare const InputSchema: z.ZodObject<{
+    video_url: z.ZodString;
+    aspect_ratio: z.ZodEnum<["9:16", "16:9", "1:1"]>;
+    caption_style: z.ZodEnum<["none", "highlighted", "scale", "minimalist", "box"]>;
+}, "strict", z.ZodTypeAny, {
+    video_url: string;
+    aspect_ratio: "9:16" | "16:9" | "1:1";
+    caption_style: "none" | "highlighted" | "scale" | "minimalist" | "box";
+}, {
+    video_url: string;
+    aspect_ratio: "9:16" | "16:9" | "1:1";
+    caption_style: "none" | "highlighted" | "scale" | "minimalist" | "box";
+}>;
+export declare function createClipVideoTool(deps: ToolDeps): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        video_url: z.ZodString;
+        aspect_ratio: z.ZodEnum<["9:16", "16:9", "1:1"]>;
+        caption_style: z.ZodEnum<["none", "highlighted", "scale", "minimalist", "box"]>;
+    }, "strict", z.ZodTypeAny, {
+        video_url: string;
+        aspect_ratio: "9:16" | "16:9" | "1:1";
+        caption_style: "none" | "highlighted" | "scale" | "minimalist" | "box";
+    }, {
+        video_url: string;
+        aspect_ratio: "9:16" | "16:9" | "1:1";
+        caption_style: "none" | "highlighted" | "scale" | "minimalist" | "box";
+    }>;
+    handler(input: z.infer<typeof InputSchema>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};

package/dist/tools/clip-video.js

@@ -0,0 +1,75 @@
+import { z } from "zod";
+import { sanitize } from "../sanitize.js";
+import { translateHttpError, translateNetworkError } from "../errors.js";
+const InputSchema = z
+    .object({
+    video_url: z.string().min(1).max(2048),
+    aspect_ratio: z.enum(["9:16", "16:9", "1:1"]),
+    caption_style: z.enum([
+        "none",
+        "highlighted",
+        "scale",
+        "minimalist",
+        "box",
+    ]),
+})
+    .strict();
+const RATE_LIMIT_MSG = "You're calling Vugola too quickly. Wait a moment and try again.";
+export function createClipVideoTool(deps) {
+    return {
+        name: "clip_video",
+        description: "Start a video-clipping job. Ask the user for aspect_ratio and caption_style if they're not given. If the user says 'just pick,' default to aspect_ratio '9:16' and caption_style 'minimalist'. Videos must be 2–180 minutes long. Jobs take 20–40 minutes; Vugola will email the user when done, and the agent can check status via get_clip_status.",
+        inputSchema: InputSchema,
+        async handler(input) {
+            InputSchema.parse(input);
+            const rl = deps.rateLimiter.check("clip_video");
+            if (!rl.allowed) {
+                return { content: [{ type: "text", text: RATE_LIMIT_MSG }] };
+            }
+            try {
+                const res = await deps.client.request("/clip", {
+                    method: "POST",
+                    body: {
+                        video_url: input.video_url,
+                        aspect_ratio: input.aspect_ratio,
+                        caption_style: input.caption_style,
+                    },
+                    timeoutMs: 15_000,
+                    retryIdempotent: false, // explicit: POST /clip never retries
+                });
+                if (!res.ok) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: translateHttpError(res.httpStatus, res.body),
+                            },
+                        ],
+                    };
+                }
+                const body = res.body;
+                const jobId = sanitize(body.job_id, { maxLength: 64 });
+                const payload = {
+                    job_id: jobId,
+                    status: "processing",
+                    estimated_minutes: 30,
+                    notification: {
+                        channel: "email",
+                        expected_within_minutes: 40,
+                    },
+                    message: "Job started. Vugola will email you when the clips are ready (usually 20-40 minutes). You can also ask me to check the status.",
+                    next_action_hint: `To check progress, call get_clip_status with job_id "${jobId}".`,
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(payload) }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: translateNetworkError(err) }],
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=clip-video.js.map

package/dist/tools/clip-video.js.map

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

package/dist/tools/get-clip-status.d.ts

@@ -0,0 +1,32 @@
+import { z } from "zod";
+import type { Client } from "../client.js";
+import type { RateLimiter } from "../rate-limit.js";
+export interface ToolDeps {
+    client: Client;
+    rateLimiter: RateLimiter;
+}
+declare const InputSchema: z.ZodObject<{
+    job_id: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    job_id: string;
+}, {
+    job_id: string;
+}>;
+export declare function createGetClipStatusTool(deps: ToolDeps): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        job_id: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        job_id: string;
+    }, {
+        job_id: string;
+    }>;
+    handler(input: z.infer<typeof InputSchema>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};

package/dist/tools/get-clip-status.js

@@ -0,0 +1,95 @@
+import { z } from "zod";
+import { sanitize } from "../sanitize.js";
+import { translateHttpError, translateNetworkError } from "../errors.js";
+const InputSchema = z
+    .object({
+    job_id: z.string().min(1).max(64),
+})
+    .strict();
+const RATE_LIMIT_MSG = "You're calling Vugola too quickly. Wait a moment and try again.";
+const DOWNLOAD_NOTE = "Download URLs require the same Authorization: Bearer header as other calls. They're valid for approximately 1 hour after completion — save clips promptly.";
+export function createGetClipStatusTool(deps) {
+    return {
+        name: "get_clip_status",
+        description: "Check whether a clipping job is done. Call this when the user asks about a job they've already started.",
+        inputSchema: InputSchema,
+        async handler(input) {
+            InputSchema.parse(input);
+            const rl = deps.rateLimiter.check("get_clip_status");
+            if (!rl.allowed) {
+                return { content: [{ type: "text", text: RATE_LIMIT_MSG }] };
+            }
+            try {
+                const res = await deps.client.request(`/clip/${encodeURIComponent(input.job_id)}`, {
+                    method: "GET",
+                    timeoutMs: 10_000,
+                    retryIdempotent: true,
+                });
+                if (!res.ok) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: translateHttpError(res.httpStatus, res.body),
+                            },
+                        ],
+                    };
+                }
+                const body = res.body;
+                const status = body.status;
+                if (status === "processing") {
+                    const out = {
+                        job_id: sanitize(body.job_id, { maxLength: 64 }),
+                        status: "processing",
+                        progress_percent: typeof body.progress === "number" ? body.progress : 0,
+                        clips_ready: typeof body.clips_ready === "number" ? body.clips_ready : 0,
+                        clips_total: typeof body.clips_total === "number" ? body.clips_total : 0,
+                    };
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(out) }],
+                    };
+                }
+                if (status === "complete") {
+                    const rawClips = Array.isArray(body.clips) ? body.clips : [];
+                    const clips = rawClips.map((c) => {
+                        const clip = c;
+                        return {
+                            clip_id: sanitize(clip.clip_id, { maxLength: 64 }),
+                            title: sanitize(clip.title, { maxLength: 200 }),
+                            duration_seconds: typeof clip.duration === "number" ? clip.duration : 0,
+                            virality_score: typeof clip.virality_score === "number"
+                                ? clip.virality_score
+                                : 0,
+                            download_url: sanitize(clip.download_url, { maxLength: 2048 }),
+                        };
+                    });
+                    const out = {
+                        job_id: sanitize(body.job_id, { maxLength: 64 }),
+                        status: "complete",
+                        credits_used: typeof body.credits_used === "number" ? body.credits_used : 0,
+                        clips,
+                        download_note: DOWNLOAD_NOTE,
+                    };
+                    return {
+                        content: [{ type: "text", text: JSON.stringify(out) }],
+                    };
+                }
+                // failed or unexpected
+                const out = {
+                    job_id: sanitize(body.job_id, { maxLength: 64 }),
+                    status: "failed",
+                    error: sanitize(body.error, { maxLength: 500 }),
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(out) }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: translateNetworkError(err) }],
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=get-clip-status.js.map

package/dist/tools/get-clip-status.js.map

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

package/dist/tools/get-usage.d.ts

@@ -0,0 +1,20 @@
+import { z } from "zod";
+import type { Client } from "../client.js";
+import type { RateLimiter } from "../rate-limit.js";
+export interface ToolDeps {
+    client: Client;
+    rateLimiter: RateLimiter;
+}
+declare const InputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+export declare function createGetUsageTool(deps: ToolDeps): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{}, "strict", z.ZodTypeAny, {}, {}>;
+    handler(_input: z.infer<typeof InputSchema>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};

package/dist/tools/get-usage.js

@@ -0,0 +1,51 @@
+import { z } from "zod";
+import { translateHttpError, translateNetworkError } from "../errors.js";
+const InputSchema = z.object({}).strict();
+const RATE_LIMIT_MSG = "You're calling Vugola too quickly. Wait a moment and try again.";
+export function createGetUsageTool(deps) {
+    return {
+        name: "get_usage",
+        description: "Return how many credits the user has, their plan, and how many they've used this month.",
+        inputSchema: InputSchema,
+        async handler(_input) {
+            const rl = deps.rateLimiter.check("get_usage");
+            if (!rl.allowed) {
+                return { content: [{ type: "text", text: RATE_LIMIT_MSG }] };
+            }
+            try {
+                const res = await deps.client.request("/status", {
+                    method: "GET",
+                    timeoutMs: 8_000,
+                    retryIdempotent: true,
+                });
+                if (!res.ok) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: translateHttpError(res.httpStatus, res.body),
+                            },
+                        ],
+                    };
+                }
+                const body = res.body;
+                const payload = {
+                    credits_remaining: body.credits_remaining ?? 0,
+                    credits_total: body.credits_total ?? 0,
+                    credits_used_this_month: body.credits_used_this_month ?? 0,
+                    plan: body.plan ?? "unknown",
+                    as_of: new Date().toISOString(),
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(payload) }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: translateNetworkError(err) }],
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=get-usage.js.map

package/dist/tools/get-usage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-usage.js","sourceRoot":"","sources":["../../src/tools/get-usage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,OAAO,EAAE,kBAAkB,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AAOzE,MAAM,WAAW,GAAG,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC;AAE1C,MAAM,cAAc,GAClB,iEAAiE,CAAC;AAEpE,MAAM,UAAU,kBAAkB,CAAC,IAAc;IAC/C,OAAO;QACL,IAAI,EAAE,WAAW;QACjB,WAAW,EACT,yFAAyF;QAC3F,WAAW,EAAE,WAAW;QACxB,KAAK,CAAC,OAAO,CAAC,MAAmC;YAC/C,MAAM,EAAE,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC;YAC/C,IAAI,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC;gBAChB,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,cAAc,EAAE,CAAC,EAAE,CAAC;YACxE,CAAC;YACD,IAAI,CAAC;gBACH,MAAM,GAAG,GAAG,MAAM,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,SAAS,EAAE;oBAC/C,MAAM,EAAE,KAAK;oBACb,SAAS,EAAE,KAAK;oBAChB,eAAe,EAAE,IAAI;iBACtB,CAAC,CAAC;gBACH,IAAI,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC;oBACZ,OAAO;wBACL,OAAO,EAAE;4BACP;gCACE,IAAI,EAAE,MAAe;gCACrB,IAAI,EAAE,kBAAkB,CAAC,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC;6BACnD;yBACF;qBACF,CAAC;gBACJ,CAAC;gBACD,MAAM,IAAI,GAAG,GAAG,CAAC,IAKhB,CAAC;gBACF,MAAM,OAAO,GAAG;oBACd,iBAAiB,EAAE,IAAI,CAAC,iBAAiB,IAAI,CAAC;oBAC9C,aAAa,EAAE,IAAI,CAAC,aAAa,IAAI,CAAC;oBACtC,uBAAuB,EAAE,IAAI,CAAC,uBAAuB,IAAI,CAAC;oBAC1D,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,SAAS;oBAC5B,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,WAAW,EAAE;iBAChC,CAAC;gBACF,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE,CAAC;iBACpE,CAAC;YACJ,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO;oBACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAe,EAAE,IAAI,EAAE,qBAAqB,CAAC,GAAG,CAAC,EAAE,CAAC;iBACvE,CAAC;YACJ,CAAC;QACH,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/tools/schedule-post.d.ts

@@ -0,0 +1,278 @@
+import { z } from "zod";
+import type { Client } from "../client.js";
+import type { RateLimiter } from "../rate-limit.js";
+export interface ToolDeps {
+    client: Client;
+    rateLimiter: RateLimiter;
+}
+declare const InputSchema: z.ZodObject<{
+    posts: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+        platform: z.ZodEnum<["x", "instagram", "tiktok", "youtube", "facebook", "linkedin", "threads", "bluesky"]>;
+        post_type: z.ZodEnum<["single", "carousel", "text"]>;
+        caption: z.ZodString;
+        title: z.ZodOptional<z.ZodString>;
+        scheduled_at: z.ZodString;
+        media_url: z.ZodOptional<z.ZodString>;
+        asset_id: z.ZodOptional<z.ZodString>;
+        carousel_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            media_url: z.ZodOptional<z.ZodString>;
+            asset_id: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }, {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }>, "many">>;
+        platform_settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, "strict", z.ZodTypeAny, {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }, {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }>, {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }, {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }>, {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }, {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }>, "many">;
+}, "strict", z.ZodTypeAny, {
+    posts: {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }[];
+}, {
+    posts: {
+        platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+        post_type: "text" | "single" | "carousel";
+        caption: string;
+        scheduled_at: string;
+        title?: string | undefined;
+        media_url?: string | undefined;
+        asset_id?: string | undefined;
+        carousel_items?: {
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+        }[] | undefined;
+        platform_settings?: Record<string, unknown> | undefined;
+    }[];
+}>;
+export declare function createSchedulePostTool(deps: ToolDeps): {
+    name: string;
+    description: string;
+    inputSchema: z.ZodObject<{
+        posts: z.ZodArray<z.ZodEffects<z.ZodEffects<z.ZodObject<{
+            platform: z.ZodEnum<["x", "instagram", "tiktok", "youtube", "facebook", "linkedin", "threads", "bluesky"]>;
+            post_type: z.ZodEnum<["single", "carousel", "text"]>;
+            caption: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+            scheduled_at: z.ZodString;
+            media_url: z.ZodOptional<z.ZodString>;
+            asset_id: z.ZodOptional<z.ZodString>;
+            carousel_items: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                media_url: z.ZodOptional<z.ZodString>;
+                asset_id: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }, {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }>, "many">>;
+            platform_settings: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strict", z.ZodTypeAny, {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }, {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }>, {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }, {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }>, {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }, {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }>, "many">;
+    }, "strict", z.ZodTypeAny, {
+        posts: {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }[];
+    }, {
+        posts: {
+            platform: "x" | "instagram" | "tiktok" | "youtube" | "facebook" | "linkedin" | "threads" | "bluesky";
+            post_type: "text" | "single" | "carousel";
+            caption: string;
+            scheduled_at: string;
+            title?: string | undefined;
+            media_url?: string | undefined;
+            asset_id?: string | undefined;
+            carousel_items?: {
+                media_url?: string | undefined;
+                asset_id?: string | undefined;
+            }[] | undefined;
+            platform_settings?: Record<string, unknown> | undefined;
+        }[];
+    }>;
+    handler(input: z.infer<typeof InputSchema>): Promise<{
+        content: {
+            type: "text";
+            text: string;
+        }[];
+    }>;
+};
+export {};

package/dist/tools/schedule-post.js

@@ -0,0 +1,122 @@
+import { z } from "zod";
+import { sanitize } from "../sanitize.js";
+import { translateHttpError, translateNetworkError } from "../errors.js";
+const PlatformEnum = z.enum([
+    "x",
+    "instagram",
+    "tiktok",
+    "youtube",
+    "facebook",
+    "linkedin",
+    "threads",
+    "bluesky",
+]);
+const PostSchema = z
+    .object({
+    platform: PlatformEnum,
+    post_type: z.enum(["single", "carousel", "text"]),
+    caption: z.string().max(2200),
+    title: z.string().max(200).optional(),
+    scheduled_at: z.string().min(1).max(64),
+    media_url: z.string().max(2048).optional(),
+    asset_id: z.string().max(64).optional(),
+    carousel_items: z
+        .array(z.object({
+        media_url: z.string().max(2048).optional(),
+        asset_id: z.string().max(64).optional(),
+    }))
+        .min(2)
+        .max(10)
+        .optional(),
+    platform_settings: z.record(z.unknown()).optional(),
+})
+    .strict()
+    .refine((p) => p.post_type !== "carousel" || p.platform === "instagram", { message: "carousel post_type is only supported on instagram" })
+    .refine((p) => p.post_type !== "carousel" ||
+    (p.carousel_items && p.carousel_items.length >= 2), { message: "carousel requires 2-10 carousel_items" });
+const InputSchema = z
+    .object({
+    posts: z.array(PostSchema).min(1).max(25),
+})
+    .strict();
+const RATE_LIMIT_MSG = "You're calling Vugola too quickly. Wait a moment and try again.";
+export function createSchedulePostTool(deps) {
+    return {
+        name: "schedule_post",
+        description: "Schedule clips or media to post on supported social platforms. Ask the user for platform, post_type, caption, and scheduled_at if missing. Instagram carousels need 2-10 items. YouTube, TikTok, and Instagram single posts require media.",
+        inputSchema: InputSchema,
+        async handler(input) {
+            InputSchema.parse(input);
+            const rl = deps.rateLimiter.check("schedule_post");
+            if (!rl.allowed) {
+                return { content: [{ type: "text", text: RATE_LIMIT_MSG }] };
+            }
+            try {
+                const res = await deps.client.request("/schedule", {
+                    method: "POST",
+                    body: { posts: input.posts },
+                    timeoutMs: 15_000,
+                    retryIdempotent: false,
+                });
+                if (!res.ok) {
+                    return {
+                        content: [
+                            {
+                                type: "text",
+                                text: translateHttpError(res.httpStatus, res.body),
+                            },
+                        ],
+                    };
+                }
+                const body = res.body;
+                const posts = Array.isArray(body.posts) ? body.posts : [];
+                const scheduled = [];
+                const failed = [];
+                for (const p of posts) {
+                    const status = p.status;
+                    const platform = sanitize(p.platform, { maxLength: 32 });
+                    if (status === "scheduled" || status === "processing") {
+                        scheduled.push({
+                            id: sanitize(p.id, { maxLength: 64 }),
+                            platform,
+                            scheduled_at: sanitize(p.scheduled_at, { maxLength: 64 }),
+                        });
+                    }
+                    else {
+                        failed.push({
+                            platform,
+                            error: sanitize(p.failure_reason ?? p.error ?? "unknown error", { maxLength: 500 }),
+                        });
+                    }
+                }
+                const total = scheduled.length + failed.length;
+                const overall_status = failed.length === 0
+                    ? "all_scheduled"
+                    : scheduled.length === 0
+                        ? "all_failed"
+                        : "partial_failure";
+                const failedSummary = failed.length === 0
+                    ? ""
+                    : ` Failed: ${failed
+                        .map((f) => `${f.platform} (${f.error})`)
+                        .join(", ")}.`;
+                const summary = `Scheduled ${scheduled.length} of ${total} posts.${failedSummary}`;
+                const payload = {
+                    overall_status,
+                    summary,
+                    scheduled,
+                    failed,
+                };
+                return {
+                    content: [{ type: "text", text: JSON.stringify(payload) }],
+                };
+            }
+            catch (err) {
+                return {
+                    content: [{ type: "text", text: translateNetworkError(err) }],
+                };
+            }
+        },
+    };
+}
+//# sourceMappingURL=schedule-post.js.map

package/dist/tools/schedule-post.js.map

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

package/package.json

@@ -0,0 +1,51 @@
+{
+  "name": "vugola-mcp",
+  "version": "1.0.0",
+  "description": "Official MCP server for Vugola — AI video clipping for agents.",
+  "type": "module",
+  "main": "dist/index.js",
+  "bin": {
+    "vugola-mcp": "dist/index.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsx src/index.ts",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "smoke": "tsx scripts/test-client.ts",
+    "inject-probe": "tsx scripts/inject-probe.ts",
+    "prepublishOnly": "npm run build && npm test"
+  },
+  "engines": {
+    "node": ">=20.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "zod": "^3.23.0",
+    "zod-to-json-schema": "^3.25.2"
+  },
+  "devDependencies": {
+    "@types/node": "^20.11.0",
+    "tsx": "^4.7.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.4.0"
+  },
+  "keywords": [
+    "mcp",
+    "vugola",
+    "video",
+    "clipping",
+    "ai",
+    "agents"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/VCoder25/vugola-mcp.git"
+  },
+  "license": "MIT"
+}