Upload-Post

Generate a JWT + connection URL so an end-user can connect socials inside an embedded Upload-Post flow (white-label integration). The profile must already exist. Each call resets the profile's connection-page settings to the values passed. To simply help the account owner connect their own socials, prefer get_connect_link.

generate_jwt

Monthly FFmpeg processing minutes used vs. plan allowance.

get_ffmpeg_consumption

Returns the download URL and metadata for a completed FFmpeg job without streaming the processed file through MCP.

download_ffmpeg_result

List comments on an Instagram post. Identify the post by either `postId` or `postUrl`.

get_post_comments

What the connected TikTok account is allowed to publish. Call this before setting `tiktokPrivacyLevel`: TikTok narrows the four privacy values per account (a private account has no PUBLIC_TO_EVERYONE), and sending one the account does not have fails the upload with error_code tiktok_privacy_unavailable. Returns `privacy_level_options` plus the account's max video duration and its comment/duet/stitch switches.

tiktok_publishing_settings

Check the status of an async upload by `request_id`. Poll this until `status` is 'success' or 'failed'.

get_status

Who follows the profile, when they are online and what they tap on it. One endpoint for every network, chosen with `platform`. Returns `audience.countries` / `.cities` / `.ages` / `.genders`, `activity_by_hour` (followers online per hour of the day — use it to pick posting times), `followers_daily` (total / new / lost), `profile_actions` and `bio_description`. It always returns `benchmark_categories` (the 25 values `benchmark_category` accepts), and when `benchmark_category` is set it adds a `benchmark` object with that niche's averages (engagement rate, likes, views, follower growth…) to compare the account against. The window is clamped by the server — at most 60 days, always ending before today — so a wider range is trimmed, not rejected; `range` in the response says which window was actually used. Requires the 'profile_analytics' capability on the profile's TikTok account (see the `capabilities` array in list_users).

get_audience

Replays per-post metrics Upload-Post already fetched, instead of calling the platforms again. ONLY contains posts previously fetched through `get_post_analytics`; there is no background refresh, so `captured_at` is the last time that post was read live and a post never queried live will be absent. Unlike `get_post_analytics` it never hits the platforms, so it is not subject to the live analytics rate limit (100 requests / 5 minutes) — prefer it when scanning many posts or paging through a profile's history. Paginated: pass `next_cursor` from the response back as `cursor` until `has_more` is false.

get_cached_post_analytics

Reddit posting is currently unavailable (error_code=reddit_unavailable) until the Reddit app is restored. Do not use reddit as a publish target. Recent Reddit posts published from a profile, with the platform-side metadata (subreddit, flair, score, …).

get_reddit_detailed_posts

What to write about: the hashtags or the searches a network suggests around a word. One endpoint for both questions, told apart by `type`, and one endpoint for every network, chosen with `platform`. `type: 'hashtags'` returns `{ hashtags: [{ name, view_count }] }` — pick tags that actually have reach for a caption; `type: 'keywords'` returns `{ keywords: [...] }`, what people really search around `q`, useful for the next video topic. Requires the 'profile_analytics' capability on the profile's TikTok account (see the `capabilities` array in list_users). Keyword suggestions need 'trend_search' instead, granted the same way.

get_suggestions

Get the link the user opens to connect (or reconnect) social accounts such as TikTok, Instagram or YouTube. Use it when list_users shows no profile, or the platform the user wants is not connected or needs reconnecting. If the account has no profile yet, this creates one named "default" and returns a one-click link to connect accounts to it (valid 48 h); otherwise it returns the dashboard link. Give the user `connect_url`, ask them to tell you when they are done, then call list_users to confirm before publishing.

get_connect_link

Internal/app staging helper. Get status for a short-lived MCP media upload. Optionally returns a fresh temporary media_url for an already-uploaded staging object.

get_media_upload

Per-platform metrics for a specific post identified by `request_id`.

get_post_analytics

Aggregated analytics for a profile across selected platforms (followers, views, engagement). Instagram also returns two audience breakdowns with the same shape (age / gender / country / city): `follower_demographics` for the account's followers and `engaged_audience_demographics` for the accounts that engaged with its content.

get_analytics

Posting queue configuration (slots per day, time windows, timezone).

get_queue_settings

Retrieve recent media (videos, photos, text posts) pulled directly from a profile's connected social accounts. Supports instagram, tiktok, youtube, linkedin, facebook, x, threads, pinterest, bluesky, reddit. Useful for browsing what already exists on a platform before posting more. Paginated: the response carries `pagination` = { limit, next_cursor, has_more }; pass `next_cursor` back as `cursor` for the next page (the last page returns next_cursor null and has_more false).

