Allows an AI agent to shrink video files on Windows using H.265/AV1 and GPU encoding for single files or entire folders.
Also known as contentasoftware/mcp-launcher, videorecompress, @contentasoft/videorecompress-mcp
- Stars
- 0
- Tools
- —
- Downloads, 30 days
- 563
- Latest version
- 1.0.2
- Last commit
- Nov 10, 2026
- License
- MIT
What is VideoRecompress Studio MCP?
VideoRecompress Studio allows an AI agent to shrink video files on Windows using H.265/AV1 and GPU encoding for single files or entire folders.
Summary generated from the project's README
About VideoRecompress Studio MCP server
Shrinking video files on a Windows computer using H.265 or AV1 encoding is what this MCP server enables for AI agents. Developers using Claude Code, Claude Desktop, Cursor, or VS Code can instruct an agent to compress individual videos or entire folders using GPU encoding. The server acts as a launcher that connects your AI client to the VideoRecompress Studio desktop application installed on your local machine.
Users interact with the software through specific tools like recompress_video, batch_recompress, and estimate_savings. The agent can also query technical details using get_file_info, list_presets, or list_formats. To manage the software, tools like get_license_status and register_license are available. While the launcher is MIT-licensed, the underlying VideoRecompress Studio is commercial software that offers a free trial allowing ten unrestricted files per PC before applying watermarks and length limits.
Setup requires running a command via npx to start the launcher, which then locates the videorecompress.exe executable in your local app data or system path. Because video encoding is a heavy task, you may need to adjust client timeout settings for long-running jobs.
What you can do with it
- 1Compressing a single video fileAsk the AI to reduce the file size of a specific video using H.265 encoding.
- 2Processing entire video directoriesInstruct your agent to run a batch compression job on every video found in a specific folder.
- 3Predicting storage space savingsHave the AI estimate how much disk space will be saved before starting a compression task.
- 4Checking remaining free trial usesAsk the agent to verify how many unrestricted video encodes are left in the free trial.
Written from the project's README. Every use case is checked against a quote from it.
How to install VideoRecompress Studio MCP
Formats verified 10 Nov 2026Add to CursorAdd to GooseInstall VideoRecompress Studio MCP in Claude Code
$ claude mcp add videorecompress -- npx -y @contentasoft/videorecompress-mcpInstall VideoRecompress Studio MCP in Cursor
~/.cursor/mcp.json
{
"mcpServers": {
"videorecompress": {
"command": "npx",
"args": [
"-y",
"@contentasoft/videorecompress-mcp"
]
}
}
}Install VideoRecompress Studio MCP in VS Code
.vscode/mcp.json
{
"servers": {
"videorecompress": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@contentasoft/videorecompress-mcp"
]
}
}
}Install VideoRecompress Studio MCP in VS Code CLI
$ code --add-mcp '{"name":"videorecompress","type":"stdio","command":"npx","args":["-y","@contentasoft/videorecompress-mcp"]}'Install VideoRecompress Studio MCP in Claude Desktop
claude_desktop_config.json
{
"mcpServers": {
"videorecompress": {
"command": "npx",
"args": [
"-y",
"@contentasoft/videorecompress-mcp"
]
}
}
}Install VideoRecompress Studio MCP in Codex
$ codex mcp add videorecompress -- npx -y @contentasoft/videorecompress-mcpInstall VideoRecompress Studio MCP in Codex config.toml
~/.codex/config.toml
[mcp_servers.videorecompress] command = "npx" args = ["-y", "@contentasoft/videorecompress-mcp"]
Install VideoRecompress Studio MCP in Gemini CLI
$ gemini mcp add -s user videorecompress npx -- -y @contentasoft/videorecompress-mcpInstall VideoRecompress Studio MCP in Gemini settings.json
~/.gemini/settings.json
{
"mcpServers": {
"videorecompress": {
"command": "npx",
"args": [
"-y",
"@contentasoft/videorecompress-mcp"
]
}
}
}Automated checks
Ran Nov 14, 2026Full report →Passed our automated checks. That is not a security audit: read the code and give the server the narrowest access it needs. How checks work
- Source repository linked and reachablecontentasoftware/mcp-launcher is public and reachablegithub.com/contentasoftware/mcp-launcher ↗Pass
- Package names this repository as its source@contentasoft/videorecompress-mcp names contentasoftware/mcp-launcher as sourcenpmjs.com/package/@contentasoft/videorecompress-mcp ↗Pass
- Build provenance (Sigstore attestation)No build attestation published for this releaseNot checked
- Open source license (OSI)MITspdx.org/licenses/MIT.html ↗Pass
- Commit or release in the last yearLast commit or release 2026-11-10github.com/contentasoftware/mcp-launcher ↗Pass
- OpenSSF ScorecardNot checked
- Package name not close to a popular packageNo popular package one edit away from @contentasoft/videorecompress-mcpPass
- No critical advisory in the package or its dependencies1 resolved dependencies checked; no critical advisoryosv.dev ↗Pass
- No hidden instructions to the model0 tool descriptions and the README read; no override phrases, credential paths or hidden charactersPass
- Destructive tools are labelledNot checked
- Remote endpoint answers the MCP handshakeNot checked
README
View on GitHubVideoRecompress Studio MCP server
Lets an AI agent (Claude Code, Claude Desktop/Cowork, Codex, Cursor, VS Code and other MCP clients) use VideoRecompress Studio on your Windows PC: shrinking video files with H.265/AV1 and GPU encoding, one file or a whole folder.
VideoRecompress Studio is a Windows 10/11 desktop app with a free trial: https://www.contenta-software.com/videorecompress/download.php
How it works
This package is a small launcher. It finds VideoRecompress Studio on your PC (videorecompress.exe, installed per-user in
%LOCALAPPDATA%\Programs\VideoRecompressStudio or on your PATH) and runs the app's own MCP server
(videorecompress serve) over stdio. Tools: recompress_video, batch_recompress, get_file_info, estimate_savings, list_presets, list_formats, get_license_status, register_license.
If the app is not installed yet, the launcher serves a single get_started tool that gives your agent the
download link and the install steps instead.
Full CLI and MCP reference: https://github.com/brunojanvier77/ContentaSoft/blob/main/videorecompress/mcp-server.md (MCP tools and their parameters) and https://github.com/brunojanvier77/ContentaSoft/blob/main/videorecompress/cli.md (the command line).
Add it to your client
Claude Code (Windows):
claude mcp add videorecompress-studio -- cmd /c npx -y @contentasoft/videorecompress-mcp@1.0.6
Claude Desktop, Cursor and other clients that use mcpServers (JSON):
{
"mcpServers": {
"videorecompress-studio": { "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp@1.0.6"] }
}
}
VS Code (.vscode/mcp.json, note the servers key):
{
"servers": {
"videorecompress-studio": { "type": "stdio", "command": "cmd", "args": ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp@1.0.6"] }
}
}
Codex (codex mcp add videorecompress-studio -- cmd /c npx -y @contentasoft/videorecompress-mcp@1.0.6, or ~/.codex/config.toml):
[mcp_servers.videorecompress-studio]
command = "cmd"
args = ["/c", "npx", "-y", "@contentasoft/videorecompress-mcp@1.0.6"]
startup_timeout_sec = 60
tool_timeout_sec = 3600
The first start downloads this small package, which can take longer than a client's default startup timeout
(Codex: 10 s; Claude Code: set MCP_TIMEOUT); after that it starts at once. Long jobs such as video encodes can
exceed a client's default tool timeout too (Codex: 60 s; Claude Code: MCP_TOOL_TIMEOUT). The app is told to stop a
job when the client cancels it.
Once the app is installed you can also skip the launcher: "command": "videorecompress", "args": ["serve"].
What runs and what is sent
- The launcher itself sends nothing over the network and writes nothing to disk. It starts
videorecompress.exe. - The app works on local files on your PC. It sends anonymous usage telemetry (which tools ran, which MCP client connected, trial state) to ContentaSoft; turn it off in the app's settings. Privacy policy: https://www.contenta-software.com/videorecompress/privacy.php
- The free trial has no end date: the first 10 files per PC are unrestricted, later ones are watermarked and cut at 10 minutes.
videorecompress statusshows how many free files are left; a batch spends one per file. Nothing stops working; a licence removes the limits.
License
The launcher is MIT-licensed (see LICENSE). VideoRecompress Studio itself is commercial software by ContentaSoft AB.
VideoRecompress Studio MCP questions
How do I add VideoRecompress Studio MCP to Claude Code?
Run claude mcp add videorecompress -- npx -y @contentasoft/videorecompress-mcp in your terminal. Add --scope user to make it available in every project.
How do I add VideoRecompress Studio MCP to Cursor?
Open ~/.cursor/mcp.json and add the server under mcpServers, using the Cursor config shown in the install section above.
What happens if I don't have the software installed?
The launcher provides a get_started tool that gives the agent the download link and installation instructions.
Is there a free version available?
Yes, there is a free trial where the first 10 files per PC are unrestricted; subsequent files are watermarked and limited to 10 minutes.