katto-mcp 0.5.2 → 0.5.4

package/README.md

@@ -1,5 +1,10 @@
 # katto-mcp
 
+[![npm version](https://img.shields.io/npm/v/katto-mcp.svg)](https://www.npmjs.com/package/katto-mcp)
+[![npm downloads](https://img.shields.io/npm/dm/katto-mcp.svg)](https://www.npmjs.com/package/katto-mcp)
+[![license](https://img.shields.io/npm/l/katto-mcp.svg)](./LICENSE)
+[![MCP Registry](https://img.shields.io/badge/MCP%20Registry-io.github.miracleweasel%2Fkatto--mcp-blue)](https://registry.modelcontextprotocol.io)
+
 **The AI video clipping MCP server.** Turn long videos into scored, captioned, vertical 9:16 short clips from any MCP client (Claude, Cursor, Claude Code, ChatGPT, VS Code, and other conformant clients). Drop in a YouTube link, a podcast, or a Twitch VOD and get publish-ready shorts back through natural conversation.
 
 Powered by [Katto](https://katto.tech), an AI video clipper that turns long-form video (podcasts, interviews, streams, webinars) into short-form clips for TikTok, Reels and YouTube Shorts. Katto is a flat-priced, no-credits alternative to tools like OpusClip: one 25-video quota covers videos up to 90 minutes each, with the API and MCP included on every paid plan (not gated behind an enterprise tier).
@@ -10,7 +15,7 @@ Ask your agent something like *"clip the best moments from this podcast and refr
 
 - find the strongest 30 to 90 second moments in a long video and score each clip 0 to 100 on Hook, Flow, Value and Trend,
 - reframe to vertical 9:16 with face tracking, split-screen for two speakers, and stacked layouts for gaming,
-- burn word-by-word animated captions (99 languages) and optionally dub into 8 languages,
+- burn animated captions (auto-captioned in 99 languages via Whisper large-v3; word-by-word timing in 41 of them, sentence-level in the rest) and optionally dub into 8 languages,
 - and hand back publish-ready MP4 files plus SRT caption urls.
 
 Typical uses: repurpose a YouTube video into shorts, turn a podcast episode into clips, cut highlights from a Twitch VOD, or convert a long interview into vertical social posts.
@@ -43,7 +48,22 @@ For Cursor, CI and scripts. Create an API key at **[katto.tech/dashboard/api-key
 
 The hosted endpoint above also accepts `Authorization: Bearer sk_live_...` directly for key-based clients.
 
-## Tools (15)
+## Install per client
+
+**Claude Code** (hosted, OAuth):
+```bash
+claude mcp add --transport http katto https://mcp.katto.tech/mcp
+```
+
+**Claude Desktop** — Settings → Connectors → *Add custom connector* → `https://mcp.katto.tech/mcp`, then sign in. (Or add the `npx` block above to `claude_desktop_config.json`.)
+
+**Cursor** — Settings → MCP → *Add* → paste the `npx` JSON block above (uses `KATTO_API_KEY`).
+
+**VS Code** (MCP extension) — add the same `npx` block to your MCP settings, or point it at the hosted URL if your client supports remote OAuth servers.
+
+**ChatGPT** (Developer mode / connectors) — add a custom connector with URL `https://mcp.katto.tech/mcp`.
+
+## Tools
 
 Clipping:
 - **`katto_create_clip_job(url, config?)`** clip a long video (YouTube, Twitch, Vimeo, Rumble, Zoom, Dailymotion). Returns a job id.
@@ -62,7 +82,7 @@ Account and reference:
 - **`katto_get_usage()`** your plan and remaining monthly video quota.
 - **`katto_get_account()`** the connected account, this key's scopes, and quota.
 - **`katto_get_brand_kit()`** your saved brand kits (colors, caption font, layout, watermark).
-- **`katto_get_webhook_secret()`** your webhook signing secret and how to verify signed callbacks.
+- **`katto_get_webhook_secret()`** your webhook signing secret and how to verify signed callbacks (returns a secret — treat it like a credential).
 - **`katto_list_sources()`** the video platforms Katto can clip from, with an example url each.
 - **`katto_list_clip_lengths()`** the valid target clip-length buckets.
 
@@ -77,6 +97,12 @@ Jobs draw from your Katto plan's monthly video quota (25 on Creator, 2 on Free),
 
 Full docs: **[katto.tech/docs/api](https://katto.tech/docs/api)**
 
+## Security & data
+
+- **Hosted auth is OAuth 2.1** — the API key is never written to your disk, and you can revoke a connected client anytime from your Katto account settings.
+- **Local auth uses a scoped `sk_live_` key** you create yourself; keys can be read-only, and the npx server only sends it to `KATTO_API_URL` (default `katto.tech`) over HTTPS.
+- `katto_get_webhook_secret` returns a signing secret — handle it like any credential; it is only needed to verify inbound webhook signatures.
+
 ## Also listed on
 
 - npm: [katto-mcp](https://www.npmjs.com/package/katto-mcp)
@@ -96,4 +122,6 @@ Example prompts:
 2. "Check the status of my last clipping job and give me the download links for the finished clips."
 3. "Take clip 2 from that job, dub it into Spanish and re-render it with the Bold caption style."
 
-MIT
+## License
+
+MIT — see [LICENSE](./LICENSE).

package/index.mjs

@@ -15,12 +15,19 @@ import { ListToolsRequestSchema, CallToolRequestSchema } from "@modelcontextprot
 const API_URL = (process.env.KATTO_API_URL || "https://katto.tech").replace(/\/$/, "");
 const API_KEY = process.env.KATTO_API_KEY;
 
+// NOTE: we intentionally do NOT exit when the key is missing. The server must be
+// able to start and answer tools/list WITHOUT a key so that MCP directory/aggregator
+// sandboxes (Glama, mcp.so, ...) can enumerate the tools — otherwise they show
+// "0 tools". Nothing runs unauthenticated: the key is enforced at call time in api()
+// below, so tools/list is public but every tool CALL still requires a valid 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);
+  console.error("[katto-mcp] No KATTO_API_KEY set — tools/list works, but calling any tool requires a key. Create one at https://katto.tech/dashboard/api-keys");
 }
 
 async function api(path, init = {}) {
+  if (!API_KEY) {
+    throw new Error("KATTO_API_KEY is required to call Katto tools. Create one at https://katto.tech/dashboard/api-keys and set it in your MCP client config.");
+  }
   const res = await fetch(`${API_URL}${path}`, {
     ...init,
     headers: {
@@ -45,7 +52,7 @@ 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'.",
+      "the clips finish asynchronously. Poll katto_get_job with the id until status is 'completed'.",
     inputSchema: {
       type: "object",
       properties: {
@@ -243,7 +250,7 @@ const ANNOTATIONS = {
 // Agent-facing descriptions (when to call, returns, errors, quota cost). Served
 // on tools/list — identical across all sources, enriching the terser inline text.
 const DESCRIPTIONS = {
-  katto_create_clip_job: "Submit a long video (YouTube, Twitch, Vimeo, Rumble, Zoom, Dailymotion) for clipping. Consumes 1 video from your monthly quota — check katto_get_usage first. Clips are produced asynchronously (~5-7 min); returns a job id, then poll katto_get_job until status is 'completed'. Fails if the URL is unsupported or the video is over 90 minutes.",
+  katto_create_clip_job: "Submit a long video (YouTube, Twitch, Vimeo, Rumble, Zoom, Dailymotion) for clipping. Consumes 1 video from your monthly quota — check katto_get_usage first. Clips are produced asynchronously; returns a job id, then poll katto_get_job until status is 'completed'. Fails if the URL is unsupported or the video is over 90 minutes.",
   katto_get_job: "Read-only. Get the status, progress and clips of a job by id. When status is 'completed', 'clips' holds the finished 9:16 MP4 urls and caption (SRT) urls; while processing, clips is empty. Returns 404 for an unknown id.",
   katto_list_jobs: "Read-only. List your recent jobs, newest first. Paginate with 'cursor' (pass the previous next_cursor); optional 'status' filter. Returns { jobs: [{id, status, source, created_at, completed_at}], next_cursor }.",
   katto_get_clips: "Read-only convenience: just the finished clips of a job (9:16 MP4 urls + caption SRT urls + title + virality score). Returns an empty list while the job is still processing.",
@@ -283,7 +290,7 @@ const CLIP_LENGTHS = [
   { value: '90_180', label: '90 to 180 seconds' },
 ];
 
-const server = new Server({ name: "katto", version: "0.5.2" }, { capabilities: { tools: {} } });
+const server = new Server({ name: "katto", version: "0.5.4" }, { capabilities: { tools: {} } });
 
 server.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: TOOLS_LISTED }));
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katto-mcp",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "mcpName": "io.github.miracleweasel/katto-mcp",
   "description": "AI video clipping MCP server: turn long videos, podcasts and Twitch VODs into scored, captioned 9:16 shorts from Claude, Cursor, ChatGPT and any MCP client.",
   "type": "module",