get_media

Check the status of a scheduled or queued upload by `job_id`. Use this for posts created with `addToQueue` or `scheduledDate`.

get_job_status

Sum of impressions for a profile from daily snapshots. Use `period` for presets, or `startDate`/`endDate` for custom ranges.

get_total_impressions

Paginated history of uploads across all profiles.

get_history

Recent DM conversations for a profile on a given platform.

list_dm_conversations

Facebook pages connected to a profile.

get_facebook_pages

Google Business Profile locations the profile can post to.

get_google_business_locations

List reviews for a Google Business Profile location. Pass the profile that owns the connected Google Business account; location_id defaults to the account's selected location.

get_google_business_reviews

LinkedIn company pages connected to a profile.

get_linkedin_pages

Pinterest boards available to a profile.

get_pinterest_boards

Reference: which metrics are available per platform (impressions, likes, …) and their human labels.

get_platform_metrics

List all Upload-Post profiles in the account, with their connected social accounts. Call this FIRST, before publishing, to get the exact profile name (`user`) and check that the target platforms are connected; never invent a profile name. When the account has no profile, or the requested platform is not connected or needs reconnecting, the response carries `next_step` and `connect_url`: give the user that link, ask them to tell you when they have connected, and wait — do not try to publish meanwhile. The TikTok account object carries a `capabilities` array (music, location, cover_image, cover_timestamp, draft, photo_privacy, video_privacy, inbox_fallback, profile_analytics) telling which optional TikTok fields that connection accepts.

list_users

List all currently scheduled (not-yet-published) posts.

list_scheduled

Trending tracks from the TikTok Commercial Music Library, to soundtrack a TikTok video. Pass the returned track `id` as `tiktokMusicId` in upload_video's platformOptions (not `commercial_music_id`, which TikTok rejects on public posts). Available on TikTok connections that declare the `music` capability (see `capabilities` on the TikTok account in list_users).

tiktok_music_trending

Control Instagram AutoDM monitors. For action='start', provide post_url, reply_message, and profile_username. For stop/pause/resume/delete/logs, provide monitor_id. For status, optionally set include_inactive=true.

manage_autodms

Open the upload studio in the user's browser for local or attached video uploads. Use this FIRST when the user attaches a video and does not provide a public HTTPS URL. Do not try upload_video with /mnt/data, sandbox, or other mounted local paths first: a hosted MCP server cannot read files on the client's machine. The Studio lets the user select the file in the browser, stages it in short-lived Upload-Post storage, and publishes it through Upload-Post. Reddit posting is currently unavailable (error_code=reddit_unavailable) until the Reddit app is restored. Do not use reddit as a publish target.

open_upload_studio

Poll the status of an FFmpeg job. When status is 'completed', call `download_ffmpeg_result` to obtain the file.

get_ffmpeg_job

Preview the upcoming queue slots and what would land in them. Optionally `nextSlot=true` returns just the next available slot timestamp.

preview_queue

Send a private DM to the author of an Instagram comment (within Instagram's 7-day reply window).

reply_to_comment

Post a public reply visible under the original Instagram comment.

public_reply_to_comment

Create or update the owner reply to a Google Business review. Provide review_name (the full resource path from get_google_business_reviews) or review_id + location_id.

reply_to_google_business_review

Retry a failed upload. Identify it by either `requestId` (async upload) or `jobId` (scheduled/queued upload).

retry_post

Search TikTok places to tag on a post. TikTok needs both parts, so pass the returned `location_id` as `tiktokLocationId` and `location_name` as `tiktokLocationName` in upload_video's platformOptions. Available on TikTok connections that declare the `location` capability (see `capabilities` on the TikTok account in list_users).

tiktok_location_search

Find a TikTok Commercial Music Library track by song title or artist, to soundtrack a TikTok video. Pass the returned track `id` as `tiktokMusicId` in upload_video's platformOptions (not `commercial_music_id`, which TikTok rejects on public posts). IMPORTANT: TikTok has no music search endpoint, so this searches the trending charts Upload-Post caches per genre/country/period, NOT TikTok's whole catalogue — a song that is not trending in the chart you query will not be found; widening the search means trying another genre, country or period. Matching is case- and accent-insensitive and every word must match. Available on TikTok connections that declare the `music` capability (see `capabilities` on the TikTok account in list_users).

tiktok_music_search

Send an Instagram DM to a recipient from a connected Upload-Post profile. Use a recipient_id returned by Instagram comments or DM conversation tools.

send_dm