Katto’s official MCP server — 15 tools

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.

{
  "name": "katto_create_clip_job",
  "arguments": {
    "url": "https://youtube.com/watch?v=…"
  }
}

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.

{
  "name": "katto_get_job",
  "arguments": {
    "id": "job_…"
  }
}

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 }.

{
  "name": "katto_list_jobs",
  "arguments": {
    "limit": 20,
    "cursor": "…",
    "status": "…"
  }
}

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.

{
  "name": "katto_get_clips",
  "arguments": {
    "id": "job_…"
  }
}

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.

No parameters.

{
  "name": "katto_get_usage",
  "arguments": {}
}

Read-only. The transcript of a completed job as timestamped segments [{ start, end, text }]. Returns 404 while the job is still processing.

{
  "name": "katto_get_transcript",
  "arguments": {
    "id": "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.

{
  "name": "katto_cancel_job",
  "arguments": {
    "id": "job_…"
  }
}

Read-only. The account behind this key: plan, this key's scopes (read/write), and monthly quota { videos_used, videos_limit, videos_remaining }.

No parameters.

{
  "name": "katto_get_account",
  "arguments": {}
}

Read-only. The video platforms Katto can clip from, each with an example URL. Use it to confirm a URL is supported before calling katto_create_clip_job.

No parameters.

{
  "name": "katto_list_sources",
  "arguments": {}
}

Read-only. The valid values for the optional config.clipLength on katto_create_clip_job (target clip-duration buckets).

No parameters.

{
  "name": "katto_list_clip_lengths",
  "arguments": {}
}

Re-render one already-finished clip with a new reframe layout and/or caption style. Free — does NOT use video quota. Each call starts a new render (not idempotent); the original clip is kept. Returns a rerender_id; poll katto_get_rerender for the new clip url.

{
  "name": "katto_rerender_clip",
  "arguments": {
    "id": "job_…",
    "clip_index": 0
  }
}

Re-render one finished clip dubbed into one or more of 8 languages (en, es, fr, it, pt, hi, ja, zh). Free — does NOT use video quota. Each call starts a new render (not idempotent). Returns a rerender_id; poll katto_get_rerender for the result.

{
  "name": "katto_dub_clip",
  "arguments": {
    "id": "job_…",
    "clip_index": 0,
    "languages": [
      "en"
    ]
  }
}

Read-only. Poll a re-render started by katto_rerender_clip or katto_dub_clip. Returns { status, clip_url, captions_url } — clip_url is null until status is 'completed'.

{
  "name": "katto_get_rerender",
  "arguments": {
    "id": "job_…",
    "rerender_id": "…"
  }
}

Read-only. Your saved brand kits (colors, caption font and position, default layout, watermark url).

No parameters.

{
  "name": "katto_get_brand_kit",
  "arguments": {}
}

Read-only. Returns your webhook signing SECRET — treat it as a credential (do not display or log it) — plus how to verify Katto's signed completion callbacks (HMAC-SHA256 of {timestamp}.{body}). Pass webhook_url on a job to receive them.

No parameters.

{
  "name": "katto_get_webhook_secret",
  "arguments": {}
}