Work with publishing accounts and posts

Publishing starts with a connected account and a draft. MCP currently creates TikTok drafts with VIDEO, IMAGE, or CAROUSEL content and HTTPS media URLs. Creating or updating a draft does not schedule or publish it.

Always read can_publish and publish_unavailable_reason from account discovery. For an existing post, use the compact list to find it and then load its full detail before changing captions, media, or account selection.

Upload local media

Do not put a local file path or an HTML viewing link, such as a Google Drive share page, in media_urls. Those are not direct media that the publisher can fetch.

For a local file through MCP:

1. Call prepare_console_media_upload with the filename, content type, and byte size.
2. Send a multipart upload to the returned one-time handoff exactly as described by its method, headers, and form field.
3. Copy the EntireFeed url from the upload response into the draft's media_urls.
4. Create or update the draft, then inspect its structured readiness result.

Scheduling and publish-now reject a draft unless readiness.ready is true. Read and resolve each readiness issue; common failures include a missing caption, a media-count mismatch, the wrong media type, an unsupported platform, a non-direct share URL, or a hostname that cannot be safely resolved.

{
  "tool": "list_console_publishing_accounts",
  "arguments": {}
}

{
  "accounts": [
    {
      "id": "33333333-3333-4333-8333-333333333333",
      "platform": "TIKTOK",
      "username": "brandstudio",
      "is_active": true,
      "is_verified": true,
      "can_publish": true,
      "publish_unavailable_reason": null
    }
  ],
  "count": 1
}

{
  "tool": "create_console_publishing_post",
  "arguments": {
    "account_id": "33333333-3333-4333-8333-333333333333",
    "platform": "TIKTOK",
    "content_type": "VIDEO",
    "media_urls": [
      "https://cdn.example.com/product-reveal.mp4"
    ],
    "idempotency_key": "campaign-42-publishing-draft-v1",
    "caption": "A closer look at the new release.",
    "hashtags": [
      "launch",
      "product"
    ]
  }
}

{
  "post": {
    "id": "22222222-2222-4222-8222-222222222222",
    "platform": "TIKTOK",
    "content_type": "VIDEO",
    "status": "DRAFT",
    "media_urls": [
      "https://cdn.example.com/product-reveal.mp4"
    ],
    "caption": "A closer look at the new release."
  },
  "next": "Use schedule_console_publishing_post when the draft is approved."
}

{
  "tool": "get_console_publishing_post",
  "arguments": {
    "post_id": "22222222-2222-4222-8222-222222222222"
  }
}