Cuecaps

io.github.Pantheonn3DPublished by GitHub account Pantheonn3Dv0.1.2Updated Oct 29, 2026

Animated word-by-word captions for your video and audio files, rendered on your machine by Cuecaps.

VerifiedStreamable HTTPWeb executableProductivity & Workflow Media & Design

Server details

Identifier: io.github.Pantheonn3D/cuecaps-mcp
Transport: Streamable HTTP
Runtime: Web executable
Trust: Verified
Published: Oct 29, 2026

Security note

MCP servers receive tool arguments from a conversation and may perform external actions. Review what a server can do before you enable it, and give it only the access it needs.

The registry verified the GitHub account Pantheonn3D for this listing. That does not show the account is the product's maker.

SourceWeft's checks cover whether the listing is complete and the endpoint answered; they do not review the server's code or what its tools do.

Add a badge to your README

Show readers this MCP server is listed on SourceWeft. The badge links to this page.

[![Listed on SourceWeft](https://sourceweft.com/badge/mcp/io.github.Pantheonn3D%2Fcuecaps-mcp.svg)](https://sourceweft.com/mcp/io.github.Pantheonn3D%2Fcuecaps-mcp?utm_source=readme&utm_medium=badge)

Overview

AI-generated overview

Cuecaps adds animated word-by-word captions to video and audio files, either by returning a preconfigured studio link or by rendering captions locally.

What you can do: List the ten caption styles with their ids and looks
Build a Cuecaps studio link preconfigured with style, words per line, position, aspect ratio and language, plus the steps for the user
Check plan, remaining cloud minutes and agent access
Transcribe a local file into timed words and SRT text
Caption a local file and write an MP4 with burned-in captions, a transparent overlay, or SRT/VTT subtitles next to it
When to use it: Useful when someone wants short-form captions for TikTok, Shorts, Reels or YouTube and wants the assistant to pick a style and either hand over a ready studio link or produce a captioned file directly on their machine.
Requirements: Hosted endpoint needs no install or key. The local npm package needs Node 22 or later, Chrome or Edge at a standard path (or CUECAPS_CHROME), and a CUECAPS_API_KEY from a Creator or Pro plan for the keyed tools; list_styles and studio_link work without one. Cloud transcription uses plan minutes; device transcription downloads a 132 MB model on first run.

Before you install

The local server writes new files next to the input (never overwriting existing ones) and drives a headless browser. Cloud transcription sends compressed speech audio to Cuecaps, and projects and their words sync to the account; device engine sends no audio. The API key is a paid-plan credential and should be passed by environment variable, not in URLs or files.

Installation

In SourceWeft

Open Cuecaps in the dashboard and add it to a workspace.
Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.Pantheonn3D%2Fcuecaps-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "cuecaps": {
      "type": "http",
      "url": "https://cuecaps.com/mcp"
    }
  }
}

README

cuecaps-mcp

Caption a video or audio file on your computer from Claude Code, Cursor, Claude Desktop or any MCP client. Ask "caption talk.mp4 in Karaoke and give me the MP4" and talk.captions.mp4 lands next to the original. The server drives the Cuecaps studio's own export in headless Chrome or Edge on your machine, so the result matches a studio export of the same settings. Once the project syncs to your account, caption_video also returns a studio link that opens it, to fix a word or change the style.

No install: the hosted server

Apps that connect to an MCP server by URL can use https://cuecaps.com/mcp (Streamable HTTP) with no install and no key: claude.ai and the Claude apps on phone and desktop, ChatGPT, Gemini CLI, Claude Code and Cursor. It has list_styles and studio_link, so you ask for captions the way you'd describe them ("karaoke captions on a Spanish TikTok") and get a studio link set up for them, to finish in your browser. To caption a file on your computer directly, use this package (below).

claude.ai: Settings, Connectors, Add custom connector, and paste https://cuecaps.com/mcp.
Claude Code: claude mcp add --transport http cuecaps https://cuecaps.com/mcp
Gemini CLI, in ~/.gemini/settings.json: { "mcpServers": { "cuecaps": { "httpUrl": "https://cuecaps.com/mcp" } } }

Setup for every client: cuecaps.com/ai-assistants.

Requirements

Node 22 or later.
Google Chrome or Microsoft Edge, found at its standard install path. CUECAPS_CHROME points to any other browser.
A key from cuecaps.com/account. Agent access comes with a Creator or Pro plan: cuecaps.com/pricing.

Setup

Claude Code

Claude Desktop and Cursor

Add this to the MCP config: Settings, Developer, Edit Config in Claude Desktop, or ~/.cursor/mcp.json in Cursor.

json

{ "mcpServers": { "cuecaps": { "command": "npx", "args": ["-y", "cuecaps-mcp"], "env": { "CUECAPS_API_KEY": "cck_…" } } } }

