TokPortal

TokPortal is the managed social infrastructure API: real TikTok, Instagram and YouTube accounts created, warmed and operated by human account managers in 16+ countries — exposed as a REST API and an MCP server. No OAuth per account, no 25-posts/day cap, no app review.

Docshttps://developers.tokportal.com· API basehttps://app.tokportal.com/api/ext· OpenAPIhttps://developers.tokportal.com/openapi.json· MCP remotehttps://app.tokportal.com/api/ext/mcp· Get an API keyhttps://app.tokportal.com/developer/api-keys· llms.txthttps://developers.tokportal.com/llms.txt

tokportal-mcpis the officialModel Context Protocolserver for the TokPortal API. It exposes every public API operation (91 tools) to Claude, Cursor, VS Code, Windsurf, Codex, Gemini CLI and any other MCP client — create bundles, upload videos, configure and publish accounts, read analytics, manage webhooks.

Requires Node.js 20 or newer for the local server. Get an API key athttps://app.tokportal.com/developer/api-keys(formatsk_+ 64 hex chars).

npm install -g tokportal-mcp TOKPORTAL_API_KEY=sk_your_key_here tokportal-mcp

import { Client } from "@modelcontextprotocol/sdk/client/index.js"; import { StdioClientTransport } from "@modelcontextprotocol/sdk/client/stdio.js"; const client = new Client({ name: "demo", version: "1.0.0" }); await client.connect( new StdioClientTransport({ command: "npx", args: ["-y", "tokportal-mcp"], env: { ...process.env, TOKPORTAL_API_KEY: process.env.TOKPORTAL_API_KEY }, }), ); const { tools } = await client.listTools(); // 91 tools const me = await client.callTool({ name: "tokportal_get_current_user", arguments: {} }); console.log(tools.length, me.content[0].text);

Replacesk_your_key_herewith your key. Every snippet below is the local stdio server; the remote URL variant is listed at the end.

~/.cursor/mcp.json(or.cursor/mcp.jsonin a project):

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

claude_desktop_config.json(macOS:~/Library/Application Support/Claude/, Windows:%APPDATA%\Claude\):

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

claude mcp add tokportal -e TOKPORTAL_API_KEY=sk_your_key_here -- npx -y tokportal-mcp # or the remote server: claude mcp add --transport http tokportal https://app.tokportal.com/api/ext/mcp --header "X-API-Key: sk_your_key_here"

{ "servers": { "tokportal": { "type": "stdio", "command": "npx", "args": ["-y", "tokportal-mcp"], "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" } } } }

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

[mcp_servers.tokportal] command = "npx" args = ["-y", "tokportal-mcp"] env = { TOKPORTAL_API_KEY = "sk_your_key_here" }

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

Any client that supports remote MCP servers can connect tohttps://app.tokportal.com/api/ext/mcpwith either anX-API-Key: sk_...header orAuthorization: Bearer sk_.... Example for clients using theurlform:

{ "mcpServers": { "tokportal": { "url": "https://app.tokportal.com/api/ext/mcp", "headers": { "X-API-Key": "sk_your_key_here" } } } }

The server exposes TokPortal API actions as MCP tools over stdio. It is generated from the public API schema and uses the sameX-API-Keyauthentication as the HTTP API.

- Tool names aretokportal_<operation_id_snake_case>(tokportal_create_bundle,tokportal_list_accounts, ...). Path and query parameters are top-level inputs; JSON bodies go inbody.
- Every tool carries MCP annotations:title,readOnlyHint(GET),destructiveHint(DELETE / cancel / unpublish / reset / unschedule / revoke),idempotentHint(GET/PUT/DELETE) andopenWorldHint: false, so clients can ask for confirmation on destructive calls.
- Multipart upload tools are generated from OpenAPI too. Binary fields are exposed as local path inputs such asfile_path, with the remaining form fields exposed by their schema names.
- Mutations accept an optionalidempotency_key(sent asIdempotency-Key) except for secret-bearing operations (credential reveal, verification codes, webhook creation, signed upload URLs, report creation) which are never replayed.

The MCP server sendsX-TokPortal-Client: tokportal-mcp/1.12.1on API requests for observability and support diagnostics.

Failed tool calls return an error result with adiagnosticsobject containingrequest_id,retry_after_seconds, andrate_limitwhen those headers are available.

Legacy config using the globally installed binary still works:

{ "mcpServers": { "tokportal": { "command": "tokportal-mcp", "env": { "TOKPORTAL_API_KEY": "sk_your_key_here" } } } }

This package is generated from the TokPortal public OpenAPI schema (https://developers.tokportal.com/openapi.json) in the private TokPortal monorepo.src/generated.tsis regenerated on every release — do not edit it by hand. SeeCONTRIBUTING.mdfor what we accept as PRs andSECURITY.mdfor vulnerability reporting.

- Documentation:https://developers.tokportal.com
- MCP guide:https://developers.tokportal.com/mcp
- SDKs & CLI:https://developers.tokportal.com/sdks-cli
- API reference (OpenAPI):https://developers.tokportal.com/openapi.json
- Other packages:@tokportal/node·@tokportal/cli·tokportal(PyPI)·github.com/tokportal/tokportal-go

Your YouTube AI Assistant To Create More Videos And Save 10+ Hours A Week