Skip to main content
MCP server CX Codex

TokPortal — Claude Code MCP server: what it does, how to install

TokPortal — an MCP server for managing TikTok and Instagram accounts via REST API. Gives agents access to ready accounts handled by human managers in 16+ countries.

MIT ★ 1 updated 2026-10-16

Install into Claude Code · Platform CLI: remote server All methods and platforms ↓
claude mcp add --transport http mcp https://app.tokportal.com/api/ext/mcp
Open on GitHub

What TokPortal does

TokPortal supplies branded TikTok and Instagram accounts created, warmed and maintained by people. The server exposes tools for working with accounts, posts and media via MCP. If AI is turned on for your workspace, seven more tools cover model search, quoted generation and a separate USD wallet.

Runs in two modes: local (npx tokportal-mcp) over stdio for desktop clients and disk file uploads, remote (https://app.tokportal.com/api/ext/mcp) over HTTP for hosted agents with no install. Needs Node.js 20 or later and an API key in the format sk_ plus 64 hex characters.

AI generation needs quote_id, max_cost_usd and idempotency_key. Quotes expire in 15 minutes, the AI wallet is independent of account-management credits. Bundle preview (dry_run: true) returns cost without charging, but uses a synthetic ID that must not be reused in a live request.

What it helps with

  • manage TikTok and Instagram accounts via API without OAuth for each profile
  • roll out content across markets in different countries with pre-made accounts
  • preview bundle cost before purchase via dry_run
  • generate content by quote with a separate dollar balance
  • upload a media file from disk and publish it to social networks

Example prompts for the agent

  • Get a quote for TikTok video generation, check the expiry and return the quote_id.
  • Upload promo.mp4 to TokPortal, schedule a post in account acc_12345 for tomorrow 15:00 UTC.

How to install TokPortal

1Platform CLI: remote server

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

2Platform CLI

claude mcp add --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> --transport stdio tokportal -- npx -y tokportal-mcp

Replace <…> with your own values

Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more

Questions about TokPortal

How to install TokPortal in Claude Code?

Run claude mcp add --transport http tokportal https://app.tokportal.com/api/ext/mcp, then add an X-API-Key header with your key, or claude mcp add --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> --transport stdio tokportal -- npx -y tokportal-mcp for local launch.

What does TokPortal do?

Exposes a REST API for working with ready TikTok and Instagram accounts managed by people. An agent can create bundles, publish content, upload media and generate videos via AI if that feature is enabled in the workspace.

Why use dry_run before buying a bundle?

Preview with dry_run: true returns credits_would_charge without charging credits. The synthetic ID from the response cannot be used in a live request — after confirmation, a real bundle is created with a new ID.

Similar MCP servers

All MCP servers for Marketing and content →

Project sponsors

Companies that keep this analytics open