How to post to TikTok from Hermes Agent
Hermes schedules clips that are already in your library, and a post without a privacy level stays a draft until one is set.
How do I post to TikTok from Hermes Agent?
Add the planpo.st MCP server to Hermes Agent, connect TikTok once in the dashboard, then ask. The first three steps are one-time.
- 1
Create an API key and add planpo.st to Hermes
Make a scoped key in planpo.st under Settings. Add an MCP server by local command in Hermes: npx with the arguments -y planpost-mcp and PLANPOST_API_KEY in its environment. New servers are disabled by default in Hermes, so enable planpost after adding it.
- 2
Confirm the server is connected
Ask Hermes to list your planpo.st connections. If it has no such tool, the server is still disabled.
- 3
Connect TikTok
Connect the TikTok account in the dashboard under Connections. Publishing goes through TikTok's Content Posting API as a direct post, and get_connection_link gives the agent a URL to hand you.
- 4
Know what the post needs
A TikTok post needs one video and platformSettings.tiktok.privacyLevel. TikTok makes the account owner choose who can view each video, so there is no default to fall back on.
- 5
Ask in a chat app or the desktop app
Say what to post and when. Hermes finds the TikTok connection, creates the post, and tells you whether it was scheduled or kept as a draft, with the reason.
Add an MCP server by local command:
Command: npx
Args: -y planpost-mcp
Env: PLANPOST_API_KEY=pk_live_xxxReplace pk_live_xxx with your own key.
Which transport does Hermes Agent use?
For Hermes use the local command. Hermes documents SSE for remote servers and the planpo.st endpoint speaks streamable HTTP, so a URL connection is something to test on your version, not to assume. Enable the server after adding it.
- Hermes manages MCP servers from its settings and a CLI, and servers can be added by URL or by local command. The local command above is the tested path.
- Hermes documents SSE for remote servers. Our hosted endpoint speaks streamable HTTP, which is the newer transport, so verify a URL connection against your Hermes version before relying on it and use the local command if it does not connect.
- MCP servers you add are disabled by default in Hermes until you enable them, which is deliberate on their side.
The full walkthrough is on the Hermes Agent setup page.
What can Hermes Agent do on TikTok?
It can publish a video with a caption, a privacy level, comment, Duet and Stitch switches, a cover frame and the commercial content disclosures. It cannot publish photo posts, and it cannot schedule a video that has no privacy level.
Video post
One video with a caption of up to 2,200 characters, published directly at the scheduled time.
Who can view
requiredPUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR or SELF_ONLY. The account may allow only some of them.
Interaction switches
Comments, Duet and Stitch each have a disable flag. All three are off until you pass false.
Disclosures
yourBrand for your own business, brandedContent for a paid partnership.
TikTok needs a video file on every post, and that is the one awkward part of this pairing. When you message Hermes from a chat app, the file is not on a disk it can PUT to an upload URL. Two routes work: upload the file in the planpo.st dashboard and let Hermes pick it with list_media, or ask for a video rendered from a template with create_video.
Which settings does a TikTok post take?
TikTok is the only network here with a required setting. privacyLevel has to be on every post, and the three interaction flags default the opposite way from what most people expect.
| Field | Allowed values | If you leave it out | Worth knowing |
|---|---|---|---|
| platformSettings.tiktok.privacyLevel | PUBLIC_TO_EVERYONE, MUTUAL_FOLLOW_FRIENDS, FOLLOWER_OF_CREATOR, SELF_ONLY | None, required | Missing saves the post as a draft with tiktok_privacy_missing. If the account allows exactly one level it is filled in and reported as tiktok_privacy_defaulted. |
| platformSettings.tiktok.disableComment | true or false | true, comments off | Pass false to allow comments. |
| platformSettings.tiktok.disableDuet | true or false | true, Duet off | Pass false to allow Duets. |
| platformSettings.tiktok.disableStitch | true or false | true, Stitch off | Pass false to allow Stitches. |
| platformSettings.tiktok.videoCoverTimestampMs | Milliseconds into the video | 0, the first frame | Picks the cover frame. |
| platformSettings.tiktok.brandedContent | true or false | false | Paid partnership disclosure. With SELF_ONLY it is refused as tiktok_branded_self_only. |
| platformSettings.tiktok.yourBrand | true or false | false | Discloses that the video promotes your own brand. |
| media, platformMedia.tiktok | One video | None, required | No media saves the post as a draft with media_required, images only with video_required. |
What do I type to post to TikTok from Hermes Agent?
Plain requests work. Each example lists the tool calls Hermes Agent makes in response.
1. One video, public, comments on
You say
Use the last video I uploaded to planpo.st. Schedule it on TikTok for tonight 20:30 Europe/Warsaw, visible to everyone, comments allowed, Duet and Stitch off.
Tool calls
list_media({ type: "video" })
create_post({ content: "<caption>", platformSettings: { tiktok: { privacyLevel: "PUBLIC_TO_EVERYONE", disableComment: false } }, media: [<video>], connectionIds: ["<tiktok id>"], schedule: "today 20:30 Europe/Warsaw" })One scheduled video. Duet and Stitch stay off because their flags default to true; only the comment flag had to be sent.
2. A batch with one privacy level
You say
Take the ten newest videos in my media library and schedule one per day on TikTok at 18:00 starting Monday, all public, campaign autumn-clips.
Tool calls
list_media({ type: "video", limit: 10 })
bulk_create_posts({ defaults: { connectionIds: ["<tiktok id>"], campaign: "autumn-clips", platformSettings: { tiktok: { privacyLevel: "PUBLIC_TO_EVERYONE" } } }, posts: [ { content: "...", media: [<video 1>], schedule: "monday 18:00" }, ... ] })Ten scheduled posts from one call, the privacy level set once in defaults. I learned to put it there after 51 of my own TikTok posts failed for missing it.
3. Repair a post that stayed a draft
You say
My TikTok post for Friday is still a draft. Find out why, fix it and put it back on the schedule.
Tool calls
list_posts({ status: "draft", platform: "tiktok" })
preview_post({ id: "<post id>" })
update_post({ id: "<post id>", platformSettings: { tiktok: { privacyLevel: "PUBLIC_TO_EVERYONE" } }, schedule: "friday 18:00" })preview_post lists the blocking issue with its code and the fix. One update_post later the post is scheduled again.
What stops a TikTok post from Hermes Agent?
The tag on a card is the code that comes back in the tool result.
A privacy level on every post
tiktok_privacy_missingTikTok requires the user to choose who can view each video. Without privacyLevel the post is kept as a draft and the response names the field and the four values.
The account decides which levels exist
At publish time planpo.st asks TikTok which levels this account may use. A level the account does not allow fails with a message to pick another.
Comments, Duet and Stitch start off
The three disable flags default to true. A video you wanted people to comment on needs disableComment: false.
Video only
video_requiredThe first attachment must be a video. Photo posts are not supported.
Length depends on the account
TikTok reports a maximum video duration per account. A longer video fails at publish with both numbers in the error.
Caption links are plain text
TikTok does not make links in captions clickable. The caption can run to 2,200 characters.
Added is not enabled
HermesHermes keeps new MCP servers switched off until you enable them. If the agent answers as though planpo.st does not exist, that is why.
Use the local command
HermesHermes documents SSE for remote servers and the planpo.st endpoint speaks streamable HTTP. The local npx command is the tested path.
Can Hermes Agent tell me what a TikTok post earned?
Per post, not really. TikTok captions carry no clickable links, so there is no click on the post to match a payment to. The TikTok guide explains the bio-link route, which judges the account as a whole. get_revenue_overview returns totals and recent transactions across networks, and for shops the sales side is usually Shopify.
Hermes Agent and TikTok: questions people ask
- Can Hermes upload a video from my machine for TikTok?
- Not directly. When you message Hermes from a chat app, the file is not on a disk it can PUT to an upload URL. Upload the file in the dashboard and Hermes finds it with list_media, or have it render one: create_video makes a video from a template.
- Why does TikTok need a privacy level on every post?
- TikTok's rules for direct posting require the account owner to choose who can view each video. planpo.st refuses to pick one for you, except when the account allows exactly one level.
- Are comments on by default?
- No. disableComment, disableDuet and disableStitch all default to true. Pass false for the ones you want open.
- What happens when Hermes sends a TikTok post that breaks a rule?
- It is told at once. The usual case on TikTok is a video with no privacy level: the post is kept as a draft and the tool result carries tiktok_privacy_missing plus the fix, which Hermes applies with update_post.
- Can I post to TikTok from Telegram or Slack?
- Yes, that is the point of Hermes. The same agent answers in the chat apps it is connected to and on the desktop, with the planpo.st tools behind it in each. Keep it on drafts or approval, so a mistyped message costs you a bad draft and nothing more.
- Can Hermes use the hosted endpoint?
- Test it against your Hermes version before relying on it. Hermes documents SSE for remote servers and our endpoint is streamable HTTP. The local command works regardless and reaches TikTok the same way.
Keep going
TikTok from other agents
Other networks from Hermes