{ "mcpServers": { "cuecaps": { "command": "npx", "args": ["-y", "cuecaps-mcp"], "env": { "CUECAPS_API_KEY": "cck_…" } } } }

The Agent access card on cuecaps.com/account creates a key and shows this config with the key filled in.

Tools

Tool	Key	What it does
`list_styles`	no	The 10 caption styles: id, name and how each one looks.
`studio_link`	no	A studio link that opens set up with your settings. Works on every plan.
`account_status`	yes	Your plan, cloud minutes left this period, the date they reset, and whether it includes agent captioning.
`transcribe`	yes	Every word of a file with its start and end time in seconds, plus the SRT text. Writes no file.
`caption_video`	yes	Captions a file and writes the result next to it.

Every input except path is optional. The caption settings use the studio-link names: style, words (1 to 10), lines (1 or 2), position (top, middle, bottom), aspect (9:16, 1:1, 4:5, 16:9) and lang (a language code such as es; auto lets cloud transcription detect it). Each tool's schema lists the valid values.

transcribe and caption_video also take:

engine: cloud is ElevenLabs Scribe on your plan's cloud minutes, strongest on music, accents and 90+ languages, and the default when the minutes left cover the file. device is on-device Whisper with no minutes; its first run downloads the model (132 MB). The result names the engine used.
keyterms: up to 100 names and words for cloud transcription to spell your way.

caption_video also takes:

output: mp4 with the captions burned in (the default), mov or webm as a transparent captions-only overlay, or srt or vtt subtitles.
resolution: 720p, 1080p (the default), 1440p or 4k. 1440p and 4K come with Pro.
fps: 24, 25, 30 (the default), 50 or 60.
out_path: an absolute path in an existing folder to write to instead; its extension sets the output.

Examples

list_styles

Returns [{ "id": "bold", "name": "Bold", "look": "Montserrat in capitals with a black outline, …" }, …].

studio_link

Returns { "url": "https://cuecaps.com/studio?style=karaoke&words=4&aspect=9%3A16" }.

account_status

Returns { "plan": "creator", "minutes_left": 287.5, "resets": "2026-11-20", "agents": true }.

transcribe

Returns { "words": [{ "text": "Greetings!", "start": 0.48, "end": 1.84 }, …], "srt": "1\n00:00:00,480 --> …", "engine": "device", "minutes_used": 0 }.

caption_video

Returns { "file": "/Users/ana/clips/talk.captions.mp4", "duration": 17.17, "engine": "cloud", "minutes_used": 0.29, "studio_url": "https://cuecaps.com/studio#p=…" }. While it runs, the server reports progress: Opening, Transcribing, Rendering 42%, Saving.

Output files

caption_video writes <name>.captions.<ext> next to the input. A file that already exists is never replaced: the next run writes <name>.captions-2.<ext>, then -3, and so on. The same rule applies to out_path.

The studio link in studio_url opens the saved project on Creator and Pro. The video itself stays on your machine, so the studio asks for the file again when you open the link on another device.

Settings

Variable	Use
`CUECAPS_API_KEY`	Your key (`cck_` and 32 characters).
`CUECAPS_CHROME`	Path to the Chrome or Edge executable, when it isn't at a standard install path.
`CUECAPS_URL`	The Cuecaps site, `https://cuecaps.com` by default.

Privacy

Your video stays on your machine. The render happens in a browser on your computer.
Cloud transcription sends compressed speech audio, as the studio does, and deletes it after transcription. engine: "device" sends no audio. The project and its words still sync to your account, as every project does on Creator and Pro.
Your key goes only to cuecaps.com/api/* requests. It is never in a URL, a log or a file.
Each run uses a temporary browser profile and deletes it afterwards, so no cookies or projects stay behind.

License

MIT. The source is at github.com/Pantheonn3D/cuecaps-mcp.

Source: README.md at commit a365624

Tools

list_styles

List caption styles

Lists the 10 Cuecaps caption styles: the id to pass as style to studio_link, the name, and how each one looks. Call it when the user hasn't picked a style or asks what the styles look like.

Takes no parameters.

studio_link

Make a studio link

Returns a link to the Cuecaps studio set up with these caption settings, and the steps to give the user: they open it, add their video, click Find words and export an MP4 with captions burned in, a transparent overlay or an SRT or VTT file. The video stays on their device. Works on every plan, Free included.

Parameterslanglinesstylewordsaspectposition

Version history

v0.1.2LatestOct 29, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

Reached in the last 30 daysRequired25 pts
Auth declaredRequired10 pts
Tools listedRequired15 pts
DescriptionRequired15 pts
Logo10 pts
Documentation15 pts
License10 pts