Octopost
Server Details
Your agent posts, schedules, queues and threads posts on X, with a human approval queue.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- Octopost
- Claude
- –
TDQS
Scored across 32 tools
Most tools have clearly distinct jobs (create_post vs queue_post vs schedule_post vs publish_draft are separated by timing and lifecycle, and feed tools split cleanly into add/list/remove). A few boundaries are subtle — cancel_scheduled vs reschedule_post vs publish_draft, and the approval cluster (approve_queued_post, reject_queued_post, resubmit_post, publish_draft) — but the descriptions explain the state machine well enough to pick correctly.
Every tool is snake_case verb_noun (create_post, list_feeds, update_queue_settings, split_thread, retry_failed), with a small, predictable verb vocabulary (create/get/list/update/delete/queue/schedule/publish). No camelCase mixing or vague one-word names, and related tools share stems (list_posts/get_post, add_feed/list_feeds/remove_feed).
32 tools is heavy and a handful feel marginal or consolidatable (get_guide, preview_post, set_evergreen, reorder_queue, approve/reject could pair up; cancel_scheduled overlaps update_post). The domain is genuinely broad — publishing, scheduling, queue, feeds, analytics, uploads, YouTube comments, connections — so most tools earn a place, but the surface is larger than needed for typical workflows.
The post lifecycle is well covered end to end: create/preview, draft/schedule/queue, approve/reject/resubmit, publish, retry_failed, reschedule/cancel, update and delete, plus analytics, usage, uploads, presets and feeds. Gaps are minor — no tool to disconnect or manage a connected account, no editing of already-published posts (documented as delete-and-recreate), and analytics absent for Threads/LinkedIn.
Available Tools
32 toolsadd_feedAdd an RSS feedAInspect
Turn an RSS or Atom feed (a blog, a newsletter, a changelog) into posts. Octopost reads the feed right away (a site address works too if the page links its feed) and then checks it every 30 minutes by default. Each new item becomes a post from the template.
The first check posts only the feed's latest item, so adding a feed never floods the account. By default (mode "hold") every new item waits for a person to approve it: Octopost emails the owner Approve / Reject / Edit links, so tell the user to check their email. With mode "queue" new items join the posting queue and publish in queue slots. A feed makes at most 10 posts a day; the same text to the same network within 7 days is skipped; a blocked term holds the post. Posts are shortened to fit each network (the excerpt first, then the title; the link is kept whole).
Inputs: url (required), platforms (required), mode, name, +2 more.
approve_queued_postApprove a pending queued postAIdempotentInspect
Approve a post that is waiting for approval. Approval is meant for a person: by default this tool refuses, and the post has to be approved from the email Octopost sent or the dashboard. It only works when the account owner turned on "Let agents approve posts made by a different agent" in Settings, and never for a post your own key or connection made. Only call it when the user explicitly asked you to approve that specific post. If it refuses, tell the user the post is waiting for them and to check their email. Once approved, a queue post publishes in its queue slot and a scheduled post at its time.
Inputs: post_id (required).
cancel_scheduledCancel a scheduled postAIdempotentInspect
Cancel a scheduled post, converting it to a draft. The post is kept in Octopost but will NOT be published at the scheduled time.
Give it a new time later with reschedule_post. To publish it right away instead, call publish_draft.
Inputs: post_id (required).
create_connect_linkLink for someone to connect their accountAInspect
Make a link that lets someone else (a client, a teammate) connect their own social account to THIS Octopost account with no Octopost login. Give them the url; each account they connect shows up in list_accounts. Works 7 days by default, for up to 5 accounts. The url is shown once.
Inputs: label, networks, max_accounts, expires_in_days.
create_postPublish a post nowAInspect
Create and publish a post to one or more social media platforms immediately.
Octopost handles formatting, auth and uploads. Which networks work today is in the server instructions (and get_guide topic "platforms").
PLATFORM CONTENT LIMITS (checked before anything is published: if the text or any segment is too long for one of the networks, the call fails with the count and nothing goes out):
Twitter/X: 280 chars (URLs count as 23 chars). Can't mix video with images.
Bluesky: 300 graphemes. Octopost auto-generates link facets. Up to 4 images or one MP4 video (3 min max), not both.
LinkedIn: 3,000 chars.
Threads: 500 chars.
Mastodon: ~500 chars (varies by server; checked when publishing).
TIPS:
If a platform fails, the post still succeeds on other platforms — check the response for per-platform results.
A slow publish (Threads with media can take minutes) answers after ~20 s with status "publishing" and carries on: check it with get_post. Pass an idempotency_key; if a call times out with no postId, retry with the same key (you get the original post, never a second).
Use cross_link_enabled + primary_platform to post to one platform first, then share the link on others.
Polls are supported on Twitter (2-4 options, 5 min to 7 day duration) and Mastodon.
APPROVAL: if the account requires approval for every post (an owner setting), create_post saves the post as pending_approval instead of publishing and the result says so. Tell the user to approve it from the email Octopost sends; don't approve it yourself. To ask for a review yourself, use queue_post or schedule_post with needs_approval=true.
Inputs: content (required), platforms (required), poll, tiktok, +13 more.
create_uploadGet an upload URL for a local fileAInspect
Attach a file from your machine (screenshot, photo, video): this returns a one-time upload_url, good for 15 minutes and one file. Send the raw bytes to it, e.g. curl -T ./shot.png "<upload_url>" (PUT; no auth header needed). The response has media_url: pass it in media_urls (as the URL, or {url, alt} with alt text) on create_post / schedule_post / queue_post / update_post.
Accepts JPEG, PNG, GIF, WebP, MP4, MOV, WebM (checked from the file's bytes). Size limit depends on the plan (max_bytes in the response). Files already on a public URL don't need this: pass the URL directly.
Inputs: size, filename.
delete_postDelete a postADestructiveIdempotentInspect
Delete a post from Octopost. For published posts, also attempts to delete from each platform via their APIs.
Platform deletion support:
Twitter: Full API deletion supported.
Bluesky: Full API deletion supported (deleteRecord).
LinkedIn: Full API deletion supported.
Mastodon: Full API deletion supported.
Threads: API deletion not supported — returns the post URL so the user can delete manually.
The post is ALWAYS removed from Octopost's database regardless of platform deletion results.
Inputs: post_id (required), delete_from_platforms.
get_analyticsGet post analyticsARead-onlyIdempotentInspect
How published posts did: likes, reposts, replies, quotes and (on X) views.
Two modes:
With post_id: that post's numbers per network, plus snapshots taken about 1 hour, 24 hours and 7 days after it went live.
Without post_id: a summary of posts published between from and to (default: the last 30 days): totals per network and the top posts by engagement (likes + reposts + replies + quotes).
Which networks report what: X gives likes, reposts, replies, quotes, bookmarks and views. Bluesky gives likes, reposts, replies and quotes. Mastodon gives likes (favourites), reposts (boosts) and replies. Threads and LinkedIn are not available yet. Octopost reads the numbers on its own for 30 days after a post goes live, so they can be a few hours old; each network's result says when it was read. Pass refresh: true to read fresh numbers first (allowed once every 10 minutes).
Inputs: to, top, from, post_id, +2 more.
get_guideRead the Octopost guideARead-onlyIdempotentInspect
Get a comprehensive guide on using Octopost effectively. Returns platform limits, best practices, content tips, and feature documentation. Call this if you need help with:
What platforms are supported and their limits
How to format content for cross-platform posting
Media/image/video requirements per platform
Scheduling and content calendar tips
How threads work on supported platforms
Inputs: topic.
get_postGet a post and its resultsARead-onlyIdempotentInspect
Get everything about one post: status, full text, approval state and reviewer feedback, thread segments, per-network variants, media (with alt text), queue status and position, which account posts on each network, per-network results with links, and the last error. Use it to check whether a post went out everywhere.
Inputs: post_id (required).
get_queue_statusShow the queueARead-onlyIdempotentInspect
See your queue: how many posts are ready, how many need approval, when the next one publishes, and your queue settings.
Inputs: no named parameters.
get_usageShow plan usageARead-onlyIdempotentInspect
How much of the plan is used: X post units this month (used, limit, remaining, when it resets; a post with a link costs 13 units, a plain post 1), and connected accounts vs the plan's limit. A null limit means unlimited. Check it before a batch of X posts so you don't hit the cap part way.
Inputs: no named parameters.
list_accountsList connected accountsARead-onlyIdempotentInspect
List all connected social media accounts. ALWAYS call this before create_post to see which platforms the user has connected.
Returns each account's platform, handle, id, and whether it is the platform's default (used when a post names no account). A platform can have several accounts: pass "accounts" to create_post / queue_post / schedule_post to pick one. Only connected platforms can be posted to. Not every network is live yet: check the network status in the server instructions before promising a post.
Inputs: no named parameters.
list_feedsList RSS feedsARead-onlyIdempotentInspect
List the RSS/Atom feeds this account turns into posts: each feed's networks, template, mode ("hold" = every new item waits for a person to approve it, "queue" = new items join the posting queue), how often it is checked, when it was last checked, any error, and how many items it has seen and posted.
Inputs: no named parameters.
list_postsList postsARead-onlyIdempotentInspect
List posts, newest first: content preview, platforms, status, scheduled time and each network's link. Filter with status. Results are paged: when next_cursor is set, call again with cursor = next_cursor for the next page. Call get_post for one post's full details.
Inputs: limit, cursor, status.
list_presetsList publishing presetsARead-onlyIdempotentInspect
List publishing presets: saved platform combinations (system presets plus the user's own) with their cross-link settings. The create tools take platforms, not a preset name, so pass a preset's platforms (and cross-link fields) to create_post / schedule_post / queue_post. Platforms Octopost doesn't support are left out of the list, and presets with none left are skipped.
Inputs: no named parameters.
list_youtube_commentsList comments on a YouTube videoARead-onlyIdempotentInspect
Read the comments on a YouTube video: each top-level comment with its author, text, likes, date, reply count and up to 5 replies, and by_you on comments the connected channel wrote. YouTube is in platform review: this only works for an account with a YouTube channel connected (list_accounts). Pass next_page_token back as page_token for more.
Inputs: video (required), order, search, account, +2 more.
preview_postCheck a post before sending itARead-onlyIdempotentInspect
Dry run: what would happen if you sent this post, without saving or posting anything. Returns ok (would it go out), problems (fix these first) and warnings, character counts per network and part the way each network counts (X: links 23, emoji/CJK 2; Bluesky: graphemes), X units it would use vs what's left this month, media checks per network (counts, video, missing alt text), which connected account each network would post as, and guardrails (this connection's daily limit, same text posted recently, blocked terms that would hold it for approval).
Takes the same arguments as create_post. Call it before a create_post / schedule_post / queue_post you're unsure about.
Inputs: content (required), platforms (required), poll, accounts, +6 more.
publish_draftPublish a saved post nowAInspect
Publish a post that's already saved in Octopost right now: a draft, a scheduled post (it goes out now instead of at its time) or a queued post (it skips the queue). Uses the post's own text, networks, media and thread segments. Returns per-network results like create_post (or status "publishing" if slow; see get_post).
Posts waiting for human approval (pending) can't be published this way; a person approves them first. For a post that already went out and failed on some networks, use retry_failed.
Inputs: post_id (required), allow_duplicate.
queue_postAdd a post to the queueAInspect
Add a post to your publishing queue. It will be published automatically during your active hours. Posts require platforms to be specified.
HUMAN APPROVAL: set needs_approval=true when a person should review the post first (anything the user hasn't seen word for word). The post is held as "pending" and nothing is published until a person approves it. Octopost emails the account owner and any approvers one-tap Approve / Reject / Edit / Ask for changes links (batched, within about 5 minutes) and shows it in the dashboard. If they ask for changes, see resubmit_post. After queueing, tell the user: "It's waiting for your approval; check your email." You can't approve your own posts. The account owner can also set auto-approve rules, in which case the result says the post was auto-approved.
The queue publishes posts in FIFO order (oldest first) at regular intervals during active hours (default: every 4 hours, 9am-8pm). Great for evergreen content and maintaining a regular posting cadence.
Same platform limits and same options as create_post, which documents them in full.
Inputs: content (required), platforms (required), poll, tiktok, +14 more.
reject_queued_postTake a post out of the queueAInspect
Take a queued post out of the queue and turn it back into a draft, with an optional note saying why (shown with the post). Nothing is published or deleted; edit it with update_post and queue it again, or delete it with delete_post. A post waiting for approval (pending) is for a person to approve or reject, so this refuses it; to withdraw a post you made, delete it.
Inputs: post_id (required), note.
remove_feedRemove an RSS feedADestructiveIdempotentInspect
Stop turning a feed into posts and forget which items it has seen. Posts the feed already made (published, queued or waiting for approval) are kept; delete those separately with delete_post if needed. Get the feed id from list_feeds.
Inputs: feed_id (required).
reorder_queueReorder the queueAIdempotentInspect
Set the order queued posts publish in. The posts you list go first, in that order; queued posts you leave out keep their current order after them. Pending-approval posts can be listed too: their place applies once approved. Call list_posts with status "queued" to see the queue.
Inputs: post_ids (required).
reply_to_youtube_commentReply to a YouTube commentAInspect
Post a public reply to a YouTube comment as the connected channel; it goes live right away. Get comment_id from list_youtube_comments. YouTube is in platform review: this only works for an account with a YouTube channel connected (list_accounts). Show the user the reply before posting it. Refused when the account holds agent posts for approval or the text has a blocked term.
Inputs: text (required), comment_id (required), account.
reschedule_postReschedule a postAIdempotentInspect
Change the scheduled time of a post. The new time must be in the future. Works on both scheduled posts and drafts (effectively scheduling a draft).
The post will be published at the new time by Octopost's scheduler (checks every 60 seconds).
Inputs: post_id (required), scheduled_for (required).
resubmit_postSend a revised post back for approvalAInspect
After a reviewer clicked "Ask for changes" (get_post: approval.state "changes_requested", approval.feedback says what to fix), revise the post with update_post, then call this to send it back for approval. It returns to its earlier time if still ahead, else the next queue slot after approval.
Inputs: post_id (required), reply, scheduled_for.
retry_failedRetry failed networksAInspect
Retry publishing to platforms that failed on a previous post. Only retries platforms that had errors — already-successful platforms are not re-published.
Call get_post first to see which platforms failed and why. You can retry all failed platforms or specify specific ones.
Common failure reasons: expired tokens (user needs to re-connect), rate limits (wait and retry), network errors (usually transient).
Inputs: post_id (required), platforms.
schedule_postSchedule a postAInspect
Schedule a post for future publishing. The Octopost scheduler will publish it at the specified time automatically.
The post is saved as a draft until the scheduled time, then published to all specified platforms.
Same platform limits and same options as create_post, which documents them in full. Options are saved with the post and applied when it publishes.
Set needs_approval=true to hold it for a person to approve first (same flow as queue_post).
Inputs: content (required), platforms (required), scheduled_for (required), poll, +15 more.
set_evergreenMark a post evergreenAIdempotentInspect
Mark a post evergreen (or not). When the posting queue runs empty, Octopost posts an evergreen post again in the empty queue slot, picking the one that has rested longest. The same post goes out at most once every 30 days, and never while the same text is on (or going to) the same network within those 30 days, so X's rule against repeating a recent post is respected. A draft or scheduled post can be marked now and becomes eligible once it has been published. Only works while the queue is on (update_queue_settings).
Inputs: post_id (required), evergreen (required).
split_threadSplit long text into a threadARead-onlyIdempotentInspect
Split long text into thread parts that fit every network you name, breaking at paragraphs, then sentences, then words. Counts the way each network does (X: links are 23, emoji 2; Bluesky: graphemes). Nothing is saved or posted. Pass the result straight to create_post / schedule_post / queue_post as content + segments.
Inputs: text (required), platforms (required), numbering.
update_postEdit an unpublished postADestructiveIdempotentInspect
Update a post's content, platforms, scheduled time, attached media, or thread reply segments. Only works on unpublished posts (drafts, scheduled, queued, and pending).
Any field you omit is preserved as-is. Pass media_urls: [] to clear all attached media; pass new media_urls or video_url to replace it. For already-published posts, you'll need to delete and re-create.
Inputs: post_id (required), tiktok, content, segments, +6 more.
update_queue_settingsChange queue settingsAIdempotentInspect
Change your queue settings: how often to post, active hours, timezone, or pause/resume the queue.
Defaults: publish every 4 hours, active 9am-8pm, timezone America/New_York. The queue only publishes during active hours. The exact minute within each interval is randomized so posts look natural.
Inputs: enabled, end_hour, timezone, start_hour, +1 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
Let AI agents post to social media with human approval: schedule, first comments, threads.
Post, schedule, and track social posts on X, Bluesky, LinkedIn, Instagram and more from AI agents.
Write, score, queue and schedule Threads and X posts in your own voice from your AI assistant.
Lets AI agents post and reply on Instagram, TikTok, Threads and more, with a human approval queue.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables AI agents to read, post, search, and engage with Twitter/X content, including AI-powered reply drafting and analytics.17MIT
- AlicenseAqualityCmaintenanceEnables AI agents to publish text, images, and video to LinkedIn and queue posts for X that a Chrome extension fills into the composer for review and posting. Facebook Pages and Instagram are supported once Meta approval is granted.613 npmMIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to fully automate X/Twitter interactions including searching, posting, engaging, and managing multiple accounts without paid API keys.MIT
- AlicenseNot gradedqualityCmaintenanceSocial media scheduling and publishing for AI agents. 17 validation-first tools to post to X, LinkedIn, Instagram, TikTok, YouTube, Reddit, Discord, Telegram, and more through one connected workspace.164 npm110MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.