tokportal-mcp

TokPortal es la API de infraestructura social gestionada: cuentas reales de TikTok, Instagram y YouTube creadas, calentadas y operadas por gestores de cuentas humanos en más de 16 países, expuestas como una API REST y un servidor MCP. Sin OAuth por cuenta, sin límite de 25 publicaciones/día, sin revisión de la aplicación.

Documentación https://developers.tokportal.com · API base https://app.tokportal.com/api/ext · OpenAPI https://developers.tokportal.com/openapi.json · MCP remoto https://app.tokportal.com/api/ext/mcp · Obtén una clave API https://app.tokportal.com/developer/api-keys · llms.txt https://developers.tokportal.com/llms.txt

tokportal-mcp es el servidor oficial del Model Context Protocol para la API de TokPortal. Expone todas las operaciones de la API pública (91 herramientas) a Claude, Cursor, VS Code, Windsurf, Codex, Gemini CLI y cualquier otro cliente MCP: crear paquetes, subir vídeos, configurar y publicar cuentas, leer análisis, gestionar webhooks.

Dos formas de usarlo:

Requiere Node.js 20 o superior para el servidor local. Obtén una clave API en https://app.tokportal.com/developer/api-keys (formato sk_ + 64 caracteres hexadecimales).

Inicio rápido en 30 segundos

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

El servidor habla MCP sobre stdio. Apunta cualquier cliente MCP hacia él y pide, por ejemplo:

"Crea un paquete de TikTok en EE. UU. con 5 vídeos, sube ./launch.mp4 como vídeo 1 con el título 'Day 1', luego publica el paquete."

Esa cadena de llamadas usa tokportal_create_bundle → tokportal_upload_video_direct → tokportal_configure_bundle_video → tokportal_publish_bundle.

Prueba programática con el SDK de 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);

Configuración del cliente

Reemplaza sk_your_key_here con tu clave. Cada fragmento a continuación es para el servidor local stdio; la variante de URL remota se lista al final.

Cursor

~/.cursor/mcp.json (o .cursor/mcp.json en un proyecto):

{
  "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 (modo agente de GitHub Copilot)

.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" }
    }
  }
}

Servidor remoto (Streamable HTTP)

Cualquier cliente que admita servidores MCP remotos puede conectarse a https://app.tokportal.com/api/ext/mcp con una cabecera X-API-Key: sk_... o Authorization: Bearer sk_.... Ejemplo para clientes que usan el formato url:

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

Variables de entorno

Cómo funcionan las herramientas

El servidor expone las acciones de la API de TokPortal como herramientas MCP sobre stdio. Se genera a partir del esquema de la API pública y usa la misma autenticación X-API-Key que la API HTTP.

• Los nombres de las herramientas son tokportal_<operation_id_snake_case> (tokportal_create_bundle, tokportal_list_accounts, ...). Los parámetros de ruta y consulta son entradas de primer nivel; los cuerpos JSON van en body.

• Cada herramienta lleva anotaciones MCP: title, readOnlyHint (GET), destructiveHint (DELETE / cancel / unpublish / reset / unschedule / revoke), idempotentHint (GET/PUT/DELETE) y openWorldHint: false, para que los clientes puedan pedir confirmación en llamadas destructivas.

• Las herramientas de subida multiparte también se generan desde OpenAPI. Los campos binarios se exponen como entradas de ruta local como file_path, y el resto de campos del formulario se exponen con sus nombres de esquema.

• Las mutaciones aceptan un idempotency_key opcional (enviado como Idempotency-Key) excepto para operaciones que contienen secretos (revelación de credenciales, códigos de verificación, creación de webhooks, URLs de subida firmadas, creación de informes) que nunca se repiten.

El servidor MCP envía X-TokPortal-Client: tokportal-mcp/1.12.1 en las solicitudes API para observabilidad y diagnóstico de soporte.

Las llamadas a herramientas fallidas devuelven un resultado de error con un objeto diagnostics que contiene request_id, retry_after_seconds y rate_limit cuando esas cabeceras están disponibles.

La configuración heredada usando el binario instalado globalmente aún funciona:

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

Fuente de verdad

Este paquete se genera a partir del esquema OpenAPI público de TokPortal (https://developers.tokportal.com/openapi.json) en el monorepositorio privado de TokPortal. src/generated.ts se regenera en cada versión — no lo edites manualmente. Consulta CONTRIBUTING.md para saber qué aceptamos como PRs y SECURITY.md para informar vulnerabilidades.

Enlaces

• Documentación: https://developers.tokportal.com

• Guía MCP: https://developers.tokportal.com/mcp

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

• Referencia de la API (OpenAPI): https://developers.tokportal.com/openapi.json

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

MIT © TokPortal