# Launch an app with persona accounts Source: https://developers.tokportal.com/agents/for/app-persona-launch/ Markdown: https://developers.tokportal.com/agents/for/app-persona-launch.md An app launch on short video usually runs on personas — "the productivity nerd", "the student", "the parent" — each a real account with its own voice, bio link and content plan. From any MCP-capable agent, each persona is one TokPortal bundle: `create_bundle` in the launch country, `configure_bundle_account` with the persona's handle, bio and `link_in_bio` (your store or deep link), warming terms in the persona's niche, and 30 days of `configure_bundle_video` slots showing the app in that persona's life. Human managers hold the accounts, so there is no OAuth per persona and no audit; `get_analytics_dashboard` compares personas. ## 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 Design the cast first: 3–6 personas, each with a country (the app's launch markets), a platform (TikTok, Instagram or both), a handle, a one-line bio ending with a call to action, and a link — TokPortal supports `link_in_bio` as a URI, so use a tracked link per persona (`?utm_content=persona_a`) to attribute installs. Create each with `create_bundle` (`account_and_videos`, `videos_quantity` 30–60), or all at once with `create_bundles_bulk` if they share a country, then personalize each account with `configure_bundle_account` (`username`, `visible_name`, `biography`, `profile_picture_url` uploaded via `upload_image_from_url`, `link_in_bio`). Warming matters for personas because the account should look like the person: `generate_warming_terms` from "college student who studies with Pomodoro apps" gives terms a student would search. Content is per persona: screen recordings of the app, talking-head style clips, before/after — uploaded once via `upload_video`, then placed with `batch_configure_bundle_videos` at ≤3 posts per day, captions in the persona's voice, `disclose_as_ads: true` where your legal team says so. `publish_bundle` per persona. Then run it as a portfolio from any MCP-capable agent: `get_analytics_dashboard` and `get_analytics_series` per account (`account` filter) show which persona converts, `list_analytics_account_comments` reveals objections to answer in the next batch, and `add_video_slots` extends the winners. Register `account.finalized`, `video.finalized` and `account.banned` webhooks so the agent (or your Slack) knows the state of every persona without polling. ## Tool sequence 1. `tokportal_get_credit_costs` — Personas × (setup + slots + warming) before committing. 2. `tokportal_create_bundle` — One per persona: `platform`, `country`, `videos_quantity`, `wants_advanced_warming` + terms. 3. `tokportal_upload_image_from_url` — Persona avatar → `profile_picture_url` (purpose profile\_picture). 4. `tokportal_configure_bundle_account` — `username`, `visible_name`, `biography`, `link_in_bio` (tracked per persona). 5. `tokportal_batch_configure_bundle_videos` — 30-day plan per persona, ≤3/day, persona-voice captions. 6. `tokportal_publish_bundle` — Per persona. 7. `tokportal_create_webhook_endpoint` — `account.finalized`, `video.finalized`, `account.banned` → your Slack/agent. 8. `tokportal_get_analytics_dashboard` — Compare personas (`account` filter, `from`/`to`). 9. `tokportal_list_analytics_account_comments` — Objections and questions per persona to feed the next batch. ## Pick your agent - [Launch an app with persona accounts with Claude](https://developers.tokportal.com/agents/claude/app-persona-launch) — Anthropic's assistant on claude.ai, the mobile apps and Claude Desktop, with custom MCP connectors. - [Launch an app with persona accounts with Claude Code](https://developers.tokportal.com/agents/claude-code/app-persona-launch) — Anthropic's terminal coding agent; MCP servers are added with `claude mcp add` and used in any session. - [Launch an app with persona accounts with ChatGPT](https://developers.tokportal.com/agents/chatgpt/app-persona-launch) — OpenAI's assistant; plans with developer mode can add remote MCP servers as custom connectors. - [Launch an app with persona accounts with OpenAI Codex](https://developers.tokportal.com/agents/codex/app-persona-launch) — OpenAI's coding agent (Codex CLI and IDE extension); MCP servers live in `~/.codex/config.toml`. - [Launch an app with persona accounts with Cursor](https://developers.tokportal.com/agents/cursor/app-persona-launch) — AI code editor with an agent mode; MCP servers are configured in `.cursor/mcp.json` or via a one-click deeplink. - [Launch an app with persona accounts with Windsurf](https://developers.tokportal.com/agents/windsurf/app-persona-launch) — Codeium's agentic IDE (Cascade); MCP servers are declared in `~/.codeium/windsurf/mcp_config.json`. - [Launch an app with persona accounts with Cline](https://developers.tokportal.com/agents/cline/app-persona-launch) — Open-source autonomous coding agent for VS Code with an MCP marketplace and per-tool approval. - [Launch an app with persona accounts with OpenClaw](https://developers.tokportal.com/agents/openclaw/app-persona-launch) — Open-source autonomous agent runtime with a skills registry (ClawHub); TokPortal ships as a first-party skill. - [Launch an app with persona accounts with Hermes Agent](https://developers.tokportal.com/agents/hermes-agent/app-persona-launch) — Nous Research's open-source agent runtime; MCP servers are declared under `mcp_servers` in `~/.hermes/config.yaml`. - [Launch an app with persona accounts with Gemini CLI](https://developers.tokportal.com/agents/gemini-cli/app-persona-launch) — Google's open-source terminal agent for Gemini; MCP servers via `gemini mcp add` or `~/.gemini/settings.json`, plus extensions. - [Launch an app with persona accounts with Goose](https://developers.tokportal.com/agents/goose/app-persona-launch) — Block's open-source local agent; remote MCP servers are added as extensions (Streaming HTTP) or via a `goose://` deeplink. - [Launch an app with persona accounts with Perplexity](https://developers.tokportal.com/agents/perplexity/app-persona-launch) — Answer engine with custom MCP connectors on paid plans; good for read-only research over your TokPortal data. - [Launch an app with persona accounts with Microsoft Copilot Studio](https://developers.tokportal.com/agents/copilot-studio/app-persona-launch) — Microsoft's low-code agent builder; MCP servers are added as tools through the MCP onboarding wizard (Streamable transport). - [Launch an app with persona accounts with Factory Droid](https://developers.tokportal.com/agents/factory-droid/app-persona-launch) — Factory's software-engineering agent (`droid` CLI); HTTP MCP servers are added with `droid mcp add`. - [Launch an app with persona accounts with n8n](https://developers.tokportal.com/agents/n8n/app-persona-launch) — 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. - [Launch an app with persona accounts with Make](https://developers.tokportal.com/agents/make/app-persona-launch) — Visual automation platform (ex-Integromat); call TokPortal from HTTP modules with `X-API-Key`, or from Make's MCP Client module where available. - [Launch an app with persona accounts with Zapier](https://developers.tokportal.com/agents/zapier/app-persona-launch) — Automation platform; today TokPortal is used via Webhooks by Zapier (REST) — a native TokPortal app is coming. - [Launch an app with persona accounts with Pipedream](https://developers.tokportal.com/agents/pipedream/app-persona-launch) — 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. - [Launch an app with persona accounts with Dify](https://developers.tokportal.com/agents/dify/app-persona-launch) — Open-source LLM app platform; MCP servers are registered under Tools → MCP and used by Agent nodes and Agent apps. - [Launch an app with persona accounts with Flowise](https://developers.tokportal.com/agents/flowise/app-persona-launch) — Open-source visual builder for LLM flows; the Custom MCP node connects any Streamable HTTP server to Agentflow / tool agents. - [Launch an app with persona accounts with Langflow](https://developers.tokportal.com/agents/langflow/app-persona-launch) — Open-source visual framework for agents; the MCP Tools component connects to servers registered in Settings → MCP Servers. - [Launch an app with persona accounts with CrewAI](https://developers.tokportal.com/agents/crewai/app-persona-launch) — Python multi-agent framework; `MCPServerAdapter` from `crewai-tools` turns any MCP server into agent tools. - [Launch an app with persona accounts with LangChain](https://developers.tokportal.com/agents/langchain/app-persona-launch) — LangChain / LangGraph agents load MCP tools with `langchain-mcp-adapters` (`MultiServerMCPClient`). - [Launch an app with persona accounts with Vercel AI SDK](https://developers.tokportal.com/agents/vercel-ai-sdk/app-persona-launch) — TypeScript toolkit for AI apps; the MCP client (`@ai-sdk/mcp`, formerly `experimental_createMCPClient` in `ai`) turns TokPortal tools into `generateText`/`streamText` tools. - [Launch an app with persona accounts with Mastra](https://developers.tokportal.com/agents/mastra/app-persona-launch) — TypeScript agent framework; `MCPClient` from `@mastra/mcp` connects HTTP or stdio MCP servers and hands their tools to an `Agent`. ## Related - [DTC multi-market launch](https://developers.tokportal.com/use-cases/industry/dtc-multi-market-launch) - [Account configuration](https://developers.tokportal.com/account-configuration) - [Webhooks](https://developers.tokportal.com/webhooks) - [Analytics API](https://developers.tokportal.com/analytics) - [MCP server](https://developers.tokportal.com/mcp) - [All agents](https://developers.tokportal.com/agents)