katto-mcp 0.3.0 → 0.3.2

package/README.md

@@ -2,12 +2,19 @@
 
 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.
+Two ways to connect:
 
-## Setup
+## Hosted (zero-install, recommended)
 
-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:
+Point any OAuth-capable MCP client (ChatGPT, Claude web/desktop, MCP Inspector) at the hosted endpoint and sign in with your Katto account — the key never touches your disk, and you can revoke access anytime:
+
+```
+https://mcp.katto.tech/mcp   (Streamable HTTP · OAuth)
+```
+
+## Local (npx)
+
+For Cursor, CI and scripts. Create an API key at **[katto.tech/dashboard/api-keys](https://katto.tech/dashboard/api-keys)**, then add the server to your MCP client config:
 
 ```json
 {
@@ -21,6 +28,8 @@ It runs locally over stdio and calls the Katto REST API with your key. Nothing t
 }
 ```
 
+The hosted endpoint above also accepts `Authorization: Bearer sk_live_...` directly for key-based clients.
+
 ## Tools
 
 - **`katto_create_clip_job(url, config?)`** — submit a long video (YouTube, Twitch, Vimeo, Rumble, Zoom, Dailymotion). Returns a job id.
@@ -29,6 +38,8 @@ It runs locally over stdio and calls the Katto REST API with your key. Nothing t
 - **`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.
+- **`katto_cancel_job(id)`** — cancel a running job and refund the monthly video slot.
+- **`katto_get_account()`** — the connected account, this key's scopes, and quota.
 
 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).
 

package/index.mjs

@@ -135,9 +135,39 @@ const TOOLS = [
       "{ videos_used, videos_limit, videos_remaining }.",
     inputSchema: { type: "object", properties: {} },
   },
+  {
+    name: "katto_list_sources",
+    description:
+      "List the video platforms Katto can clip from, with an example URL for each. Use this to confirm a " +
+      "URL is supported before calling katto_create_clip_job.",
+    inputSchema: { type: "object", properties: {} },
+  },
+  {
+    name: "katto_list_clip_lengths",
+    description:
+      "List the valid values for the optional config.clipLength on katto_create_clip_job (target clip " +
+      "duration buckets).",
+    inputSchema: { type: "object", properties: {} },
+  },
+];
+
+// Static reference data — returned by the list_* tools without an API call.
+const SOURCES = [
+  { id: 'youtube', example: 'https://www.youtube.com/watch?v=dQw4w9WgXcQ' },
+  { id: 'twitch', example: 'https://www.twitch.tv/videos/123456789' },
+  { id: 'vimeo', example: 'https://vimeo.com/123456789' },
+  { id: 'rumble', example: 'https://rumble.com/v1a2b3c-title.html' },
+  { id: 'zoom', example: 'https://zoom.us/rec/share/abc123' },
+  { id: 'dailymotion', example: 'https://www.dailymotion.com/video/x8abcde' },
+];
+const CLIP_LENGTHS = [
+  { value: 'lt30', label: 'Under 30 seconds' },
+  { value: '30_60', label: '30 to 60 seconds' },
+  { value: '60_90', label: '60 to 90 seconds' },
+  { value: '90_180', label: '90 to 180 seconds' },
 ];
 
-const server = new Server({ name: "katto", version: "0.3.0" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "katto", version: "0.3.2" }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS }));
 
@@ -170,6 +200,10 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
       data = await api(`/api/v1/jobs/${encodeURIComponent(args.id)}`, { method: "DELETE" });
     } else if (name === "katto_get_account") {
       data = await api("/api/v1/me");
+    } else if (name === "katto_list_sources") {
+      data = { sources: SOURCES, note: "You can also clip a local file via the REST API (POST /v1/uploads)." };
+    } else if (name === "katto_list_clip_lengths") {
+      data = { clip_lengths: CLIP_LENGTHS };
     } else {
       throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katto-mcp",
-  "version": "0.3.0",
+  "version": "0.3.2",
   "mcpName": "io.github.miracleweasel/katto-mcp",
   "description": "MCP server for Katto — turn long videos into scored, captioned 9:16 clips from any MCP client (Claude, Cursor, ...).",
   "type": "module",