symflow-mcp — Claude MCP for TikTok Symphony Creative Studio

Run TikTok's Symphony Creative Studio from Claude Code or Claude Desktop: trend templates with their full director prompts, reference-to-video / image-to-video / text-to-video on Seedance, talking avatars, product and apparel try-on, video refresh from your own footage, dubbing into other languages and the editor draft — inside your own Symphony account and weekly credits.

This package is the open bridge: an MCP server (stdio) plus a tiny local HTTP queue. The work in the browser is done by the SymFlow Chrome extension (https://lingoflow.pro/symflow), which reads the studio's data with your session and reports results back. No API keys, no scraping services, nothing leaves your machine except the calls your browser already makes to ads.tiktok.com.

Claude ──MCP stdio──▶ symflow-mcp ──▶ bridge 127.0.0.1:8789 ◀── polling ── SymFlow extension ──▶ Creative Studio tab
                                            │
                                     files on disk (symflow-out/<job>/)

Install

claude mcp add symflow -- npx -y symflow-mcp

Then install the SymFlow extension, open ads.tiktok.com/creative/creativestudio signed in, and ask Claude to call sym_status. Claude receives the director playbook from the extension and works by it: asks what you sell and where, proposes ideas, names the cost in credits before spending, generates, waits and downloads the files.

Tools

| Tool | What it does | |---|---| | sym_status | connection, credits (weekly grant, spent, next refill), available models, inbox from the "→ Claude" button, the director playbook | | sym_templates, sym_template | TikTok trend templates with the complete director prompt, reference image and sample video | | sym_generate | reference-to-video, image-to-video, text-to-video, image generation; dryRun returns the price first | | sym_avatars, sym_voices, sym_avatar_video | AI and real avatars, voices, a talking avatar video from a script with captions | | sym_tryon | avatar holding your product or wearing your apparel (images, then animated clips) | | sym_transform | "Video refresh": new 15/30 s TikTok cuts from your ≥15 s footage and photos, 11 languages | | sym_dub | dubbing into other languages, subtitle replacement, lip-sync | | sym_editor | read / update / render / export the server-side editor draft | | sym_history, sym_links, sym_upload, sym_credits | what was generated, download links, library uploads, ledger | | sym_wait, sym_cancel, sym_log | wait for files, cancel the queue, diagnostics |

Credits

Symphony grants weekly credits. Only Seedance clips are charged (Seedance 1.5: 1 credit per second; 2.0: 5; 2.0 Mini: 2; 2.0 Fast: 3; 2.5: 10). Image generation, talking avatars, try-on images, video refresh and dubbing were free at the time of writing. Claude reads the balance before every batch and stops when a job would exceed it.

Remote Claude

By default the bridge listens on 127.0.0.1:8789. For Claude on another machine set OF_HOST to a Tailscale address; a non-loopback bind requires the token from ~/.symflow-token (header X-SymFlow-Token), which you paste into the extension settings.

Security

The bridge refuses requests with an http(s) Origin (only chrome-extension:// and local callers), keeps its queue in memory, and never stores your TikTok session — the extension uses the cookies your browser already has. The Symphony adapter and the director playbook are part of the extension, not of this package.

MIT © DanikVR — https://lingoflow.pro/symflow