Log inSubmit server
Tiktok Agent Publisher logo

Tiktok Agent Publisher

by davidmosiah

Publishes TikTok videos through MCP or CLI with dry-run defaults, OAuth checks, structured output, and explicitly enabled live uploads.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Tiktok Agent Publisher

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "davidmosiah-tiktok-agent-publisher": {
      "command": "npx",
      "args": [
        "-y",
        "-p",
        "tiktok-agent-publisher",
        "tiktok-agent-mcp"
      ],
      "env": {
        "TIKTOK_CLIENT_KEY": "YOUR_VALUE_HERE",
        "TIKTOK_CLIENT_SECRET": "YOUR_VALUE_HERE",
        "TIKTOK_ACCESS_TOKEN": "YOUR_VALUE_HERE",
        "TIKTOK_REFRESH_TOKEN": "YOUR_VALUE_HERE",
        "TIKTOK_DRY_RUN": "YOUR_VALUE_HERE",
        "TIKTOK_MCP_HOST": "YOUR_VALUE_HERE",
        "TIKTOK_MCP_PORT": "YOUR_VALUE_HERE",
        "TIKTOK_MCP_TRANSPORT": "YOUR_VALUE_HERE"
      }
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Values are written into the snippet above so you can paste it as is. They never leave your browser.

We couldn’t confirm it starts correctly

We ran the install command but it didn't respond within our test window — this can mean a slow first-time install rather than a real problem.

npx -y -p tiktok-agent-publisher tiktok-agent-mcp

No response to initialize.

This is an experimental automated check and can have false negatives — missing environment variables, a slow cold install, etc. It doesn’t necessarily mean something’s wrong. Last checked 1mo ago.

Overview

The davidmosiah/tiktok-agent-publisher MCP server gives agents a local-first interface for checking TikTok readiness, preparing video posts, polling publish status, and listing recent videos. It uses TikTok's official Content Posting API, supports stdio by default, and can optionally expose a loopback Streamable HTTP endpoint. Dry-run mode is enabled by default, while live publishing requires configured credentials, a clean readiness check, and explicit opt-in. Reach for it when an agent needs structured TikTok publishing without browser automation or exposing token values.

Use cases

  • Check TikTok OAuth and media readiness before publishing
  • Build and test video publish workflows in dry-run mode
  • Publish owned videos through TikTok's official API
  • Poll publish status and verify recent videos
  • Audit token and live-publishing boundaries

Key features

  • MCP tools over stdio
  • Optional loopback Streamable HTTP transport
  • Dry-run publishing by default
  • OAuth readiness and connection checks
  • Structured JSON publish and status results
  • Privacy audit without returning token values

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked 3d ago

Recent health check succeeded.

17/17 checks healthy over the last 79d

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 2d ago via OSV.dev · tiktok-agent-publisher (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

GitHub stars2Stargazers on the source repository.
npm downloads362Package downloads in the last 30 days.
Last commit7d agoMost recent push to the default branch.
Install checkInconclusiveDidn't respond in our test window — often a slow first install.
Directory activity6 viewsConfig copies, upvotes, and views on AllMCPs.

How Tiktok Agent Publisher works

What davidmosiah/tiktok-agent-publisher MCP server does

The davidmosiah/tiktok-agent-publisher MCP server connects agent workflows to TikTok's official Content Posting API. It exposes MCP tools and a command-line interface for checking connection readiness, reviewing privacy boundaries, creating video publish jobs, checking publish status, and listing recent videos.

The project is designed around an agent workflow rather than an interactive browser session. Responses use structured JSON so an agent can inspect results, retry operations, and record audit information. Readiness checks report whether client credentials, access tokens, refresh tokens, and media hosting prerequisites are present without returning secret values.

How it works

The package runs locally over stdio by default. An optional stateless Streamable HTTP mode listens on loopback and provides a health endpoint plus an MCP endpoint. The MCP surface includes tiktok_agent_manifest, tiktok_connection_status, tiktok_privacy_audit, tiktok_publish_video, tiktok_publish_status, and tiktok_list_videos.

A typical workflow starts with connection status and the privacy audit. In dry-run mode, publishing validates the job, caption, and metadata without calling the live API. It returns a synthetic publish identifier, and status polling reports a dry-run state. Listing videos also returns a valid empty result shape, allowing downstream workflow code to be tested before credentials are available.

Live operation requires OAuth-related configuration and an explicit change from the default dry-run setting. The project also supports an auth-url CLI command for building an OAuth URL from a redirect URI.

Setup and configuration

Install the npm package globally, or invoke it through npx. MCP clients can run the package with a stdio command.

Configuration is read from environment variables or a local .env file. The documented TikTok values include TIKTOK_CLIENT_KEY, TIKTOK_CLIENT_SECRET, TIKTOK_ACCESS_TOKEN, and TIKTOK_REFRESH_TOKEN. TIKTOK_DRY_RUN controls the safety mode; it should remain enabled while validating an agent workflow and be set to false only when live calls are intended. HTTP deployments can set TIKTOK_MCP_HOST, TIKTOK_MCP_PORT, and TIKTOK_MCP_TRANSPORT.

Do not commit .env, token files, or the .agent-data/ directory. The readiness command indicates what is missing and whether live publishing or direct video upload is available.

Limitations and notes

The davidmosiah/tiktok-agent-publisher MCP server does not remove TikTok API or OAuth prerequisites. A dry-run can be exercised without credentials, but live publishing depends on valid TikTok configuration and an OAuth flow. The README specifically requires explicit confirmation before live direct posting and says that agents should publish only content the user owns or is permitted to publish.

Secrets are intended to stay local: tools do not return token values. HTTP mode is documented as loopback-only, so the provided setup is aimed at local agent runtimes rather than an openly hosted service. The material also describes media-hosting readiness, including a public media base URL and Supabase Storage status, but does not establish that every media workflow is available in every configuration.

The package is MIT-licensed and is presented as open-source tooling.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Tiktok Agent Publisher

Install the npm package globally with `npm install -g tiktok-agent-publisher`, or run it through `npx` using the documented MCP configuration.

Dry-run mode is enabled by default. Agents can validate the publish payload without uploading, and live posting requires credentials, readiness checks, and explicitly setting `TIKTOK_DRY_RUN=false`.

The readiness example checks `TIKTOK_CLIENT_KEY`, `TIKTOK_CLIENT_SECRET`, `TIKTOK_ACCESS_TOKEN`, and `TIKTOK_REFRESH_TOKEN`. OAuth completion is also required.

Related MCP servers

All in Social Media All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewTiktok Agent Publisher AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/davidmosiah-tiktok-agent-publisher?style=directory)](https://allmcps.com/mcp/davidmosiah-tiktok-agent-publisher)
HTML Embed
<a href="https://allmcps.com/mcp/davidmosiah-tiktok-agent-publisher"><img src="https://allmcps.com/api/badge/davidmosiah-tiktok-agent-publisher?style=directory" alt="Tiktok Agent Publisher on AllMCPs" /></a>