# TokPortal

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: tokportal
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/tokportal/tokportal-mcp
- Updated: 2026-10-16
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/tokportal

## What it 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.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://app.tokportal.com/api/ext/mcp`
- Environment variables: `TOKPORTAL_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://app.tokportal.com/api/ext/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> --transport stdio tokportal -- npx -y tokportal-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add tokportal --url https://app.tokportal.com/api/ext/mcp
```

2. **Platform CLI**
```bash
codex mcp add tokportal --env TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> -- npx -y tokportal-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tokportal": {
            "url": "https://app.tokportal.com/api/ext/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "tokportal": {
            "command": "npx",
            "args": [
                "-y",
                "tokportal-mcp"
            ],
            "env": {
                "TOKPORTAL_API_KEY": "<TOKPORTAL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tokportal": {
            "type": "http",
            "url": "https://app.tokportal.com/api/ext/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "tokportal": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "tokportal-mcp"
            ],
            "env": {
                "TOKPORTAL_API_KEY": "<TOKPORTAL_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http tokportal https://app.tokportal.com/api/ext/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e TOKPORTAL_API_KEY=<TOKPORTAL_API_KEY> tokportal npx -y tokportal-mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [Upload-Post](https://affpapa.org/en/nevibecode/mcp/upload-post.md) — MCP server · ★ 21 repo stars
- [social-short-production](https://affpapa.org/en/nevibecode/skills/social-short-production.md) — skill · 263 installs
- [caption-writer-sms](https://affpapa.org/en/nevibecode/skills/caption-writer-sms.md) — skill · 2100 installs
- [content-planner](https://affpapa.org/en/nevibecode/skills/content-planner.md) — skill · 297 installs
- [xpoz](https://affpapa.org/en/nevibecode/mcp/xpoz.md) — MCP server · 4846 installs
- [Mysocial](https://affpapa.org/en/nevibecode/mcp/mysocial.md) — MCP server

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
