katto-mcp 0.5.5 → 0.5.6

package/README.md

@@ -85,6 +85,7 @@ Account and reference:
 - **`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.
+- **`katto_list_caption_styles()`** the caption-style presets you can pass as `caption_style` when creating a job or re-rendering a clip.
 
 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, read-only scoped keys, and signed HMAC webhooks. See the [docs](https://katto.tech/docs/api).
 

package/index.mjs

@@ -177,7 +177,12 @@ const TOOLS = [
           type: "string",
           enum: ["face_tracking", "wide", "split_screen", "stacked", "passthrough", "grid_3", "grid_4"],
         },
-        caption_style: { type: "string", description: "A caption style preset name." },
+        caption_style: {
+          type: "string",
+          // Keep in sync with CAPTION_STYLES below (katto_list_caption_styles).
+          enum: ["default", "hormozi", "yellowPop", "redAlert", "skyline", "bubblegum", "aqua", "violet", "headline", "centerPop", "topLime", "impactMax", "bebasGold", "robotoBold", "montserratClean", "poppinsSoft", "robotoDoc", "broadcast", "wideClean", "mono", "bebasWhite", "rainbow", "multicolor"],
+          description: "A caption style preset name. See katto_list_caption_styles for the labels.",
+        },
       },
       required: ["id", "clip_index"],
     },
@@ -259,9 +264,9 @@ const ANNOTATIONS = {
 // 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; 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. Each clip is { url, captions_url, title, score, final }: score is the 0-100 virality score (sort by it to rank), and final is true once the HQ 1080p render is ready — during processing you may see interim clips with final=false whose url is a preview that will be replaced. Returns 404 for an unknown id.",
+  katto_get_job: "Read-only. Get the status, progress and clips of a job by id. Clips come ranked by virality score (0-100, highest first; ties broken by clip_index). Each clip is { url, captions_url, title, score, clip_index, hd }: when status is 'completed' every url is a finished, downloadable clip; hd is true once the 1080p high-quality render is ready. hd=false does NOT mean broken — the url already works, the 1080p is just still rendering in the background (and stays the standard render on the free plan). The job-level hd_ready flag turns true once every clip is hd, i.e. the URLs are final and won't be swapped again (status='completed' fires earlier). 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: the clips of a job as { url, captions_url, title, score, final }. Sort by score for the top N. `final` is false while a clip's HQ render is still finishing. Empty until the first clip is ready.",
+  katto_get_clips: "Read-only convenience: the clips of a job as { url, captions_url, title, score, clip_index, hd }, ranked by score (highest first). hd=true means the 1080p render is ready; hd=false means the url is the standard render (HD still finishing, or the free plan). Empty until the first clip is ready.",
   katto_get_usage: "Read-only. Your current plan and monthly video quota: { plan, videos_used, videos_limit, videos_remaining }. Call before katto_create_clip_job to confirm remaining quota.",
   katto_get_transcript: "Read-only. The transcript of a completed job as timestamped segments [{ start, end, text }]. Returns 404 while the job is still processing.",
   katto_cancel_job: "Cancel a still-running job (queued/processing) and refund the video back to your monthly quota. Safe to retry (idempotent). Returns an error if the job already finished, failed, or was cancelled.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "katto-mcp",
-  "version": "0.5.5",
+  "version": "0.5.6",
   "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",