svmmon-mcp

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 a Growth plan or higher. The API is gated to Growth+ accounts. Install always works; the tools return a clean "needs Growth+" message until you paste a valid paid key.

Quickstart

1. Get your key

app.svmmonapp.com → Settings → API Keys → Svmmon API → Generate key (Growth plan or higher). 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.

2. Add the server

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-mcp

3. Ask

Generate 5 hooks for my Marcus profile and make a slideshow from the best one.

Related MCP server: openai-mcp

Tools

Configuration

Troubleshooting

• "key is missing, invalid, or revoked" (401) — Set SVMMON_API_KEY to a current key from Settings → API Keys.

• "needs a Growth plan or higher" (403) — Upgrade at app.svmmonapp.com/subscribe.

• "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.

Versioning

1.x targets the Svmmon /api/v1 contract. A breaking API change (/api/v2) would ship as 2.x.

Security

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.

License

MIT