# Seed a music sound on TikTok

Source: https://developers.tokportal.com/agents/for/music-sound-seeding/
Markdown: https://developers.tokportal.com/agents/for/music-sound-seeding.md

Sound seeding from any MCP-capable agent means getting a track used by many accounts in the launch market in the same week. TokPortal turns it into API calls: `create_bundles_bulk` opens the accounts in the country the label cares about, every slot's `tiktok_sound_url` points at the official sound page so the manager posts *with* that sound (volume fields let you balance original vs. added audio), dates are staggered, and `list_account_video_analytics` reports plays per post. Accounts are human-created and operated, so the wave reads as adoption rather than as one uploader.

## Try the workflow without spending

For this trial, use the remote MCP endpoint `https://app.tokportal.com/api/ext/mcp`, local `tokportal-mcp` **1.15.1 or later**, or the REST API. Upgrade and restart an older local server first. Version 1.15.0 does not forward the dry-run header; do not use its write tools for a simulation. If you cannot verify the installed local version, use the remote endpoint or REST.

Use the [sandbox](https://developers.tokportal.com/sandbox) for the first attempt. MCP write tools accept `dry_run: true` as a top-level argument, beside `body`; REST writes accept the `X-TokPortal-Dry-Run: true` header. Keep your usual authentication and scopes. Each simulated write validates the request and returns `credits_would_charge` with `credits_charged: 0`. Nothing is created or published.

Simulated IDs start with `00000000-0000-4000-8000-`. Use them only in later dry-run writes. GET requests read real data, so skip publish-readiness checks and polling for synthetic IDs. Simulations have no cross-call memory and upload URLs are placeholders: do not upload files to them.

To run for real, review the returned price and confirm **before the first live write**. Bundle creation charges credits immediately; publishing hands the order to a manager. Repeat creation without dry-run mode and use the new real IDs for configuration and publishing. A synthetic ID cannot be reused in a live request.

## How it works

The unit that matters for a sound campaign is *uses*: distinct accounts posting with the sound. So the agent sizes accounts first — 20 to 50 is a typical first wave — with `create_bundles_bulk` in the target `country` (`US`, `GB`, `BR`, `MX`…), `videos_per_account` 2–3 so each account posts a couple of times during the week. Advanced Warming on music/dance/genre terms (`generate_warming_terms` from "bedroom pop fans, indie playlists") gives the accounts a plausible listening history before the drop.

Each video slot needs a clip (dance, lip-sync, POV, transition — the label usually supplies a brief and creatives), a caption and the sound. `configure_bundle_video` fields: `video_url`, `description` (caption with the artist's hashtags), `target_publish_date` (spread across the week, ≤3/day/bundle), `tiktok_sound_url` (the `tiktok.com/music/...` URL), and optionally `volume_original_sound` / `volume_added_sound` (0–200; using them costs 1 credit per video) when the clip's own audio must stay audible under the track. Add `disclose_as_ads: true` if it is a paid placement. Then `publish_bundle` for each bundle.

For measurement the agent reads `list_account_video_analytics` per account and `export_analytics_videos` for the whole wave; sound-level use counts live on TikTok's sound page, so the agent reports its own contribution (posts, views, likes per post) alongside. A second wave on the same accounts is just `videos_only` bundles with `account_id`.

## Tool sequence

1. `tokportal_get_credit_costs` — Accounts + slots + 1 credit per video using volume control.
2. `tokportal_generate_warming_terms` — Genre/fan-culture terms so accounts look like listeners.
3. `tokportal_create_bundles_bulk` — `platforms:["tiktok"]`, `country`, `accounts_count`, `videos_per_account`, warming terms.
4. `tokportal_configure_bundle_account` — Fan-style personas, not label handles.
5. `tokportal_configure_bundle_video` — `tiktok_sound_url`, `volume_original_sound`, `volume_added_sound`, `description`, date, `video_url`.
6. `tokportal_publish_bundle` — Per bundle.
7. `tokportal_list_account_video_analytics` — Views/likes per seeded post.
8. `tokportal_export_analytics_videos` — Wave-level CSV for the label.

## Pick your agent

- [Seed a music sound on TikTok with Claude](https://developers.tokportal.com/agents/claude/music-sound-seeding) — Anthropic's assistant on claude.ai, the mobile apps and Claude Desktop, with custom MCP connectors.
- [Seed a music sound on TikTok with Claude Code](https://developers.tokportal.com/agents/claude-code/music-sound-seeding) — Anthropic's terminal coding agent; MCP servers are added with `claude mcp add` and used in any session.
- [Seed a music sound on TikTok with ChatGPT](https://developers.tokportal.com/agents/chatgpt/music-sound-seeding) — OpenAI's assistant; plans with developer mode can add remote MCP servers as custom connectors.
- [Seed a music sound on TikTok with OpenAI Codex](https://developers.tokportal.com/agents/codex/music-sound-seeding) — OpenAI's coding agent (Codex CLI and IDE extension); MCP servers live in `~/.codex/config.toml`.
- [Seed a music sound on TikTok with Cursor](https://developers.tokportal.com/agents/cursor/music-sound-seeding) — AI code editor with an agent mode; MCP servers are configured in `.cursor/mcp.json` or via a one-click deeplink.
- [Seed a music sound on TikTok with Windsurf](https://developers.tokportal.com/agents/windsurf/music-sound-seeding) — Codeium's agentic IDE (Cascade); MCP servers are declared in `~/.codeium/windsurf/mcp_config.json`.
- [Seed a music sound on TikTok with Cline](https://developers.tokportal.com/agents/cline/music-sound-seeding) — Open-source autonomous coding agent for VS Code with an MCP marketplace and per-tool approval.
- [Seed a music sound on TikTok with OpenClaw](https://developers.tokportal.com/agents/openclaw/music-sound-seeding) — Open-source autonomous agent runtime with a skills registry (ClawHub); TokPortal ships as a first-party skill.
- [Seed a music sound on TikTok with Hermes Agent](https://developers.tokportal.com/agents/hermes-agent/music-sound-seeding) — Nous Research's open-source agent runtime; MCP servers are declared under `mcp_servers` in `~/.hermes/config.yaml`.
- [Seed a music sound on TikTok with Gemini CLI](https://developers.tokportal.com/agents/gemini-cli/music-sound-seeding) — Google's open-source terminal agent for Gemini; MCP servers via `gemini mcp add` or `~/.gemini/settings.json`, plus extensions.
- [Seed a music sound on TikTok with Goose](https://developers.tokportal.com/agents/goose/music-sound-seeding) — Block's open-source local agent; remote MCP servers are added as extensions (Streaming HTTP) or via a `goose://` deeplink.
- [Seed a music sound on TikTok with Perplexity](https://developers.tokportal.com/agents/perplexity/music-sound-seeding) — Answer engine with custom MCP connectors on paid plans; good for read-only research over your TokPortal data.
- [Seed a music sound on TikTok with Microsoft Copilot Studio](https://developers.tokportal.com/agents/copilot-studio/music-sound-seeding) — Microsoft's low-code agent builder; MCP servers are added as tools through the MCP onboarding wizard (Streamable transport).
- [Seed a music sound on TikTok with Factory Droid](https://developers.tokportal.com/agents/factory-droid/music-sound-seeding) — Factory's software-engineering agent (`droid` CLI); HTTP MCP servers are added with `droid mcp add`.
- [Seed a music sound on TikTok with n8n](https://developers.tokportal.com/agents/n8n/music-sound-seeding) — Open-source workflow automation; use the built-in MCP Client Tool node with an AI Agent, or the community node `n8n-nodes-tokportal` for deterministic steps.
- [Seed a music sound on TikTok with Make](https://developers.tokportal.com/agents/make/music-sound-seeding) — Visual automation platform (ex-Integromat); call TokPortal from HTTP modules with `X-API-Key`, or from Make's MCP Client module where available.
- [Seed a music sound on TikTok with Zapier](https://developers.tokportal.com/agents/zapier/music-sound-seeding) — Automation platform; today TokPortal is used via Webhooks by Zapier (REST) — a native TokPortal app is coming.
- [Seed a music sound on TikTok with Pipedream](https://developers.tokportal.com/agents/pipedream/music-sound-seeding) — Serverless integration platform for developers; call TokPortal from a Node.js/Python code step or the HTTP action, and receive webhooks on an HTTP trigger.
- [Seed a music sound on TikTok with Dify](https://developers.tokportal.com/agents/dify/music-sound-seeding) — Open-source LLM app platform; MCP servers are registered under Tools → MCP and used by Agent nodes and Agent apps.
- [Seed a music sound on TikTok with Flowise](https://developers.tokportal.com/agents/flowise/music-sound-seeding) — Open-source visual builder for LLM flows; the Custom MCP node connects any Streamable HTTP server to Agentflow / tool agents.
- [Seed a music sound on TikTok with Langflow](https://developers.tokportal.com/agents/langflow/music-sound-seeding) — Open-source visual framework for agents; the MCP Tools component connects to servers registered in Settings → MCP Servers.
- [Seed a music sound on TikTok with CrewAI](https://developers.tokportal.com/agents/crewai/music-sound-seeding) — Python multi-agent framework; `MCPServerAdapter` from `crewai-tools` turns any MCP server into agent tools.
- [Seed a music sound on TikTok with LangChain](https://developers.tokportal.com/agents/langchain/music-sound-seeding) — LangChain / LangGraph agents load MCP tools with `langchain-mcp-adapters` (`MultiServerMCPClient`).
- [Seed a music sound on TikTok with Vercel AI SDK](https://developers.tokportal.com/agents/vercel-ai-sdk/music-sound-seeding) — TypeScript toolkit for AI apps; the MCP client (`@ai-sdk/mcp`, formerly `experimental_createMCPClient` in `ai`) turns TokPortal tools into `generateText`/`streamText` tools.
- [Seed a music sound on TikTok with Mastra](https://developers.tokportal.com/agents/mastra/music-sound-seeding) — TypeScript agent framework; `MCPClient` from `@mastra/mcp` connects HTTP or stdio MCP servers and hands their tools to an `Agent`.

## Related

- [Music promotion on TikTok](https://developers.tokportal.com/use-cases/industry/music-promotion-tiktok)
- [Configure videos](https://developers.tokportal.com/configure-videos)
- [Create bulk](https://developers.tokportal.com/create-bulk)
- [Analytics API](https://developers.tokportal.com/analytics)
- [MCP server](https://developers.tokportal.com/mcp)
- [All agents](https://developers.tokportal.com/agents)