Skip to main content

TokPortal + Claude Code

Connect TokPortal to Claude Code (or Claude Desktop) and manage your entire social media operation from the terminal using natural language.

Setup​

Add to your Claude configuration file:

{
  "mcpServers": {
    "tokportal": {
      "command": "npx",
      "args": ["-y", "tokportal-mcp"],
      "env": {
        "TOKPORTAL_API_KEY": "tok_live_your_key_here"
      }
    }
  }
}

For Claude Desktop, this goes in claude_desktop_config.json. For Claude Code, add it to your project's MCP configuration.

Get your API key from the Developer Portal.

Real workflows​

Launch a multi-country campaign​

"Create TikTok and Instagram accounts in the US, UK, and Germany. 10 videos each, niche warming for tech/SaaS content. Show me the total credit cost before proceeding."

Claude calls get_credit_costs to calculate, then create_bulk_bundles to execute.

Import videos from a spreadsheet​

"I have a CSV at this Google Sheets URL with 50 rows of video data. Import them into my latest bundle."

Claude calls the CSV import endpoint, which downloads each video, uploads it to TokPortal storage, and configures the video slots.

Daily analytics report​

"Show me all my accounts with their follower counts, total views, and engagement rates. Sort by engagement rate, highest first."

Claude calls list_accounts, then get_analytics for each one, and presents a formatted table.

Content review workflow​

"List all my bundles that have videos in 'in_review' status. For each one, show the video descriptions and current status."

Claude calls list_bundles, then get_bundle for each with in-review content.

32 tools at your fingertips​

Claude gets access to the full TokPortal API through 32 MCP tools — account creation, video configuration, publishing, analytics, verification codes, and more. No HTTP calls to write. No JSON to format. Just describe what you want.

See the full tool list.

What's next​