This server wraps Svmmon's API to generate and manage TikTok slideshows from Claude (or any MCP client). It requires a paid Svmmon subscription.
Check usage (get_usage): View your subscription tier, monthly slideshow limits, reset date, and available TikTok inbox draft slots.
List profiles (list_profiles): See all your Svmmon personas with their ID, name, niche, readiness status, missing requirements, and TikTok link status — only ready: true profiles can generate slideshows.
List presets (list_presets): Discover available slide-structure presets (e.g. listicle) to use during slideshow generation.
Generate hooks (generate_hooks): Produce AI-scored TikTok hook candidates (ranked 0–100 for virality) for a profile, optionally guided by a topic or tone; results are saved to the profile's hook library.
Generate a slideshow (generate_slideshow): Create a complete, rendered TikTok slideshow from a profile and hook; optionally deliver it directly to TikTok as a draft or via Telegram; returns a 24-hour download link.
List recent slideshows (list_slideshows): Browse up to 100 recently generated slideshows with hook text, profile, and creation date.
Fetch a specific slideshow (get_slideshow): Retrieve a slideshow by ID with a fresh 1-hour signed download URL — useful when the original link has expired.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@svmmon-mcp Create a slideshow for my cooking profile"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Generate TikTok slideshows from Claude (and any MCP client) using your Svmmon account.
This is a thin, local stdio MCP server that wraps Svmmon's public /api/v1 REST API. Install it, paste your key, and ask Claude to make slideshows in plain language. It adds no business logic — every tool maps 1:1 onto a real Svmmon endpoint.
Requires an active subscription. The API works on any active paid plan (per-tier volume caps still apply). Install always works; the tools return a clean "requires an active subscription" message until you paste a valid paid key.
app.svmmonapp.com → Settings → API Keys → Svmmon API → Generate key (any paid plan). It looks like svm_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx.
Treat this key like a password. If it's ever exposed, revoke it instantly in Settings → API Keys — the MCP can't revoke it for you.
Claude Desktop — edit claude_desktop_config.json:
{
"mcpServers": {
"svmmon": {
"command": "npx",
"args": ["-y", "svmmon-mcp"],
"env": { "SVMMON_API_KEY": "svm_your_key_here" }
}
}
}Claude Code:
claude mcp add svmmon -e SVMMON_API_KEY=svm_your_key_here -- npx -y svmmon-mcpGenerate 5 hooks for my Marcus profile and make a slideshow from the best one.
Related MCP server: brainrot
Tool | What it does |
| Full usage: tier + plan, slideshows used/cap, AI credits, rerolls, shorts/face-swap caps, account caps, per-account TikTok inbox slots. |
| Your profiles with |
| Valid |
| Scored hook candidates for a profile. Spends AI credits, so it is confirm-gated (see below). May return fewer than requested if your AI-credit cap is hit. |
| Generates ONE slideshow (consumes one from your monthly cap — not idempotent, confirm-gated). Returns a 24h download link; optionally delivers to TikTok/Telegram. |
| Studio image generation on your own provider key (BYOK — not idempotent, confirm-gated). |
| Studio video generation on your own provider key (BYOK — not idempotent, confirm-gated). |
| Remake a public TikTok slideshow in one of your profile voices. Costs 2 slideshows + 2 AI credits (confirm-gated). Async: returns a |
| Poll a recreation by |
| Abandon an in-flight recreation (confirm-gated). Not a refund — see below. |
| Your recent slideshows. |
| Fetch a slideshow + a fresh 1h download link by id. |
| Your image collections with per-collection image-fatigue health tiers. |
| One collection's images, with optional 10-min signed URLs so a vision agent can inspect them. |
| Your personal brain for a profile — patterns, voice DNA, next-hook directions (Growth+). |
| The anonymized community brain — what's working across accounts. |
| Post performance — views/likes/shares/comments, day-1 + final. |
| Live TikTok profile + recent-video stats (Growth+). |
| Studio model catalog + which of your provider keys unlock what. |
| Recent studio generations (metadata; provider source URLs may be expired). |
| Your saved studio generations. |
| Your connected TikTok accounts + live connection health (needs_reconnect, connection_error). |
| Your automations — active state, schedule, delivery mode, hook source, hook count, last run status. |
| One automation's full detail by id. |
| Your posting schedule — every slot's time, days, timezone, and which automation fires it. |
| One profile's full detail — bio, audience, tone, CTA, hashtags, readiness, linked accounts/automations. |
| A profile's hook library — text, status, source, used_count, virality_score. |
| Globally trending TikTok posts (not account-specific) — optional hashtag/days filter. |
Every write tool is two-step confirm-gated: the first call returns a preview of the exact consequence and cost and does nothing; you must call again with confirm: true to execute. Surface the preview to the user before confirming.
The four generate_* tools above are confirm-gated the same way, because they spend money — a slideshow slot, AI credits, or your own provider credits. They also need a write-scoped API key, exactly like the tools in this table.
recreate_slideshow is the one tool that does not finish in a single call. It costs 2 slideshows + 2 AI credits (double a normal generate, because it scrapes the source post and runs a vision read on top of writing the deck) and takes 1-4 minutes, so it returns a job_id immediately rather than polling inline — a client-side tool timeout mid-poll would otherwise lose the only handle on a run that may already have spent quota.
Poll get_recreate_status with that job_id every ~10 seconds. Never call recreate_slideshow again to check on a running job; that starts a second paid recreation.
Only one recreation runs at a time per account, shared with the dashboard. A second start returns 429 and spends nothing.
A failure with error.status 422 means the URL was not a slideshow, and that case never billed. Other failures are refunded automatically.
cancel_recreate is not a refund. It only stops the run if the worker has not reached its charge checkpoint. Land it later and the credits are already spent.
Tool | What it does |
| Upload base64 images (max 20) into an owned collection. Counts against your image-storage cap. |
| Add manual hooks (max 50) to a profile's hook library. |
| Permanently delete one hook from a profile's library (irreversible). |
| Edit a profile's safe voice/CTA/hashtag/product fields. Preview shows a current → new diff. |
| Re-post an already-generated slideshow to TikTok/Telegram — no AI call and no monthly quota spent. Uses a TikTok inbox slot. |
| Run an automation now — spends 1 slideshow + AI credits and posts LIVE. Cannot be undone. |
Env var | Required | Default | Notes |
| Yes | — | Your |
| No |
| Override only for self-host/staging. |
"key is missing, invalid, or revoked" (401) — Set SVMMON_API_KEY to a current key from Settings → API Keys.
"requires an active subscription" (403) — Subscribe at app.svmmonapp.com/subscribe. Any active paid plan works.
"a usage cap was reached" (402) — You hit your monthly slideshow or AI-credit cap. Run get_usage.
"Rate limited" (429) — Wait the suggested time if one is shown; otherwise it's a daily AI limit that resets at midnight UTC. The message tells you which.
1.x targets the Svmmon /api/v1 contract. A breaking API change (/api/v2) would ship as 2.x.
This package handles a live, cost-bearing credential. It reads the key from the environment only, never logs it, never puts it in process arguments, and never echoes it in errors. It performs no auto-retries on cost-burning calls. Report security issues to support@svmmonapp.com.
MIT
Generate scored TikTok hook candidates for one of the user's Svmmon profiles. Use when the user asks for hooks, openers, or angles for a profile (e.g. "give me 5 hooks for my Marcus profile about staying consistent"). Returns hooks ranked by a 0-100 virality score and persists them to the profile's hook library. COST: each batch of 3 candidates spends one AI credit (count=5 → 2 credits). May return FEWER hooks than requested if the AI-credit cap is hit mid-request — that is expected, not an error. Requires a valid profile_id: call list_profiles first and never invent one.
Inputs: profile_id (required), direction, count.
Generate ONE complete TikTok slideshow from a Svmmon profile and a hook, render it, and optionally deliver it to TikTok or Telegram. The profile is the source of truth for tone, preset, images, slide counts, and CTA. Use when the user asks to make/create/build a slideshow or post from a hook. CONSUMES ONE SLIDESHOW from the monthly cap and is NOT idempotent — never call it twice for the same request; if it times out, check list_slideshows before retrying (the slideshow may already exist). Takes 30-120 seconds. Check get_usage first if you may be near the monthly cap. Returns a slideshow_id and a signed ZIP download_url valid for 24 hours. Delivery failures never fail generation — a failed TikTok/Telegram send comes back as a reason, not an error. Requires a ready profile_id (call list_profiles; only ready:true profiles can generate).
Inputs: profile_id (required), hook (required), preset_id, deliver, +1 more.
Fetch one slideshow by its id, including fresh 1-hour signed download URLs for its export ZIP. Use this when the user asks to "get the download link for slideshow X", "re-download a slideshow", or "get the link again" (the link from generate_slideshow expires after 24h; this mints fresh 1h links). Get the id from list_slideshows first. Read-only — consumes no quota. Download links may be empty if the slideshow has no export file (e.g. a Telegram-only export).
Inputs: id (required).
Check the Svmmon account's current usage and limits: subscription tier, monthly slideshows used vs. cap, when the counter resets, and per-TikTok-account inbox draft slots (used/cap/available). Use this to answer "how many slideshows do I have left", "check my Svmmon usage", or "how many TikTok slots are free" — and call it before a batch of generations to confirm there is quota and TikTok slot headroom. Consumes no quota.
Inputs: no named parameters.
List the slide presets you can pass as preset_id to generate_slideshow. Use this for "what slide presets can I use" or before generating a slideshow when the user wants a specific structure. Every id returned is a valid preset_id. Consumes no quota.
Inputs: no named parameters.
List the Svmmon account's profiles (personas) with their id, name, niche, generation readiness, and whether a TikTok account is linked. Use this for "what profiles do I have" or "list my Svmmon personas". IMPORTANT: only profiles where ready is true can generate a slideshow — if a profile is not ready, the missing list says which image collection it still needs. Never invent a profile id; call this first to get a real one. Consumes no quota.
Inputs: no named parameters.
List the most recent slideshows on this Svmmon account, newest first. Use this when the user asks to "show my recent slideshows", "what have I generated", or wants a slideshow id to fetch its download link with get_slideshow. Returns id, hook text, profile_id, and created_at for each. Read-only — consumes no quota. Optional limit (1–100, default 20).
Inputs: limit.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 7 tools
Each tool targets a distinct action: generating hooks, generating slideshows, fetching a single slideshow, checking usage, listing presets, listing profiles, and listing slideshows. No two tools have overlapping purposes.
All tool names follow a consistent verb_noun pattern (e.g., generate_hooks, list_profiles, get_usage), making it easy for an agent to predict behavior from the name alone.
Seven tools cover the full lifecycle of generating TikTok slideshows without bloat. Each tool serves a clear, necessary function and the count is appropriate for the domain.
The tool set covers all core operations: hook generation, slideshow creation, download retrieval, usage monitoring, and listing of presets, profiles, and slideshows. No obvious gaps for the stated purpose.
Make, render and auto-post AI faceless videos to YouTube, TikTok and Instagram from any MCP client.
Use AI models for chat, image, and video generation from Claude Code and other MCP hosts.
Publish and schedule videos to TikTok, YouTube Shorts, Instagram, Facebook, LinkedIn, Pinterest, Bluesky, Threads and X from Claude, Cursor or any MCP client. Upload once, post everywhere, track views in unified analytics, and retry failed posts. Official platform APIs only, free plan available. Docs: https://docs.multi-upload-tool.com/mcp
Generate, schedule and post faceless and AI UGC short videos from Claude, Cursor or any MCP client.
