katto-mcp 0.1.0 → 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Katto (https://katto.tech)
+
+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

@@ -1,6 +1,6 @@
 # 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, …).
+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, ChatGPT, …).
 
 It runs locally over stdio and calls the Katto REST API with your key. Nothing to host.
 
@@ -25,8 +25,12 @@ It runs locally over stdio and calls the Katto REST API with your key. Nothing t
 
 - **`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.
+- **`katto_list_jobs(limit?, cursor?, status?)`** — list your recent jobs, newest first (keyset pagination via `cursor`).
+- **`katto_get_clips(id)`** — just the finished clips of a job.
+- **`katto_get_transcript(id)`** — the job's timestamped transcript segments (`[{ start, end, text }]`).
+- **`katto_get_usage()`** — your plan and remaining monthly video quota.
 
-Jobs draw from your Katto plan's monthly video quota (25 on Creator, 2 on Free). Videos up to 90 minutes.
+Jobs draw from your Katto plan's monthly video quota (25 on Creator, 2 on Free). Videos up to 90 minutes. The underlying REST API also supports `Idempotency-Key` safe retries and read-only scoped keys — see the [docs](https://katto.tech/docs/api).
 
 ## Env
 

package/index.mjs

@@ -75,9 +75,51 @@ const TOOLS = [
       required: ["id"],
     },
   },
+  {
+    name: "katto_list_jobs",
+    description:
+      "List your recent Katto jobs, newest first. Paginate with 'cursor' (pass the previous next_cursor) and " +
+      "optionally filter by 'status'. Returns { jobs: [{id, status, source, created_at, completed_at}], next_cursor }.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        limit: { type: "number", description: "How many jobs to return (1-100, default 20)." },
+        cursor: { type: "string", description: "Pass the previous response's next_cursor for the next page." },
+        status: { type: "string", description: "Optional filter, e.g. 'completed', 'queued', 'failed'." },
+      },
+    },
+  },
+  {
+    name: "katto_get_clips",
+    description:
+      "Convenience: fetch just the finished clips of a job (9:16 MP4 urls + caption SRT urls). " +
+      "Returns an empty list while the job is still processing.",
+    inputSchema: {
+      type: "object",
+      properties: { id: { type: "string", description: "Job id from katto_create_clip_job." } },
+      required: ["id"],
+    },
+  },
+  {
+    name: "katto_get_usage",
+    description:
+      "Get your current plan and monthly video quota: { plan, videos_used, videos_limit, videos_remaining }.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "katto_get_transcript",
+    description:
+      "Get the compact transcript of a completed job as timestamped segments " +
+      "[{ start, end, text }]. Returns 404 while the job is still processing.",
+    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: {} } });
+const server = new Server({ name: "katto", version: "0.2.0" }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 
@@ -92,6 +134,20 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       });
     } else if (name === "katto_get_job") {
       data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}`);
+    } else if (name === "katto_list_jobs") {
+      const qs = new URLSearchParams();
+      if (args.limit != null) qs.set("limit", String(args.limit));
+      if (args.cursor) qs.set("cursor", String(args.cursor));
+      if (args.status) qs.set("status", String(args.status));
+      const q = qs.toString();
+      data = await api(`/api/v1/jobs${q ? `?${q}` : ""}`);
+    } else if (name === "katto_get_clips") {
+      const job = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}`);
+      data = { id: job.id, status: job.status, clips: job.clips || [] };
+    } else if (name === "katto_get_usage") {
+      data = await api("/api/v1/usage");
+    } else if (name === "katto_get_transcript") {
+      data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}/transcript`);
     } else {
       throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katto-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for Katto — turn long videos into scored, captioned 9:16 clips from any MCP client (Claude, Cursor, ...).",
   "type": "module",
   "bin": {
@@ -8,7 +8,8 @@
   },
   "files": [
     "index.mjs",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "engines": {
     "node": ">=18"
@@ -23,6 +24,9 @@
     "ai"
   ],
   "homepage": "https://katto.tech/docs/api",
+  "repository": { "type": "git", "url": "git+https://github.com/miracleweasel/katto-mcp.git" },
+  "bugs": { "url": "https://katto.tech/contact" },
+  "author": "Katto (https://katto.tech)",
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0"