# Seed UGC across many accounts

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

UGC seeding from any MCP-capable agent means taking a batch of creator-style videos and getting them posted from many ordinary-looking accounts in the target market, so the campaign reads as organic rather than as one brand handle. TokPortal does the account side: `create_bundles_bulk` opens N accounts in one country, `configure_bundle_video` places each creative on its slot with `disclose_as_ads` when required, `publish_bundle` hands each account to a human manager, and `export_analytics_videos` gives you a per-account, per-video report. Each account is human-created and human-operated, which is what keeps a seeding wave from being flagged as coordinated automation.

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

A seeding plan is a matrix: creatives × accounts × dates. The agent starts with the accounts. `create_bundles_bulk` with `platforms: ["tiktok"]` (or `["tiktok","instagram"]` to seed both), `country`, `accounts_count` (≤100 per call) and `videos_per_account` returns one bundle id per account. Each account gets its own `configure_bundle_account` — vary handles, bios and profile pictures (upload with `upload_image_from_url`) so the accounts look like different people, and consider `advanced_warming_terms` in the product's niche so the accounts have a history when the seeding starts.

Then the creatives. Upload each once (`upload_video` → `public_url`) and reuse the URL across bundles; TokPortal's duplicate-post guard is per account, so the same file on ten different accounts is fine. Fill slots with `configure_bundle_video` or `batch_configure_bundle_videos`, staggering `target_publish_date` across days and accounts (max 3 per day per bundle) so the wave looks natural. Set `disclose_as_ads: true` where the content is paid promotion — the manager enables branded-content disclosure or adds #ad — and add `tiktok_sound_url` if the campaign runs on a sound. `publish_bundle` per bundle (or loop). If a client asks for the Spark/Partner code to boost a post, `create_video_ad_code_request` returns it after finalization (7 credits).

Reporting is where any MCP-capable agent shines: `export_analytics_videos` (CSV, filter by `country`, `platform`, `from`/`to`) plus `get_comment_pulse` for what people say, aggregated by the agent into a campaign summary.

## Tool sequence

1. `tokportal_get_credit_costs` — N accounts × (32 + 2 × videos) — quote before creating.
2. `tokportal_create_bundles_bulk` — `platforms`, `country`, `accounts_count`, `videos_per_account`, optional `advanced_warming_terms_count`.
3. `tokportal_configure_bundle_account` — Different persona per bundle: handle, name, bio, `profile_picture_url`.
4. `tokportal_upload_video` — Upload each creative once; reuse `public_url` across bundles.
5. `tokportal_configure_bundle_video` — Place creative on slot: `description`, `target_publish_date`, `video_url`, `disclose_as_ads`, `tiktok_sound_url`.
6. `tokportal_publish_bundle` — One call per bundle.
7. `tokportal_create_video_ad_code_request` — Spark Code / Partner Code for paid boosting after finalization (7 credits).
8. `tokportal_export_analytics_videos` — Per-video CSV across all accounts for the campaign report.
9. `tokportal_get_comment_pulse` — Sentiment / themes across the seeded posts.

## Pick your agent

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

## Related

- [UGC distribution at scale](https://developers.tokportal.com/use-cases/industry/ugc-distribution-at-scale)
- [TikTok Shop product seeding](https://developers.tokportal.com/use-cases/industry/tiktok-shop-product-seeding)
- [Create bulk](https://developers.tokportal.com/create-bulk)
- [Ad code request](https://developers.tokportal.com/ad-code-request)
- [MCP server](https://developers.tokportal.com/mcp)
- [All agents](https://developers.tokportal.com/agents)