Use TokPortal from Claude

Claude is a chat assistant: Anthropic's assistant on claude.ai, the mobile apps and Claude Desktop, with custom MCP connectors. Connected to the TokPortal MCP server (or the REST API), it can create geo-targeted TikTok and Instagram accounts, schedule videos, warm accounts, read analytics and follow the ban lifecycle — 91 tokportal_* tools generated from the public OpenAPI schema.

Connect TokPortal to Claude

Add to claude.ai All hosts

Custom connector with OAuth — nothing to paste except the URL:

Settings → Connectors → Add custom connector.
URL: https://app.tokportal.com/api/ext/mcp
Sign in to TokPortal, choose Full access or Read-only, click Authorize.

Works on claude.ai web, the Claude mobile apps and Claude Desktop. Full walkthrough: Remote connector.

Snippet status: verified against Claude's documentation (source).

Try it

Evaluate this workflow in the TokPortal sandbox only.
Use the remote MCP endpoint https://app.tokportal.com/api/ext/mcp or local tokportal-mcp 1.15.1 or later for write tools.
Verify the installed local version before using its write tools. Version 1.15.0 is unsafe for simulations.
If the local version is older or unknown, use the remote endpoint or authenticated REST
requests with X-TokPortal-Dry-Run: true instead.
For every non-GET MCP tool call, set dry_run: true as a top-level boolean beside body.
For every REST write in a workflow, send the X-TokPortal-Dry-Run: true header.
Use normal read tools for existing real objects. Do not GET or poll synthetic IDs,
and do not upload files to simulated upload URLs. Simulated objects have no cross-call memory.
Show credits_would_charge and verify credits_charged is 0 for each simulated write.
Do not execute any live write. Ask for my explicit GO before the first real write,
including bundle creation, which charges immediately. After GO, repeat creation
without dry_run and use the new real IDs; never reuse synthetic IDs in live requests.

Use the TokPortal tools.
First call tokportal_get_credit_balance and tokportal_get_credit_costs.
Then tell me what one US TikTok account with 10 videos would cost before creating anything.

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

Try a free account-creation request

Evaluate this workflow in the TokPortal sandbox only.
Use the remote MCP endpoint https://app.tokportal.com/api/ext/mcp or local tokportal-mcp 1.15.1 or later for write tools.
Verify the installed local version before using its write tools. Version 1.15.0 is unsafe for simulations.
If the local version is older or unknown, use the remote endpoint or authenticated REST
requests with X-TokPortal-Dry-Run: true instead.
For every non-GET MCP tool call, set dry_run: true as a top-level boolean beside body.
For every REST write in a workflow, send the X-TokPortal-Dry-Run: true header.
Use normal read tools for existing real objects. Do not GET or poll synthetic IDs,
and do not upload files to simulated upload URLs. Simulated objects have no cross-call memory.
Show credits_would_charge and verify credits_charged is 0 for each simulated write.
Do not execute any live write. Ask for my explicit GO before the first real write,
including bundle creation, which charges immediately. After GO, repeat creation
without dry_run and use the new real IDs; never reuse synthetic IDs in live requests.

Use the TokPortal MCP tools. Call tokportal_list_countries, then simulate tokportal_create_bundle with bundle_type account_only, platform tiktok and a country returned as available for new accounts. Show the returned credits_would_charge. If your connector is read-only, explain which scope is missing instead of making a live request.

Jobs you can run from Claude

Create TikTok accounts — Create geo-targeted TikTok accounts from Claude with the TokPortal MCP tools: create_bundle → configure_bundle_account → publish_bundle → list_accounts.
Post 100 TikTok videos a day — Post 100+ TikTok videos a day from Claude: spread slots across ≥34 TokPortal bundles (3 videos/day/bundle cap), batch-configure, publish, track finalization.
Run US TikTok accounts from abroad — Operate US TikTok accounts from anywhere with Claude: TokPortal creates and posts on accounts held by US-based managers — no VPN, no US SIM, no per-account OAuth.
Warm TikTok & Instagram accounts — Warm accounts on niche search terms from Claude: generate_warming_terms → configure_bundle_warming_terms / rewarm_account, verified sessions, warming.* webhooks.
Run a faceless TikTok channel — Run a faceless TikTok channel from Claude: AI-generated clips → upload_video → 3 dated posts a day via batch_configure_bundle_videos, AI label on, human-operated account.
Seed UGC across many accounts — Seed UGC from Claude: the same creative on N geo-targeted TikTok/Instagram accounts via create_bundles_bulk, disclose_as_ads, per-account analytics.
Seed a music sound on TikTok — Seed a TikTok sound from Claude: many geo-targeted accounts posting with tiktok_sound_url on the same track, staggered dates, per-video analytics for the label.
Launch an app with persona accounts — Launch an app with persona accounts from Claude: several TikTok/Instagram characters, each a managed account with bio link, warming and a 30-day content plan.
Run multi-client agency operations — Run an agency's TikTok/Instagram operations from Claude: per-client external_ref, bulk account fleets, videos_only reposting, ban webhooks and per-client analytics exports.
Get ban alerts via webhooks — Get TikTok/Instagram ban alerts from Claude: create_webhook_endpoint for account.banned, ban_appeal.submitted, ban_resolution.decided; list_account_bans as source of truth.
Pull analytics across all accounts — Pull TikTok/Instagram analytics across every managed account from Claude: get_analytics_dashboard, get_analytics_series, list_account_video_analytics, CSV/HTML exports.
Create Instagram accounts — Create geo-targeted Instagram accounts from Claude with TokPortal: create_bundle platform=instagram → configure_bundle_account → publish_bundle; Reels, posts, carousels.

Other agents

Claude Code · ChatGPT · OpenAI Codex · Cursor · Windsurf · Cline · OpenClaw · Hermes Agent · Gemini CLI · Goose · Perplexity · Microsoft Copilot Studio · Factory Droid · n8n · Make · Zapier · Pipedream · Dify · Flowise · Langflow · CrewAI · LangChain · Vercel AI SDK · Mastra

See also: MCP server · Getting started · Credits & Pricing.