Agents × jobs

Use TokPortal from Claude Code

Connect Claude Code to the TokPortal MCP server and run 12 social-media jobs: create TikTok/Instagram accounts, post at scale, warm accounts, ban webhoo…

Claude Code is a terminal agent: Anthropic's terminal coding agent; MCP servers are added with claude mcp add and used in any session. 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 Code

Remote (OAuth, recommended):

claude mcp add --transport http tokportal https://app.tokportal.com/api/ext/mcp

Then run /mcp inside Claude Code and authenticate in the browser. Local stdio alternative with an API key:

claude mcp add tokportal -e TOKPORTAL_API_KEY=sk_... -- npx -y tokportal-mcp

Prefer a packaged install? The TokPortal plugin ships the MCP server plus slash commands:

claude plugin marketplace add tokportal/claude-plugin
claude plugin install tokportal@tokportal

Snippet status: verified against Claude Code's documentation (source). Dedicated guide: Claude Code + TokPortal.

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.

Using the tokportal MCP tools, list my bundles with status published
and for each one show how many videos are configured vs finalized.
Do not create anything yet.

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 Code

  • Create TikTok accounts — Create geo-targeted TikTok accounts from Claude Code 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 Code: 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 Code: 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 Code: 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 Code: 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 Code: 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 Code: 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 Code: 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 Code: 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 Code: 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 Code: get_analytics_dashboard, get_analytics_series, list_account_video_analytics, CSV/HTML exports.
  • Create Instagram accounts — Create geo-targeted Instagram accounts from Claude Code with TokPortal: create_bundle platform=instagram → configure_bundle_account → publish_bundle; Reels, posts, carousels.

Other agents

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