tokportal-mcp

TokPortal ist die verwaltete soziale Infrastruktur-API: echte TikTok-, Instagram- und YouTube-Konten, die von menschlichen Account-Managern in 16+ Ländern erstellt, aufgewärmt und betrieben werden – bereitgestellt als REST-API und MCP-Server. Kein OAuth pro Konto, kein 25-Posts/Tag-Limit, keine App-Überprüfung.

Dokumentation https://developers.tokportal.com · API-Basis https://app.tokportal.com/api/ext · OpenAPI https://developers.tokportal.com/openapi.json · MCP-Remote https://app.tokportal.com/api/ext/mcp · API-Schlüssel anfordern https://app.tokportal.com/developer/api-keys · llms.txt https://developers.tokportal.com/llms.txt

tokportal-mcp ist der offizielle Model Context Protocol-Server für die TokPortal-API. Er stellt alle öffentlichen API-Operationen (91 Werkzeuge) für Claude, Cursor, VS Code, Windsurf, Codex, Gemini CLI und jeden anderen MCP-Client bereit – Bundles erstellen, Videos hochladen, Konten konfigurieren und veröffentlichen, Analysen lesen, Webhooks verwalten.

Zwei Verwendungsmöglichkeiten:

Erfordert Node.js 20 oder neuer für den lokalen Server. API-Schlüssel unter https://app.tokportal.com/developer/api-keys anfordern (Format sk_ + 64 Hex-Zeichen).

30-Sekunden-Schnellstart

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

Der Server spricht MCP über stdio. Richten Sie einen beliebigen MCP-Client darauf aus und fragen Sie zum Beispiel:

„Erstelle ein TikTok-Bundle in den USA mit 5 Videos, lade ./launch.mp4 als Video 1 mit der Beschreibung 'Tag 1' hoch und veröffentliche dann das Bundle.“

Diese Aufrufkette verwendet tokportal_create_bundle → tokportal_upload_video_direct → tokportal_configure_bundle_video → tokportal_publish_bundle.

Programmatischer Smoke-Test mit dem MCP-SDK:

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);

Client-Konfiguration

Ersetzen Sie sk_your_key_here durch Ihren Schlüssel. Jeder folgende Ausschnitt bezieht sich auf den lokalen stdio-Server; die Remote-URL-Variante ist am Ende aufgeführt.

Cursor

~/.cursor/mcp.json (oder .cursor/mcp.json in einem Projekt):

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

Claude Desktop

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 Code

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"

VS Code (GitHub Copilot Agentenmodus)

.vscode/mcp.json:

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

Windsurf

~/.codeium/windsurf/mcp_config.json:

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

OpenAI Codex CLI

~/.codex/config.toml:

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

Gemini CLI

~/.gemini/settings.json:

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

Remote-Server (Streamable HTTP)

Jeder Client, der Remote-MCP-Server unterstützt, kann sich mit einem X-API-Key: sk_...-Header oder Authorization: Bearer sk_... mit https://app.tokportal.com/api/ext/mcp verbinden. Beispiel für Clients, die das url-Format verwenden:

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

Umgebungsvariablen

Wie die Werkzeuge funktionieren

Der Server stellt TokPortal-API-Aktionen als MCP-Werkzeuge über stdio bereit. Er wird aus dem öffentlichen API-Schema generiert und verwendet die gleiche X-API-Key-Authentifizierung wie die HTTP-API.

• Werkzeugnamen sind tokportal_<operation_id_snake_case> (tokportal_create_bundle, tokportal_list_accounts, ...). Pfad- und Query-Parameter sind Eingaben der obersten Ebene; JSON-Bodies werden in body übergeben.

• Jedes Werkzeug trägt MCP-Anmerkungen: title, readOnlyHint (GET), destructiveHint (DELETE / cancel / unpublish / reset / unschedule / revoke), idempotentHint (GET/PUT/DELETE) und openWorldHint: false, sodass Clients bei destruktiven Aufrufen um Bestätigung bitten können.

• Multipart-Upload-Werkzeuge werden ebenfalls aus OpenAPI generiert. Binäre Felder werden als lokale Pfadeingaben wie file_path bereitgestellt, die restlichen Formularfelder unter ihren Schema-Namen.

• Mutationen akzeptieren einen optionalen idempotency_key (gesendet als Idempotency-Key), außer bei geheimnistragenden Operationen (Credential-Offenlegung, Verifizierungscodes, Webhook-Erstellung, signierte Upload-URLs, Berichtserstellung), die nie wiederholt werden.

Der MCP-Server sendet bei API-Anfragen X-TokPortal-Client: tokportal-mcp/1.12.1 für Beobachtbarkeit und Support-Diagnose.

Fehlgeschlagene Werkzeugaufrufe geben ein Fehlerergebnis mit einem diagnostics-Objekt zurück, das request_id, retry_after_seconds und rate_limit enthält, wenn diese Header verfügbar sind.

Legacy-Konfiguration mit dem global installierten Binary funktioniert weiterhin:

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

Quelle der Wahrheit

Dieses Paket wird aus dem öffentlichen TokPortal OpenAPI-Schema (https://developers.tokportal.com/openapi.json) im privaten TokPortal-Monorepo generiert. src/generated.ts wird bei jeder Veröffentlichung neu generiert – bearbeiten Sie es nicht von Hand. Siehe CONTRIBUTING.md für das, was wir als PRs akzeptieren, und SECURITY.md für die Meldung von Schwachstellen.

Links

• Dokumentation: https://developers.tokportal.com

• MCP-Leitfaden: https://developers.tokportal.com/mcp

• SDKs & CLI: https://developers.tokportal.com/sdks-cli

• API-Referenz (OpenAPI): https://developers.tokportal.com/openapi.json

• Andere Pakete: @tokportal/node · @tokportal/cli · tokportal (PyPI) · github.com/tokportal/tokportal-go

MIT © TokPortal