TikTok MCP Server: Post Videos From AI Agents
Short answer: the TimeToPost MCP server posts videos and photos to TikTok through the official Direct Post API. TikTok requires the person posting to choose the audience and the comment, duet and stitch settings, so the agent first calls get_tiktok_creator_info, asks you, then sends your six answers in platformData.tiktok. One account and one video or photo per post.
Connect your agent to TikTokBy the TimeToPost team. Last reviewed 2026-11-07.
Connect TikTok to your agent
- Ask the agent for connect_account_link with provider "tiktok" and approve in the browser. TimeToPost asks TikTok for two scopes only: user.info.basic and video.publish.
- Before every post the agent calls get_tiktok_creator_info. TikTok forbids caching that answer between posting sessions.
- The agent shows you the audiences and switches it got back and sends your choices. Nothing is pre-selected for you.
The server URL is https://api.timetopost.co/mcp (Streamable HTTP, browser sign in). Client setup files: Claude Code, Cursor, Codex, ChatGPT, Gemini, n8n.
TikTok rules the server enforces
| Rule | TikTok |
|---|---|
| Caption | 2,200 characters (photo posts: title cut to 90, description up to 4,000) |
| Media | Required, one item per post: one video or one photo |
| Video | MP4, MOV or WebM, up to 500 MB, no longer than the account's max_video_post_duration_sec |
| Photo | JPEG or WebP only, up to 20 MB; PNG is refused |
| Accounts per post | One TikTok account; other networks in the same request still go out |
| Required choices | privacy, allowComments, allowDuet, allowStitch, yourBrand, brandedContent |
| Slow processing | After 90 seconds the post is marked pending, not failed, and checked every 2 minutes for up to 6 hours |
What your agent can do on TikTok
- Post or schedule a video or photo as a Direct Post, with the audience and settings you chose.
- Read the account's live posting limits: allowed audiences, disabled interactions, longest allowed video.
- Mark posts as promotional or paid partnership, as TikTok requires.
What it cannot do
- Pick the audience or the comment, duet and stitch switches by itself: the six values must come from you.
- Post photo carousels: one item per post.
- Read views or likes: the connection does not request the video.list scope, so get_post_metrics stays empty for TikTok.
A real TikTok run, call by call
Prompt: “Post this clip to our TikTok tonight at 19:00 UTC.”
1. get_tiktok_creator_info
Captured from our workspace on 7 November 2026 (avatar URL removed). This account may offer three audiences, not four, and allows videos up to one hour.
{"accountId":"cmsitt..."}Response:
{"success":true,"creatorInfo":{"creator_nickname":"Timetopost","creator_username":"timetopostapp","privacy_level_options":["PUBLIC_TO_EVERYONE","MUTUAL_FOLLOW_FRIENDS","SELF_ONLY"],"comment_disabled":false,"duet_disabled":false,"stitch_disabled":false,"max_video_post_duration_sec":3600}}2. schedule_post
Every value in platformData.tiktok is the human's answer to the agent, not a default.
{"platforms":["tiktok"],"accountIds":["cmsitt..."],"content":"How we schedule a week of posts in one message","mediaUrls":["https://media.timetopost.co/u/clip.mp4"],"scheduledAt":"2026-11-07T19:00:00Z","platformData":{"tiktok":{"privacy":"PUBLIC_TO_EVERYONE","allowComments":true,"allowDuet":false,"allowStitch":false,"yourBrand":true,"brandedContent":false}}}3. schedule_post
The same post without the six choices is refused with this message.
{"platforms":["tiktok"],"content":"...","mediaUrls":["https://media.timetopost.co/u/clip.mp4"]}Response:
TikTok needs the creator's own posting choices, and this request carries none. TikTok requires the person posting to choose the audience and the comment, duet and stitch settings themselves, with nothing pre-selected. Collect them in the composer, or send a complete platformData.tiktok block taken from the human: privacy, allowComments, allowDuet, allowStitch, yourBrand, brandedContent. Do not invent these values.Why a TikTok MCP server cannot post on autopilot
TikTok's Direct Post rules say the creator picks the audience and the comment, duet and stitch settings for every post, with nothing pre-selected, and that the allowed options are read fresh each session. A TikTok MCP server that posts with built-in defaults breaks those rules. TimeToPost refuses a TikTok post that lacks any of the six choices, and at publish it re-reads the account: if the chosen audience is no longer offered, the post stops instead of switching audience for you.
Errors your agent will see on TikTok
These are the exact messages the server returns, so an agent can fix the call instead of guessing.
| When | Message |
|---|---|
| Two TikTok accounts in one post | TikTok posts go to one account at a time. The audience and interaction settings are specific to a single creator, so select one TikTok account and post again for the others. |
| Branded content with "Only you" | Branded content cannot be posted with the "Only you" audience on TikTok. Pick a wider audience or turn off Branded content. |
| No media | TikTok requires at least one video or image |
| Video longer than the account allows | This video runs 700 seconds. TikTok allows up to 600 seconds for this account, so it was not published. Trim it and post again. |
| PNG photo | TikTok photos must be JPEG or WebP; PNG and other image formats are not accepted. |
| Daily cap for the account | This TikTok account has hit its daily posting limit for apps like TimeToPost. It resets within a day, so schedule the post for later or publish it in the TikTok app. |
More
- TimeToPost MCP server: every tool, setup and pricing.
- TikTok scheduler without an agent.
- LinkedIn MCP server
- X MCP server
- Instagram MCP server
- Telegram MCP server
Checked against the TimeToPost server code on 2026-11-07.
Frequently asked questions
Can an AI agent post to TikTok automatically?
It can schedule and publish, but TikTok requires the person posting to choose the audience and interaction settings. The agent asks you once per post and sends your answers; it cannot decide them.
Does the TikTok MCP server upload to drafts or post directly?
It posts directly (Direct Post). It does not use the TikTok inbox or drafts upload.
How long can the video be?
As long as TikTok allows for that account: get_tiktok_creator_info returns max_video_post_duration_sec. TimeToPost measures the file and refuses a longer video before it reaches TikTok.
Why is my TikTok post pending?
TikTok can take minutes to process a video. After 90 seconds TimeToPost marks it pending and checks every 2 minutes for up to 6 hours, without uploading it again.
Connect your agent to TikTok through TimeToPost: the MCP server and its 76 tools are on every plan, from $12 a month. Your first post is free.
Start free