# Use TokPortal from your AI agent Source: https://developers.tokportal.com/agents/ Markdown: https://developers.tokportal.com/agents.md TokPortal is the managed social infrastructure API: real TikTok and Instagram accounts created, warmed and operated by human account managers in 16+ countries, exposed as a REST API and an MCP server with 91 tools. This section pairs **25 agent hosts** with **12 jobs** — 300 pages, each with the exact connect snippet for the host, the `tokportal_*` tool sequence, a prompt to paste, the REST equivalent, parameters, example configs and FAQ. Start with the host you use, or with the job you need to get done. Every page assumes the same server: remote `https://app.tokportal.com/api/ext/mcp` (OAuth or `X-API-Key`) or local `npx -y tokportal-mcp`. Full install matrix: [MCP server](https://developers.tokportal.com/mcp). ## Try the workflow without spending For this trial, use the remote MCP endpoint `https://app.tokportal.com/api/ext/mcp`, local `tokportal-mcp` **1.15.1 or later**, or the REST API. Upgrade and restart an older local server first. Version 1.15.0 does not forward the dry-run header; do not use its write tools for a simulation. If you cannot verify the installed local version, use the remote endpoint or REST. Use the [sandbox](https://developers.tokportal.com/sandbox) for the first attempt. MCP write tools accept `dry_run: true` as a top-level argument, beside `body`; REST writes accept the `X-TokPortal-Dry-Run: true` header. Keep your usual authentication and scopes. Each simulated write validates the request and returns `credits_would_charge` with `credits_charged: 0`. Nothing is created or published. Simulated IDs start with `00000000-0000-4000-8000-`. Use them only in later dry-run writes. GET requests read real data, so skip publish-readiness checks and polling for synthetic IDs. Simulations have no cross-call memory and upload URLs are placeholders: do not upload files to them. To run for real, review the returned price and confirm **before the first live write**. Bundle creation charges credits immediately; publishing hands the order to a manager. Repeat creation without dry-run mode and use the new real IDs for configuration and publishing. A synthetic ID cannot be reused in a live request. ## Agents ### Chat assistants - [Claude](https://developers.tokportal.com/agents/claude) — Anthropic's assistant on claude.ai, the mobile apps and Claude Desktop, with custom MCP connectors. - [ChatGPT](https://developers.tokportal.com/agents/chatgpt) — OpenAI's assistant; plans with developer mode can add remote MCP servers as custom connectors. - [Perplexity](https://developers.tokportal.com/agents/perplexity) — Answer engine with custom MCP connectors on paid plans; good for read-only research over your TokPortal data. ### Terminal agents - [Claude Code](https://developers.tokportal.com/agents/claude-code) — Anthropic's terminal coding agent; MCP servers are added with `claude mcp add` and used in any session. - [OpenAI Codex](https://developers.tokportal.com/agents/codex) — OpenAI's coding agent (Codex CLI and IDE extension); MCP servers live in `~/.codex/config.toml`. - [Gemini CLI](https://developers.tokportal.com/agents/gemini-cli) — Google's open-source terminal agent for Gemini; MCP servers via `gemini mcp add` or `~/.gemini/settings.json`, plus extensions. - [Factory Droid](https://developers.tokportal.com/agents/factory-droid) — Factory's software-engineering agent (`droid` CLI); HTTP MCP servers are added with `droid mcp add`. ### AI code editors - [Cursor](https://developers.tokportal.com/agents/cursor) — AI code editor with an agent mode; MCP servers are configured in `.cursor/mcp.json` or via a one-click deeplink. - [Windsurf](https://developers.tokportal.com/agents/windsurf) — Codeium's agentic IDE (Cascade); MCP servers are declared in `~/.codeium/windsurf/mcp_config.json`. - [Cline](https://developers.tokportal.com/agents/cline) — Open-source autonomous coding agent for VS Code with an MCP marketplace and per-tool approval. ### Autonomous agents - [OpenClaw](https://developers.tokportal.com/agents/openclaw) — Open-source autonomous agent runtime with a skills registry (ClawHub); TokPortal ships as a first-party skill. - [Hermes Agent](https://developers.tokportal.com/agents/hermes-agent) — Nous Research's open-source agent runtime; MCP servers are declared under `mcp_servers` in `~/.hermes/config.yaml`. - [Goose](https://developers.tokportal.com/agents/goose) — Block's open-source local agent; remote MCP servers are added as extensions (Streaming HTTP) or via a `goose://` deeplink. ### Workflow / low-code platforms - [Microsoft Copilot Studio](https://developers.tokportal.com/agents/copilot-studio) — Microsoft's low-code agent builder; MCP servers are added as tools through the MCP onboarding wizard (Streamable transport). - [n8n](https://developers.tokportal.com/agents/n8n) — Open-source workflow automation; use the built-in MCP Client Tool node with an AI Agent, or the community node `n8n-nodes-tokportal` for deterministic steps. - [Make](https://developers.tokportal.com/agents/make) — Visual automation platform (ex-Integromat); call TokPortal from HTTP modules with `X-API-Key`, or from Make's MCP Client module where available. - [Zapier](https://developers.tokportal.com/agents/zapier) — Automation platform; today TokPortal is used via Webhooks by Zapier (REST) — a native TokPortal app is coming. - [Pipedream](https://developers.tokportal.com/agents/pipedream) — Serverless integration platform for developers; call TokPortal from a Node.js/Python code step or the HTTP action, and receive webhooks on an HTTP trigger. - [Dify](https://developers.tokportal.com/agents/dify) — Open-source LLM app platform; MCP servers are registered under Tools → MCP and used by Agent nodes and Agent apps. - [Flowise](https://developers.tokportal.com/agents/flowise) — Open-source visual builder for LLM flows; the Custom MCP node connects any Streamable HTTP server to Agentflow / tool agents. - [Langflow](https://developers.tokportal.com/agents/langflow) — Open-source visual framework for agents; the MCP Tools component connects to servers registered in Settings → MCP Servers. ### Agent framework (code)s - [CrewAI](https://developers.tokportal.com/agents/crewai) — Python multi-agent framework; `MCPServerAdapter` from `crewai-tools` turns any MCP server into agent tools. - [LangChain](https://developers.tokportal.com/agents/langchain) — LangChain / LangGraph agents load MCP tools with `langchain-mcp-adapters` (`MultiServerMCPClient`). - [Vercel AI SDK](https://developers.tokportal.com/agents/vercel-ai-sdk) — TypeScript toolkit for AI apps; the MCP client (`@ai-sdk/mcp`, formerly `experimental_createMCPClient` in `ai`) turns TokPortal tools into `generateText`/`streamText` tools. - [Mastra](https://developers.tokportal.com/agents/mastra) — TypeScript agent framework; `MCPClient` from `@mastra/mcp` connects HTTP or stdio MCP servers and hands their tools to an `Agent`. ## Jobs - [Create TikTok accounts](https://developers.tokportal.com/agents/for/create-tiktok-accounts) - [Post 100 TikTok videos a day](https://developers.tokportal.com/agents/for/post-100-videos-a-day) - [Run US TikTok accounts from abroad](https://developers.tokportal.com/agents/for/us-tiktok-accounts-from-abroad) - [Warm TikTok & Instagram accounts](https://developers.tokportal.com/agents/for/warm-accounts) - [Run a faceless TikTok channel](https://developers.tokportal.com/agents/for/faceless-channel) - [Seed UGC across many accounts](https://developers.tokportal.com/agents/for/ugc-seeding) - [Seed a music sound on TikTok](https://developers.tokportal.com/agents/for/music-sound-seeding) - [Launch an app with persona accounts](https://developers.tokportal.com/agents/for/app-persona-launch) - [Run multi-client agency operations](https://developers.tokportal.com/agents/for/agency-multi-client) - [Get ban alerts via webhooks](https://developers.tokportal.com/agents/for/ban-webhooks) - [Pull analytics across all accounts](https://developers.tokportal.com/agents/for/analytics-multi-account) - [Create Instagram accounts](https://developers.tokportal.com/agents/for/create-instagram-accounts) ## How the matrix is built The pages are generated from two data files (`content/agents/agents.yaml`, `content/agents/jtbd.yaml`) and the public OpenAPI schema, so tool names and parameters stay in sync with the API. Each host snippet is marked *verified* (checked against the host's documentation) or *best-effort*. Something wrong for your host? Email .