katto-mcp 0.1.0

package/README.md

@@ -0,0 +1,40 @@
+# katto-mcp
+
+MCP server for [Katto](https://katto.tech) — turn long videos into scored, captioned 9:16 clips from any MCP client (Claude Desktop, Cursor, Claude Code, …).
+
+It runs locally over stdio and calls the Katto REST API with your key. Nothing to host.
+
+## Setup
+
+1. Create an API key at **[katto.tech/dashboard/api-keys](https://katto.tech/dashboard/api-keys)**.
+2. Add the server to your MCP client config:
+
+```json
+{
+  "mcpServers": {
+    "katto": {
+      "command": "npx",
+      "args": ["-y", "katto-mcp"],
+      "env": { "KATTO_API_KEY": "sk_live_..." }
+    }
+  }
+}
+```
+
+## Tools
+
+- **`katto_create_clip_job(url, config?)`** — submit a long video (YouTube, Twitch, Vimeo, Rumble, Zoom, Dailymotion). Returns a job id.
+- **`katto_get_job(id)`** — poll until `status` is `completed`; `clips` holds the finished MP4 + caption (SRT) urls.
+
+Jobs draw from your Katto plan's monthly video quota (25 on Creator, 2 on Free). Videos up to 90 minutes.
+
+## Env
+
+| var | required | default |
+| --- | --- | --- |
+| `KATTO_API_KEY` | yes | — |
+| `KATTO_API_URL` | no | `https://katto.tech` |
+
+Full docs: **[katto.tech/docs/api](https://katto.tech/docs/api)**
+
+MIT

package/index.mjs

@@ -0,0 +1,106 @@
+#!/usr/bin/env node
+/**
+ * Katto MCP server — exposes the Katto clipping API as MCP tools so agents
+ * (Claude, Cursor, ...) can turn long videos into scored 9:16 clips. Runs
+ * locally over stdio and calls https://katto.tech/api/v1 with your API key.
+ *
+ * Config:
+ *   KATTO_API_KEY  (required)  — create at https://katto.tech/dashboard/api-keys
+ *   KATTO_API_URL  (optional)  — defaults to https://katto.tech
+ */
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprotocol/sdk/types.js";
+
+const API_URL = (process.env.KATTO_API_URL || "https://katto.tech").replace(/\/$/, "");
+const API_KEY = process.env.KATTO_API_KEY;
+
+if (!API_KEY) {
+  console.error("[katto-mcp] KATTO_API_KEY is required. Create one at https://katto.tech/dashboard/api-keys");
+  process.exit(1);
+}
+
+async function api(path, init = {}) {
+  const res = await fetch(`${API_URL}${path}`, {
+    ...init,
+    headers: {
+      Authorization: `Bearer ${API_KEY}`,
+      "Content-Type": "application/json",
+      ...(init.headers || {}),
+    },
+  });
+  const text = await res.text();
+  let data;
+  try {
+    data = JSON.parse(text);
+  } catch {
+    data = { raw: text };
+  }
+  if (!res.ok) throw new Error(data.error || `HTTP ${res.status}`);
+  return data;
+}
+
+const TOOLS = [
+  {
+    name: "katto_create_clip_job",
+    description:
+      "Submit a long video (YouTube, Twitch, Vimeo, Rumble, Zoom, Dailymotion) to Katto. Returns a job id; " +
+      "the clips finish asynchronously in ~5-7 min. Poll katto_get_job with the id until status is 'completed'.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        url: { type: "string", description: "Public video URL to clip." },
+        config: {
+          type: "object",
+          description: "Optional pre-clip settings.",
+          properties: {
+            genre: { type: "string", description: "e.g. podcast, gaming, sports, interview" },
+            clipLength: { type: "string", enum: ["lt30", "30_60", "60_90", "90_180"] },
+            customPrompt: { type: "string" },
+            topics: { type: "string" },
+          },
+        },
+      },
+      required: ["url"],
+    },
+  },
+  {
+    name: "katto_get_job",
+    description:
+      "Get the status and clips of a Katto job by id. When status is 'completed', 'clips' holds the finished " +
+      "9:16 MP4 urls and caption (SRT) urls.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string", description: "Job id from katto_create_clip_job." } },
+      required: ["id"],
+    },
+  },
+];
+
+const server = new Server({ name: "katto", version: "0.1.0" }, { capabilities: { tools: {} } });
+
+server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
+
+server.setRequestHandler(CallToolRequestSchema, async (req) => {
+  const { name, arguments: args = {} } = req.params;
+  try {
+    let data;
+    if (name === "katto_create_clip_job") {
+      data = await api("/api/v1/jobs", {
+        method: "POST",
+        body: JSON.stringify({ url: args.url, config: args.config }),
+      });
+    } else if (name === "katto_get_job") {
+      data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}`);
+    } else {
+      throw new Error(`Unknown tool: ${name}`);
+    }
+    return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: `Error: ${e.message}` }], isError: true };
+  }
+});
+
+const transport = new StdioServerTransport();
+await server.connect(transport);
+console.error("[katto-mcp] ready");

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "katto-mcp",
+  "version": "0.1.0",
+  "description": "MCP server for Katto — turn long videos into scored, captioned 9:16 clips from any MCP client (Claude, Cursor, ...).",
+  "type": "module",
+  "bin": {
+    "katto-mcp": "index.mjs"
+  },
+  "files": [
+    "index.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=18"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "katto",
+    "video",
+    "clips",
+    "shorts",
+    "ai"
+  ],
+  "homepage": "https://katto.tech/docs/api",
+  "license": "MIT",
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}