Let Claude.ai, Cursor, Claude Desktop, Claude Code, or any MCP client make clips for you. Agent clips use the same monthly quota as the website: one clip from an agent counts as one clip here.
ikto runs a remote MCP server (Streamable HTTP) at https://iknowthisone.online/mcp. Its tools read your account, suggest moments in a Twitch or Kick VOD link, create a clip, and list your clips. Sign in with OAuth or use an API key.
Fastest: copy one prompt
Get a prompt with the ikto link and a key, paste it into your agent. When the agent connects, ikto stops it and sends you to a page where you approve it in your browser; then the same key just works. Works with any agent that can call an MCP server or make HTTP requests.
Free: 10 clips a month · Lite: 40 · Pro: 500 · Max: 2,500. Sign in to create a key.
Connect
Server URL (Streamable HTTP):
https://iknowthisone.online/mcp
Web clients such as Claude.ai use OAuth (sign in with your ikto account). Desktop clients can use OAuth or an API key below. Same plan quota either way.
Claude.ai (web)
Custom connector. Claude registers itself and you approve access in the browser — no API key.
In Claude.ai open Settings → Connectors (or Custom connectors).
Add a custom connector named ikto.
Remote MCP URL: https://iknowthisone.online/mcp
When Claude asks you to sign in, approve ikto in this browser. Clips then use this account’s quota.
Cursor
Add to ~/.cursor/mcp.json (or .cursor/mcp.json in a project). Cursor can also add the URL as a streamable HTTP server and complete OAuth in the browser.
Plan, clips used and left this month, and export limits.
check_link
Tells you if a link works before you spend a clip: title, length, live now, or why not. Doesn’t use quota.
suggest_moments
Scan a Twitch or Kick VOD (or YouTube when it’s on) and return likely highlights with a virality estimate. Doesn’t use quota.
create_clip
Render a vertical MP4 on our servers: link, start and end in seconds, layout (auto, split, full_cam, full_screen), caption style, optional hook, tighten, speed, and the same logo overlay as the editor (logonone|ikto, logo_pos, logo_width, safe_platform). MCP logo defaults to your saved editor logo if you have one, else none. Pass logo: "ikto" to opt in to the IKTO mark plus iknowthisone.online. A non-empty hook always burns, below the logo when both are on. Leave layout, captions and logo position out to use your saved default style; auto puts the webcam on top and the game below when it finds one. Uses 1 clip. Returns a download link that works for 1 hour; the file is deleted shortly after download. If rendering takes longer than about 45 seconds it answers rendering instead of failing.
create_auto_clips
Lite, Pro and Max: ikto finds the top moments of a long video and frames each one (Lite 1, Pro 3, Max 10 per run). Uses 1 clip per moment.
get_clip_status
Waits up to 45 seconds for the clip that’s rendering, then returns its progress or the finished download link.
get_queue
Clips rendering or waiting in line (position, wait, progress), from the website, the app or MCP, plus the last few finished. Doesn’t use quota.
get_history
Every clip you made: title, source link, start and end, date. Searchable. Doesn’t use quota.
list_clips
Clips still on our servers with fresh download links.
Try: “Make my top 3 moments from https://www.twitch.tv/videos/…” or “Clip 1:02:10 to 1:02:40 from that VOD with yellow captions.”
Tools reference
Every MCP tool, generated from the live tools/list schemas so this page cannot drift. Machine-readable copy: /developers/mcp.md (llms.txt-style markdown).
Sources. Twitch VOD (`twitch.tv/videos/…`): full recording; `start`/`end` are offsets from the VOD start. Twitch clip URL: one already-cut highlight — still clipable, but `suggest_moments` / `create_auto_clips` have little to scan. Kick VOD or clip: same split. Live Twitch/Kick channel: any part streamed so far; offsets count from stream start. Public Google Drive, Dropbox, OneDrive or WeTransfer file. YouTube when the site has it switched on. Other public video pages. https only, max 2000 characters.
Common errors. Pass an https link to a Twitch, Kick, or YouTube video. — url missing, not https, too long, or blocked. · start and end must be numbers of seconds. · MCP clips are up to 180 seconds. Pick a shorter window, or use the website for long Pro clips. · Rate limited: 10 clips an hour, shared with the website. Try again later. · This clip isn’t allowed on your plan. — plus upgrade_url / clips_left when it is a quota or paywall gate. · logo must be none (no overlay) or ikto (the IKTO mark and iknowthisone.online). · Unknown tool: <name> — JSON-RPC -32602. · Unauthorized / 401 — missing, revoked, or unapproved API key or OAuth token.
get_account — Plan and clips left
The signed-in IKTO plan (Free, Lite, Pro, or Max), clips used and left this month, and the export rules for that plan (max height, fps, watermark, hours, parallel exports, auto-pick batch_limit). Free on the website and Free here are the same quota. Does not use a clip. Call this first.
Unauthorized if the key or OAuth token is missing or revoked.
suggest_moments — Find clip-worthy moments
Scan a Twitch, Kick, or YouTube link (chat spikes, loudness, heatmaps) and return suggested windows with start, end, a reason, an optional hook, and a virality estimate. Works on a VOD, a clip URL, or a Twitch/Kick channel that is live now (moments from the stream so far). Rate limit 60 scans an hour. Does not use a clip.
Quota: Does not use a clip. Rate limit 60 scans an hour.
Parameters
urlstring · required
https link. Twitch/Kick VOD (videos/… or /videos/…) or clip URL, a live Twitch/Kick channel, or YouTube when enabled. Clip URLs are a single already-cut moment; VODs are scanned for several.
Pass an https link to a Twitch, Kick, or YouTube video.
Rate limited: 60 scans an hour. Try again later.
Scan timeout or SuggestError message from the finder.
create_clip — Render a vertical clip
Cut [start, end] seconds from the link, lay it out at 9:16, burn captions and the same logo overlay as the website editor, and return a download URL. Uses 1 clip from this month's quota (the same quota as the website). Up to 180 seconds. Answers within about 45 seconds: either done with a download_url, or status rendering, in which case call get_clip_status (do not call create_clip again). A non-empty hook always burns at the top (below the logo when both are on), including when word-pop captions are on. Layout, captions, logo, logo_pos, logo_width and safe_platform fall back to the user's saved default style from the app. logo itself is none unless that style includes one, or the agent passes ikto.
Quota: Uses 1 clip. Window at most 180 seconds. Rate limit 10 clip jobs an hour, shared with the website.
Parameters
urlstring · required
Video link (https): Twitch or Kick VOD (full recording) or clip URL (already-cut highlight), a Twitch/Kick channel that is live now (any part streamed so far; offsets count from the stream start), public Drive/Dropbox/OneDrive/WeTransfer file, YouTube when enabled, or another video page. Max 2000 characters.
startnumber · required · min 0
Window start, in seconds from the source start (required).
endnumber · required · min 0
Window end, in seconds (required). Must be after start. At most 180 s after start.
auto: IKTO looks at the video and picks (webcam on top and game below when it finds a webcam, the game centred when there is none). split: facecam on top, gameplay below. full_cam: the facecam fills the frame. full_screen: the video fills the frame (center crop). Optional. Leave it out to use the user's saved default style, else auto.
Playback speed with pitch kept. Optional, default 1. Quota counts the window you picked, not the shorter result.
logostring · optional · default none · none, ikto
Same overlay as the website Logo upload. Optional. Default none (no overlay), or the user's saved editor default if that style includes a logo. Pass ikto to opt in to the bundled IKTO mark plus iknowthisone.online through the existing logo render path. Plan watermarks are separate.
Same slots as the website editor. top / top-centre / top-center are horizontal centre under the TikTok/Reels top safe zone. top-left and top-right sit in the corners. bottom sits above the lower captions. Optional. Leave it out for the user's saved default style, else top-right.
logo_widthnumber · optional · default 0.28 · min 0.12, max 0.5
Logo width as a fraction of the 720-wide frame (same as the website logo_width range). Optional. Leave it out for the user's saved default, else 0.28.
safe_platformstring · optional · default both · tiktok, reels, both
TikTok/Reels caption safe zones (same as the website). both keeps clear of either app's chrome. Optional. Leave it out for the user's saved default, else both.
Returns
status done: clip (title, start, end, seconds, layout, caption_style, download_url, link_expires_in_minutes), clips_left, plan, note. status rendering: progress_percent, message, next_step (call get_clip_status; do not create again). isError result: error sentence plus clips_left / upgrade_url when it is a gate.
{
"status": "done",
"clip": {
"title": "Clip",
"start": 10.0,
"end": 40.0,
"seconds": 30.0,
"layout": "split",
"caption_style": "yellow-pop",
"download_url": "https://iknowthisone.online/api/clip/file?token=…",
"link_expires_in_minutes": 60
},
"clips_left": 487,
"plan": "Pro",
"note": "The file is deleted from IKTO a few minutes after it is downloaded."
}
Common errors
Pass an https link to a Twitch, Kick, or YouTube video.
start and end must be numbers of seconds.
MCP clips are up to 180 seconds.
Rate limited: 10 clips an hour, shared with the website.
logo must be none or ikto.
That hook text was blocked.
Plan / quota / YouTube-cap gates with upgrade_url.
get_clip_status — Check the clip that's rendering
Status of this account's latest clip. While it renders this waits up to 45 seconds, then answers rendering (with progress), done (with a fresh download_url), idle (nothing in flight), expired (file already gone), or an error that says why. Does not use a clip.
Quota: Does not use a clip. Waits up to 45 seconds while the latest job is rendering.
Parameters
No parameters. Call with {}.
Returns
Same shapes as create_clip: rendering, done, idle, expired, or an isError result.
{
"status": "rendering",
"progress_percent": 42.0,
"message": "Rendering the clip…",
"next_step": "The clip is still rendering and has not failed. Call get_clip_status (it waits up to 45 seconds) until status is done. Don't call create_clip again for the same window."
}
Common errors
Export didn’t finish — no playable clip was saved. Try again.
Render error sentence with clips_left.
create_auto_clips — Auto-pick and make the top moments
Scan a long Twitch, Kick or YouTube video, pick its best moments, and make each one a vertical clip with its own framing (webcam on top and game below when there is a webcam) and the user's default captions. Uses the same logo overlay as create_clip (none unless the user saved a logo, or the agent passes logo=ikto). Lite, Pro and Max only. Uses 1 clip per moment. count is capped by the plan (get_account export.batch_limit: Lite 1, Pro 3, Max 10). Long videos take a few minutes: when the answer is rendering, call get_clip_status until done; the done answer lists every clip.
Quota: Lite, Pro, Max only. Uses 1 clip per moment. count capped by export.batch_limit (Lite 1, Pro 3, Max 10). Rate limit 10 clip jobs an hour.
Parameters
urlstring · required
VOD link (https), or a Twitch/Kick channel that is live now. Clip URLs are a single moment — prefer a VOD for auto-pick.
countinteger · optional · min 1, max 10
How many moments. Optional. Defaults to the plan's most (Lite 1, Pro 3, Max 10).
logo_widthnumber · optional · default 0.28 · min 0.12, max 0.5
Same as create_clip. Optional.
safe_platformstring · optional · default both · tiktok, reels, both
Same as create_clip. Optional.
Returns
Same job answer as create_clip. When several files finish, clips[] lists every one (best first) plus clip for the first. While scanning, status rendering with a message that names how many moments.
{
"status": "rendering",
"progress_percent": 5.0,
"message": "Finding the top 3 moments and framing each one. Long videos take a few minutes.",
"next_step": "The clip is still rendering and has not failed. Call get_clip_status (it waits up to 45 seconds) until status is done. Don't call create_clip again for the same window."
}
Common errors
Auto-pick is on Lite, Pro and Max. On Free, use suggest_moments and then create_clip.
count must be between 1 and <batch_limit> on this plan.
clip_seconds must be 15, 30, 45, 60 or 90.
Only N clips left this month. Ask for fewer.
check_link — Check a link before clipping
Is this link clippable? Returns the title, channel, length, thumbnail and platform, whether a channel is live now, or why it won't work. Nothing is downloaded and no clip is used. Rate limit 120 checks an hour.
Quota: Does not use a clip. Rate limit 120 checks an hour.
Parameters
urlstring · required
Video link (https). Twitch/Kick VOD or clip, live channel, Drive/Dropbox/OneDrive/WeTransfer, YouTube when enabled, or another video page.
Returns
ok true: platform, label, title, duration, thumb, creator, kind, verified, plus live-now fields when it is a channel. ok false: platform, label, error.
This account's clips that are rendering or waiting in line (with position, wait time and progress), plus the ones finished or failed in the last 6 hours with download links while the files exist. Covers clips started on the website, the phone app and MCP. Does not use a clip.
Quota: Does not use a clip.
Parameters
No parameters. Call with {}.
Returns
active (count still rendering or waiting), jobs[] (state, title, source, progress, wait, optional download_url), next_step.
{
"active": 1,
"jobs": [
{
"state": "queued",
"title": "Clutch",
"source": "Twitch",
"progress": 0
}
],
"next_step": "Something is still rendering: call get_clip_status to wait for it."
}
get_history — Clip history
Every clip this account made, newest first: title, source link, start and end, length, virality and date. Search by title or link. Page with before = the previous answer's next_before. Files are deleted after download, so remake one with create_clip and the same source_url, start and end. Does not use a clip.
Quota: Does not use a clip.
Parameters
limitinteger · optional · default 20 · min 1, max 50
Page size. Optional, default 20, max 50.
beforenumber · optional
Optional. next_before from the previous page (created_at timestamp).
searchstring · optional · maxLength 80
Optional. Words in the title or source link, max 80 characters.
{
"items": [
{
"title": "My best play",
"source_url": "https://www.twitch.tv/videos/9",
"platform": "twitch",
"start": 10.0,
"end": 40.0,
"seconds": 30.0,
"virality": 74,
"created_at": 1730000000.0,
"file": "ikto"
}
],
"total": 1,
"next_before": null,
"note": "file is ikto while it can still be downloaded (see list_clips), device when it was saved on the user's device, gone when deleted. To make one again, call create_clip with the same source_url, start and end."
}
list_clips — Recent clips
Clips still on the server for this account, newest first, with fresh download URLs. Up to 10. Files are removed shortly after their first download, or within 24 hours. Does not use a clip.
Quota: Does not use a clip.
Parameters
No parameters. Call with {}.
Returns
clips[] up to 10: title, created_at, download_url, link_expires_in_minutes. Empty when nothing is still stored.