Use TokPortal from Mastra

Mastra is an agent framework (code): TypeScript agent framework; MCPClient from @mastra/mcp connects HTTP or stdio MCP servers and hands their tools to an Agent. 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 Mastra

npm i @mastra/core @mastra/mcp

import { Agent } from '@mastra/core/agent';
import { MCPClient } from '@mastra/mcp';

const mcp = new MCPClient({
  servers: {
    tokportal: {
      url: new URL('https://app.tokportal.com/api/ext/mcp'),
      requestInit: {
        headers: { 'X-API-Key': process.env.TOKPORTAL_API_KEY! },
      },
    },
  },
  timeout: 30000,
});

export const socialOps = new Agent({
  id: 'social-ops',
  name: 'Social ops',
  instructions: 'You operate TikTok and Instagram accounts through TokPortal tools. Quote credit costs before creating bundles.',
  model: 'anthropic/claude-sonnet-4-5',
  tools: await mcp.listTools(),
});

Tools are namespaced tokportal_tokportal_* (server name + tool name). Use mcp.listToolsets() to pass tools per request instead of at construction, and mcp.disconnect() on shutdown.

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

Try it

await socialOps.generate("List accounts on Instagram in FR, then
tell me which have no video posted in the last 14 days using
tokportal_list_account_video_analytics.")

Jobs you can run from Mastra

• Create TikTok accounts — Create geo-targeted TikTok accounts from Mastra 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 Mastra: 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 Mastra: 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 Mastra: generate_warming_terms → configure_bundle_warming_terms / rewarm_account, verified sessions, warming.* webhooks.
• Run a faceless TikTok channel — Run a faceless TikTok channel from Mastra: 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 Mastra: 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 Mastra: 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 Mastra: 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 Mastra: 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 Mastra: 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 Mastra: get_analytics_dashboard, get_analytics_series, list_account_video_analytics, CSV/HTML exports.
• Create Instagram accounts — Create geo-targeted Instagram accounts from Mastra with TokPortal: create_bundle platform=instagram → configure_bundle_account → publish_bundle; Reels, posts, carousels.

Other agents

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

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