Tiktok Post

TikTok Post

Upload and schedule videos to TikTok using the Publora MCP server. Supports privacy controls, interaction settings (comments, duet, stitch), and commercial content disclosure.

Prerequisites

Plans: Works on the free Starter plan. Current limits and pricing: publora.com/pricing.

Getting Started

1. Create account at publora.com/register (free)
2. Connect TikTok via OAuth in Publora Dashboard
3. Get API key at app.publora.com/dashboard/api
4. Connect your agent to the MCP server at https://mcp.publora.com, authenticating with Authorization: Bearer sk_YOUR_API_KEY. In Claude Code:

claude mcp add publora --transport http https://mcp.publora.com \
  --header "Authorization: Bearer sk_YOUR_API_KEY"

Claude Desktop, Cursor, Codex, OpenClaw and the claude.ai connector each need a different config file or flow: see client setup for the exact path and snippet.

REST API Fallback

If the MCP server is unavailable or returns errors, use the REST API directly:

Base URL: https://api.publora.com/api/v1

Authentication: Use x-publora-key header (NOT Authorization: Bearer):

# Get your connected platforms
curl -X GET "https://api.publora.com/api/v1/platform-connections" \
  -H "x-publora-key: sk_your_api_key"

# Create a post
curl -X POST "https://api.publora.com/api/v1/create-post" \
  -H "x-publora-key: sk_your_api_key" \
  -H "Content-Type: application/json" \
  -d '{
    "platforms": ["tiktok-99887766"],
    "content": "Video caption here #hashtag",
    "scheduledTime": "2026-03-25T10:00:00Z",
    "platformSettings": {
      "tiktok": {
        "viewerSetting": "PUBLIC_TO_EVERYONE",
        "allowComments": true
      }
    }
  }'

Platform ID Format: tiktok-{id} where {id} is from /platform-connections response.

Example IDs: tiktok-99887766, tiktok-123456789

📖 Full API documentation: docs.publora.com

Platform Limits (API vs Native App)

Critical API limits that differ from native TikTok app:

Video Requirements

Caption Limits

Rate Limits

Available Tools

create_post

Create a new TikTok post.

Parameters:

• platforms: Array with your TikTok connection ID (e.g., ["tiktok-99887766"])
• content: Video caption (up to 2,200 characters)
• scheduledTime: ISO 8601 UTC datetime. Optional: omit it and the post is created as a draft. Send a future time to schedule. A time five or more minutes in the past is rejected with SCHEDULED_TIME_IN_PAST, so for immediate posting use the current time plus a minute.
• mediaUrls: up to 10 public https image or video URLs. Publora downloads them server-side and attaches them before validation, so media and scheduling happen in one call. This is the one-shot alternative to the draft then get_upload_url then complete_media flow. Ingestion is rate-limited to 60 URLs per hour.

get_upload_url

Get presigned URL for video upload.

Parameters:

• postGroupId: Post ID to attach video to
• fileName: Video file name (e.g., "video.mp4")
• contentType: video/mp4, video/quicktime, or video/webm
• type: "video"

complete_media

Finalize a file uploaded through get_upload_url, after the presigned PUT succeeds. Optional, because scheduling also finalizes pending media, but calling it early surfaces format and probe errors before publish. Not needed for media attached with mediaUrls.

Parameters:

• mediaId: the id returned by get_upload_url

list_connections

List your connected accounts with their platform IDs. Call this first and copy the IDs verbatim; they are never guessable.

list_posts / get_post / update_post / delete_post

Manage scheduled and draft posts. update_post also patches content and platforms on a draft or scheduled post, so fixing a typo or retargeting no longer means delete and recreate. delete_media and prune_media_reference clean up uploaded files.

Platform Settings (via REST API)

TikTok has 7 platform-specific settings controlled via platformSettings:

{
  "platformSettings": {
    "tiktok": {
      "viewerSetting": "PUBLIC_TO_EVERYONE",
      "allowComments": true,
      "allowDuet": false,
      "allowStitch": false,
      "commercialContent": false,
      "brandOrganic": false,
      "brandedContent": false
    }
  }
}

Viewer Settings (Required)

Interaction Settings

Commercial Content Settings

Note: If commercialContent is true, at least one of brandOrganic or brandedContent must also be true.

Note: platformSettings is not available via MCP - use REST API for these settings.

Critical Restrictions

1. Unaudited Apps = PRIVATE Only

CRITICAL: If your TikTok app hasn't passed TikTok's review process, you can ONLY post PRIVATE videos (SELF_ONLY). All other viewerSetting values will be overridden to SELF_ONLY.

To post public videos, your app must be audited by TikTok.

2. Video Only Platform

TikTok does NOT support:

• Text-only posts
• Image posts
• Photo carousels

Every post must include a video.

3. Minimum 23 FPS

Videos below 23 frames per second will be rejected by TikTok.

Examples

Basic Video Post

Post this video to TikTok:
"How we built our startup in 60 seconds #startup #tech #coding"

Private Draft (Testing)

Upload this video as a private draft to TikTok (only I can see it):
"Testing new content format"

Use viewerSetting: "SELF_ONLY" for testing before making public.

Branded Content

Post this sponsored video to TikTok with proper disclosure:
"Loving this new product from @brand! #ad #sponsored"

Set commercialContent: true and brandedContent: true for paid partnerships.

Scheduled Post

Schedule this TikTok video for tomorrow at 6 PM:
"Weekend vibes incoming! #weekend #fun"

Supported Video Formats

Recommendation: Use MP4 for best compatibility.

Best Practices

Content

1. Hook in first 3 seconds: Grab attention immediately
2. Optimal length: 15-60 seconds for best engagement
3. Trending sounds: Use trending audio when possible
4. Hashtag strategy: 3-5 relevant hashtags

Technical

1. Vertical video: 9:16 aspect ratio performs best
2. High quality: At least 720p resolution
3. 23+ FPS: Ensure smooth playback
4. MP4 format: Most reliable format

Timing

• Best times: 7-9 AM, 12-3 PM, 7-11 PM in target timezone
• Frequency: 1-3 posts per day for growth
• Consistency: Regular posting schedule helps algorithm

Troubleshooting