ViralMint MCP Server
ViralMint ships an open-source Model Context Protocol server — 86 tools that let Claude Code, Claude Desktop or Cursor scout, download, clip, generate and export video end-to-end. Loopback-only, token-secured, no subscription.
MCP server at a glance
{
"server": "ViralMint MCP Server",
"protocol": "Model Context Protocol (HTTP Streamable)",
"endpoint": "http://127.0.0.1:16888/mcp",
"auth": "bearer token (0600, loopback-only)",
"tools": 86,
"tool_modules": ["macros", "research", "acquire", "generate", "output", "tools", "automation", "orchestration", "feedback", "browser"],
"prompts": "9 built-in + unlimited user-defined",
"resources": 4,
"browser_automation_tools": 16,
"clients": ["Claude Code", "Claude Desktop", "Cursor", "any MCP client"],
"subscription": false
}
Implementation in backend/mcp/.
Deep-dive: Drive video production from Claude Code.
What is an MCP server?
MCP (Model Context Protocol) is an open standard for connecting AI assistants to tools and data. An MCP server exposes an application's capabilities so an LLM client — Claude Code, Claude Desktop, Cursor or any MCP-aware client — can call them directly, instead of you clicking through a UI. It's the difference between asking an assistant to "describe how to make a short" and having it actually make one.
ViralMint exposes its entire backend over MCP: 86 tools spanning
research (scout trending videos across YouTube, TikTok, Douyin and
Reddit), acquisition (download from 1,800+ sites with yt-dlp, import
local clips, connect channels), generation (Smart Video, AI video,
script writing, batch runs), output (clip extraction, multi-aspect
export), a full editing suite (captions, reframe, audio enhance,
translate, AI image/music/voice/thumbnail), automation, and 16
browser tools that drive ViralMint's bundled Chromium. Long-running
tools return a job id; a wait_for_job helper polls until
the artifact is on disk — so an LLM can chain a six-step workflow into
a single request.
How to connect Claude Code to ViralMint in 4 steps
- Open the MCP page. Launch ViralMint and open the
MCP page in the sidebar. The Setup tab shows your endpoint
(
http://127.0.0.1:16888/mcp) and a bearer token. - Copy the config. The page generates both a Claude Code CLI command and a ready-to-paste JSON snippet, each with the endpoint and your token already filled in.
- Register the server. Paste the command into Claude Code (or add the JSON to your MCP config) and restart the client so it loads the 86 tools, 9 built-in prompts and 4 resources.
- Drive the pipeline. Ask in plain English — "scout AI-news shorts, download the top result, extract the best clip, add viral captions and export 9:16 + 16:9". Claude chains the tools and reports back with the file paths.
What the MCP surface includes
86 tools, 10 modules
Research, acquire, generate, output, editing tools, automation, orchestration, feedback and browser. Workflow macros come first so the LLM reaches for one-call shortcuts before composing primitives.
Prompts + resources
9 built-in workflow recipes (create viral short, repurpose long-form, news-to-short, podcast-to-clips…) plus unlimited user-defined prompts, and 4 read-only resources (balance, recent videos, connected channels, top niches) to ground the LLM in your state.
16 browser tools
Navigate, click, type, screenshot, extract and evaluate — Claude drives ViralMint's bundled Chromium directly. No separate @playwright/mcp install; one Chromium binary, one token.
Loopback + token security
Mounted on 127.0.0.1 only — never network-bound — with a bearer token stored at 0600 and a one-click rotate. The token is the install-binding signal: one config, one ViralMint.
Jobs that resolve themselves
Long-running tools return a job id; wait_for_job
polls to a terminal state and hands back the parsed output plus the
artifact path — so the LLM rarely needs a separate download call.
Live activity + cost preview
Every MCP call streams to the in-app Activity tab in milliseconds,
and tool_cost_estimate returns the price of an action
before you run it — no surprise spend.
Frequently asked
What is an MCP server?
MCP (Model Context Protocol) is an open standard that lets AI assistants call external tools, read data sources and run prompts. An MCP server exposes an app's capabilities so an LLM client — Claude Code, Claude Desktop, Cursor or any MCP-aware client — can drive that app directly. ViralMint's MCP server exposes its entire video pipeline as 86 callable tools, so you run the whole workflow from a chat with Claude instead of clicking through the UI.
How many tools does the ViralMint MCP server expose?
86 tools across 10 modules: research, acquire, generate, output, editing tools, automation, orchestration, feedback, and 16 browser-automation tools that drive ViralMint's bundled Chromium. It also exposes 9 built-in MCP prompts (plus your own) and 4 read-only resources (balance, recent videos, connected channels, top niches).
Is the ViralMint MCP server secure?
Yes. The server is mounted on the local app (127.0.0.1 loopback only — it never binds to the network) and every request requires a bearer token generated on first run and stored with 0600 permissions. The token is shown on the in-app MCP page with copy + rotate buttons. Because it's loopback-bound, it isn't reachable from the internet.
Which clients work with it?
Any MCP-aware client: Claude Code (the CLI), Claude Desktop, Cursor, and others that speak the Model Context Protocol over HTTP Streamable transport. The in-app MCP page gives you both a Claude Code CLI command and a JSON config snippet to paste.
Does the MCP server cost anything?
The MCP server itself is free and open-source (AGPL-3.0), bundled with the desktop app. Tools that call cloud AI (video, image, voice, music generation) bill a few cents per use from prepaid credits, the same as in the UI; everything local (downloads, captions, reframe, Whisper transcription, browser tools) has no per-call cost.
Run ViralMint from Claude Code
The MCP server ships in the open-source desktop app. Download it, open the MCP page, paste the config into Claude Code, and drive the whole pipeline from chat.