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
claude mcp add --transport http mcp https://app.tokportal.com/api/ext/mcpWhat 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.mp4to TokPortal, schedule a post in accountacc_12345for tomorrow 15:00 UTC.
How to install TokPortal
1Platform CLI: remote server
claude mcp add --transport http mcp https://app.tokportal.com/api/ext/mcp2Platform CLI
claude mcp add --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> --transport stdio tokportal -- npx -y tokportal-mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add tokportal --url https://app.tokportal.com/api/ext/mcp2Platform CLI
codex mcp add tokportal --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> -- npx -y tokportal-mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"tokportal": {
"url": "https://app.tokportal.com/api/ext/mcp"
}
}
}{
"mcpServers": {
"tokportal": {
"command": "npx",
"args": [
"-y",
"tokportal-mcp"
],
"env": {
"TOKPORTAL_API_KEY": "<TOKPORTAL_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"tokportal": {
"type": "http",
"url": "https://app.tokportal.com/api/ext/mcp"
}
}
}{
"servers": {
"tokportal": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"tokportal-mcp"
],
"env": {
"TOKPORTAL_API_KEY": "<TOKPORTAL_API_KEY>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http tokportal https://app.tokportal.com/api/ext/mcp2Platform CLI
gemini mcp add -e TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> tokportal npx -y tokportal-mcpReplace <…> 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.