Awesome MCP Servers by AI Anytime

Directory / Marketing, content & social

Octopost

Remote MCP server for posting to X, Bluesky, Mastodon and LinkedIn: threads, scheduling, a queue and a human approval queue. Paid, OAuth sign-in or API key. Endpoint: https://octopost.ink/mcp · Website

Live  Answered an MCP handshake without credentials and listed 32 tools.

Category
Marketing, content & social
Transport
http
Source
https://github.com/octopost-ink/octopost-plugin
Endpoint
https://octopost.ink/mcp
MCP Registry
ink.octopost/octopost
Reports itself as
Octopost 1.0.0
Protocol
2025-06-18
Tools
32
Context cost
about 17,905 tokens for the tool definitions (estimated at four characters per token)
Tool definitions last changed
2026-11-20
Handshake time
422 ms
Repository
0 stars · last push 2026-11-21 · MIT
Last checked
2026-11-22 11:27:43 UTC
Listed since
2026-11-18

Health and compatibility

Endpoint reachableVerifiedResponded in 422 ms
MCP handshake (initialize)VerifiedCompleted without credentials
Tool discovery (tools/list)Verified32 tools listed
AuthenticationVerifiedNone needed to connect
Protocol versionVerified2025-06-18
TransportVerifiedStreamable HTTP
Capabilities declaredVerifiedtools

Last checked . Verified means the check saw it happen; it says nothing about whether the server is safe.

Recent history

5 daily checks so far; median response 241 ms. Green answered, violet asked for auth, red did not answer.

Set up in your client

Claude Code

Run this in a terminal:

claude mcp add --transport http octopost https://octopost.ink/mcp

Claude Desktop

Open Settings → Connectors → Add custom connector and paste this URL:

https://octopost.ink/mcp

Or bridge it through mcp-remote in claude_desktop_config.json (needs Node.js):

{
  "mcpServers": {
    "octopost": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://octopost.ink/mcp"
      ]
    }
  }
}

Cursor

Add to Cursor

Or add it to ~/.cursor/mcp.json (or .cursor/mcp.json in a project):

{
  "mcpServers": {
    "octopost": {
      "url": "https://octopost.ink/mcp"
    }
  }
}

VS Code

Add to VS Code

Or add it to .vscode/mcp.json:

{
  "servers": {
    "octopost": {
      "type": "http",
      "url": "https://octopost.ink/mcp"
    }
  }
}

Or from a terminal:

code --add-mcp '{"name": "octopost", "type": "http", "url": "https://octopost.ink/mcp"}'

Windsurf

Add it to ~/.codeium/windsurf/mcp_config.json:

{
  "mcpServers": {
    "octopost": {
      "serverUrl": "https://octopost.ink/mcp"
    }
  }
}

Other clients

Most clients accept this shape. The endpoint is:

https://octopost.ink/mcp
{
  "mcpServers": {
    "octopost": {
      "type": "http",
      "url": "https://octopost.ink/mcp"
    }
  }
}

If it does not connect

Tools 32

Names, descriptions and input schemas exactly as the server returned them on 2026-11-22. This is the server author's own text. Nothing is run from this page. Labels such as read-only are declared by the server and are not verified. Raw JSON

add_feedcan modifyexternal accessTurn an RSS or Atom feed (a blog, a newsletter, a changelog) into posts. Octopost reads the feed right away …

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).

ParameterTypeDescription
urlstringrequiredThe feed URL (or the site address, if its page links a feed).
platformsstring[]requiredNetworks each new item is posted to. Call list_accounts first.
templatestringoptionalOptional. Post text with {title}, {url} and {excerpt} (a plain-text summary of the item). Default "{title} {url}".
modestringoptionalOptional. "hold" (default): each new item waits for a person to approve it. "queue": new items join the posting queue. One of: hold, queue
namestringoptionalOptional. A name for the feed. Default: the feed's own title.
check_every_minutesnumberoptionalOptional. How often to check, 15 to 1440 minutes. Default 30.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "add_feed",
    "arguments": {
      "url": "...",
      "platforms": []
    }
  }
}
approve_queued_postcan modifyexternal accessApprove a post that is waiting for approval. Approval is meant for a person: by default this tool refuses, …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) to approve.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "approve_queued_post",
    "arguments": {
      "post_id": "..."
    }
  }
}
cancel_scheduledcan modifyCancel a scheduled post, converting it to a draft. The post is kept in Octopost but will NOT be published at …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) of the scheduled post to cancel.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "cancel_scheduled",
    "arguments": {
      "post_id": "..."
    }
  }
}
create_connect_linkcan modifyMake a link that lets someone else (a client, a teammate) connect their own social account to THIS Octopost …

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.

ParameterTypeDescription
labelstringoptionalWho it is for, shown on the link page.
networksstring[]optionalOnly these networks. Omit for any.
expires_in_daysnumberoptional1 to 30 (default 7).
max_accountsnumberoptional1 to 25 (default 5).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_connect_link",
    "arguments": {}
  }
}
create_postcan modifyexternal accessCreate and publish a post to one or more social media platforms immediately. Octopost handles formatting, …

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 …

ParameterTypeDescription
contentstringrequiredThe post text. Keep under 280 chars if posting to Twitter.
platformsstring[]requiredWhich platforms to post to. Call list_accounts first to see what's connected.
media_urlsstring | object[]optionalOptional images (up to 4 for most platforms) or one video. Must be publicly reachable. Each item is a URL string or {url, alt} with alt text (recommended for images). For a file on your machine, call create_upload first.
video_urlstringoptionalOptional video URL. Can't be combined with images on Twitter.
pollobjectoptionalCreate a poll. Only works on Twitter and Mastodon.
mastodon_visibilitystringoptionalMastodon post visibility. "public" = visible to all, "unlisted" = not on public timelines, "private" = followers only, "direct" = mentioned users only. Default: public. One of: public, unlisted, private, direct
content_warningstringoptionalMastodon spoiler text / content warning. Post content will be hidden behind this text. Important in Mastodon culture for sensitive topics.
tiktokobjectoptionalRequired for TikTok. Ask the user; no defaults.
cross_link_enabledbooleanoptionalEnable cross-link publishing. Posts to primary_platform first, then shares the link to other platforms using the cross_link_template.
primary_platformstringoptionalWhich platform to post to first when cross_link_enabled is true. The post URL from this platform is shared to the others. One of: twitter, threads, bluesky, linkedin, mastodon, instagram, facebook, pinterest …
cross_link_templatestringoptionalTemplate for cross-link posts on secondary platforms. Variables: {platform} (primary platform name), {link} (post URL). Default: "New post on {platform}: {link}".
segmentsobject[]optionalOptional thread reply segments (up to 24). Each becomes a reply in a chain on X/Threads/Bluesky/Mastodon; on LinkedIn the first post goes out with `content` and each segment is added as a comment on it. The whole thread publishes atomically. Canonical use …
first_commentstringoptionalOptional. Posted as the first reply right after the post (after the last segment of a thread): a reply on X, Bluesky, Mastodon and Threads, a comment on LinkedIn. Good for the link or the hashtags. Same length limits as the post (LinkedIn comments: 1,250). …
accountsobjectoptionalOptional. Which connected account to post as when a platform has more than one, e.g. {"twitter": "@handle"}. Values: the handle, or the id from list_accounts. Leave out to use the platform's default account (marked default in list_accounts).
idempotency_keystringoptionalOptional. A unique string (e.g. a UUID) for this post. Retry a timed-out call with the same key and Octopost returns the original post instead of posting again.
variantsobjectoptionalOptional. A different version of the post for some networks, keyed by network, e.g. {"linkedin": {"content": "A longer take for LinkedIn"}, "twitter": {"content": "Short version", "segments": [{"content": "https://example.com"}]}}. Each network listed gets …
allow_duplicatebooleanoptionalOptional. Octopost refuses the same text to the same network within 7 days (the error names the earlier post). Set true only when posting it again is intended.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_post",
    "arguments": {
      "content": "...",
      "platforms": []
    }
  }
}
create_uploadcan modifyAttach a file from your machine (screenshot, photo, video): this returns a one-time upload_url, good for 15 …

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.

ParameterTypeDescription
filenamestringoptionalOptional. The local file name, used in the example command.
sizenumberoptionalOptional. File size in bytes; checked against the plan limit up front.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "create_upload",
    "arguments": {}
  }
}
delete_postcan modifydestructiveexternal accessDelete a post from Octopost. For published posts, also attempts to delete from each platform via their APIs. …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) to delete.
delete_from_platformsbooleanoptionalWhether to also delete from platforms (for published posts). Default: true. Set to false to only remove from Octopost.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "delete_post",
    "arguments": {
      "post_id": "..."
    }
  }
}
get_analyticsread-onlyexternal accessHow published posts did: likes, reposts, replies, quotes and (on X) views. Two modes: - With post_id: that …

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).

ParameterTypeDescription
post_idstringoptionalOptional. One post's numbers. Leave out for a summary.
fromstringoptionalOptional. Summary start, an ISO date like 2026-11-01. Default: 30 days ago.
tostringoptionalOptional. Summary end, an ISO date. Default: now.
platformstringoptionalOptional. Only count this network in the summary. One of: twitter, bluesky, mastodon
topnumberoptionalOptional. How many top posts to list (0 to 50, default 5).
refreshbooleanoptionalOptional. Read fresh numbers from the networks before answering (once every 10 minutes).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_analytics",
    "arguments": {}
  }
}
get_guideread-onlyGet a comprehensive guide on using Octopost effectively. Returns platform limits, best practices, content …

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

ParameterTypeDescription
topicstringoptionalSpecific topic to get help on. Omit for the full guide. One of: overview, platforms, media, scheduling, threads, best-practices, queue

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_guide",
    "arguments": {}
  }
}
get_postread-onlyGet everything about one post: status, full text, approval state and reviewer feedback, thread segments, …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID)

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_post",
    "arguments": {
      "post_id": "..."
    }
  }
}
get_queue_statusread-onlySee your queue: how many posts are ready, how many need approval, when the next one publishes, and your queue …

See your queue: how many posts are ready, how many need approval, when the next one publishes, and your queue settings.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_queue_status",
    "arguments": {}
  }
}
get_usageread-onlyHow much of the plan is used: X post units this month (used, limit, remaining, when it resets; a post with a …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "get_usage",
    "arguments": {}
  }
}
list_accountsread-onlyList all connected social media accounts. ALWAYS call this before create_post to see which platforms the user …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_accounts",
    "arguments": {}
  }
}
list_feedsread-onlyList the RSS/Atom feeds this account turns into posts: each feed's networks, template, mode ("hold" = every …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_feeds",
    "arguments": {}
  }
}
list_postsread-onlyList posts, newest first: content preview, platforms, status, scheduled time and each network's link. Filter …

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.

ParameterTypeDescription
statusstringoptionalFilter by status. "queued" = in the active queue, "pending" = waiting for human approval, "partial" = live on some networks only. Omit for all posts. One of: published, scheduled, draft, queued, pending, partial, failed, retrying …
limitnumberoptionalPosts per page (default 10, max 50).
cursorstringoptionalnext_cursor from the previous list_posts call, to get the next page. Keep the same status filter.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_posts",
    "arguments": {}
  }
}
list_presetsread-onlyList publishing presets: saved platform combinations (system presets plus the user's own) with their …

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.

Takes no parameters.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_presets",
    "arguments": {}
  }
}
list_youtube_commentsread-onlyexternal accessRead the comments on a YouTube video: each top-level comment with its author, text, likes, date, reply count …

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. This only works for an account with a YouTube channel connected (list_accounts). Pass next_page_token back as page_token for more.

ParameterTypeDescription
videostringrequiredThe video id or a link to the video.
orderstringoptionalOptional. "time" (default, newest first) or "relevance". One of: time, relevance
max_resultsnumberoptionalOptional. Comments per page, 1 to 100 (default 20).
page_tokenstringoptionalOptional. next_page_token from the previous call.
searchstringoptionalOptional. Only comments containing this text.
accountstringoptionalOptional. Which connected YouTube channel to read as (handle or id from list_accounts). Default: the default channel.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "list_youtube_comments",
    "arguments": {
      "video": "..."
    }
  }
}
preview_postread-onlyDry run: what would happen if you sent this post, without saving or posting anything. Returns ok (would it go …

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.

ParameterTypeDescription
contentstringrequiredThe post text.
platformsstring[]requiredNetworks it would go to.
media_urlsstring | object[]optionalMedia it would carry: URLs or {url, alt}. See create_post.
video_urlstringoptionalOptional video URL.
segmentsobject[]optionalThread reply segments, as on create_post.
pollobjectoptionalPoll, as on create_post.
first_commentstringoptionalFirst comment, as on create_post. Its character counts per network are checked too.
accountsobjectoptionalOptional. Which account per network when a platform has several, e.g. {"twitter": "@handle"}. See create_post.
variantsobjectoptionalOptional. A different version per network, e.g. {"linkedin": {"content": "..."}}; what it leaves out comes from the main post. See create_post.
allow_duplicatebooleanoptionalOptional. true to send text already sent to that network within 7 days (refused otherwise). See create_post.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "preview_post",
    "arguments": {
      "content": "...",
      "platforms": []
    }
  }
}
publish_draftcan modifyexternal accessPublish a post that's already saved in Octopost right now: a draft, a scheduled post (it goes out now instead …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID), from list_posts or the call that saved it.
allow_duplicatebooleanoptionalOptional. true to send text already sent to that network within 7 days (refused otherwise). See create_post.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "publish_draft",
    "arguments": {
      "post_id": "..."
    }
  }
}
queue_postcan modifyexternal accessAdd a post to your publishing queue. It will be published automatically during your active hours. Posts …

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.

ParameterTypeDescription
contentstringrequiredThe post text.
platformsstring[]requiredWhich platforms to post to. Call list_accounts first to see what's connected.
needs_approvalbooleanoptionalIf true, the post is held as "pending" until a person approves it from the emailed link or the dashboard. Default: false (some accounts require approval for every post anyway).
media_urlsstring | object[]optionalOptional images or one video: URLs or {url, alt}. See create_post.
video_urlstringoptionalOptional video URL.
pollobjectoptionalPoll, 2-4 options (Twitter and Mastodon only). See create_post.
mastodon_visibilitystringoptionalMastodon visibility. Default: public. One of: public, unlisted, private, direct
content_warningstringoptionalMastodon content warning.
cross_link_enabledbooleanoptionalPost to primary_platform first, then share its link on the others. See create_post.
primary_platformstringoptionalWhich platform goes first when cross-linking. One of: twitter, threads, bluesky, linkedin, mastodon, instagram, facebook, pinterest …
cross_link_templatestringoptionalCross-link text, with {platform} and {link}. See create_post.
segmentsobject[]optionalOptional thread replies (up to 24). See create_post.
first_commentstringoptionalOptional. Posted as the first reply right after the post. See create_post.
tiktokobjectoptionalFor TikTok. See create_post.
accountsobjectoptionalOptional. Which account per network when a platform has several, e.g. {"twitter": "@handle"}. See create_post.
idempotency_keystringoptionalOptional. Unique string for this post: a retry with the same key returns the original post. See create_post.
variantsobjectoptionalOptional. A different version per network, e.g. {"linkedin": {"content": "..."}}; what it leaves out comes from the main post. See create_post.
allow_duplicatebooleanoptionalOptional. true to send text already sent to that network within 7 days (refused otherwise). See create_post.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "queue_post",
    "arguments": {
      "content": "...",
      "platforms": []
    }
  }
}
reject_queued_postcan modifyTake a queued post out of the queue and turn it back into a draft, with an optional note saying why (shown …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) to take out of the queue.
notestringoptionalOptional. Why it was rejected (up to 500 characters).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "reject_queued_post",
    "arguments": {
      "post_id": "..."
    }
  }
}
remove_feedcan modifydestructiveStop turning a feed into posts and forget which items it has seen. Posts the feed already made (published, …

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.

ParameterTypeDescription
feed_idstringrequiredThe feed id from list_feeds.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "remove_feed",
    "arguments": {
      "feed_id": "..."
    }
  }
}
reorder_queuecan modifyexternal accessSet the order queued posts publish in. The posts you list go first, in that order; queued posts you leave out …

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.

ParameterTypeDescription
post_idsstring[]requiredPost IDs in the order they should publish (first = next).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "reorder_queue",
    "arguments": {
      "post_ids": []
    }
  }
}
reply_to_youtube_commentcan modifyexternal accessPost a public reply to a YouTube comment as the connected channel; it goes live right away. Get comment_id …

Post a public reply to a YouTube comment as the connected channel; it goes live right away. Get comment_id from list_youtube_comments. 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.

ParameterTypeDescription
comment_idstringrequiredThe comment_id from list_youtube_comments.
textstringrequiredThe reply, up to 10,000 characters.
accountstringoptionalOptional. Which connected YouTube channel replies (handle or id from list_accounts).

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "reply_to_youtube_comment",
    "arguments": {
      "comment_id": "...",
      "text": "..."
    }
  }
}
reschedule_postcan modifyexternal accessChange the scheduled time of a post. The new time must be in the future. Works on both scheduled posts and …

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).

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) to reschedule.
scheduled_forstringrequiredNew time, ISO 8601. With a timezone offset or Z, e.g. 2026-11-04T09:00:00-05:00 or 2026-11-04T14:00:00Z (a time without one is rejected). Must be in the future.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "reschedule_post",
    "arguments": {
      "post_id": "...",
      "scheduled_for": "..."
    }
  }
}
resubmit_postcan modifyAfter a reviewer clicked "Ask for changes" (get_post: approval.state "changes_requested", approval.feedback …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID).
replystringoptionalOptional. What you changed, shown to the reviewer.
scheduled_forstringoptionalOptional. New time, ISO 8601 with offset.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "resubmit_post",
    "arguments": {
      "post_id": "..."
    }
  }
}
retry_failedcan modifyexternal accessRetry publishing to platforms that failed on a previous post. Only retries platforms that had errors — …

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).

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) to retry.
platformsstring[]optionalSpecific platforms to retry. Omit to retry ALL failed platforms.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "retry_failed",
    "arguments": {
      "post_id": "..."
    }
  }
}
schedule_postcan modifyexternal accessSchedule a post for future publishing. The Octopost scheduler will publish it at the specified time …

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).

ParameterTypeDescription
contentstringrequiredThe post text
platformsstring[]requiredWhich platforms to post to
scheduled_forstringrequiredWhen to publish, ISO 8601. With a timezone offset or Z, e.g. 2026-11-04T09:00:00-05:00 or 2026-11-04T14:00:00Z (a time without one is rejected). Must be in the future.
needs_approvalbooleanoptionalIf true, the post is held until a person approves it (Octopost emails them a one-tap link). Approved before scheduled_for: it publishes then; approved later: it publishes right away. Default: false.
media_urlsstring | object[]optionalOptional images or one video: URLs or {url, alt}. See create_post.
video_urlstringoptionalOptional video URL.
pollobjectoptionalPoll, 2-4 options (Twitter and Mastodon only). See create_post.
mastodon_visibilitystringoptionalMastodon visibility. Default: public. One of: public, unlisted, private, direct
content_warningstringoptionalMastodon content warning.
cross_link_enabledbooleanoptionalPost to primary_platform first, then share its link on the others. See create_post.
primary_platformstringoptionalWhich platform goes first when cross-linking. One of: twitter, threads, bluesky, linkedin, mastodon, instagram, facebook, pinterest …
cross_link_templatestringoptionalCross-link text, with {platform} and {link}. See create_post.
segmentsobject[]optionalOptional thread replies (up to 24). See create_post.
first_commentstringoptionalOptional. Posted as the first reply right after the post. See create_post.
tiktokobjectoptionalFor TikTok. See create_post.
accountsobjectoptionalOptional. Which account per network when a platform has several, e.g. {"twitter": "@handle"}. See create_post.
idempotency_keystringoptionalOptional. Unique string for this post: a retry with the same key returns the original post. See create_post.
variantsobjectoptionalOptional. A different version per network, e.g. {"linkedin": {"content": "..."}}; what it leaves out comes from the main post. See create_post.
allow_duplicatebooleanoptionalOptional. true to send text already sent to that network within 7 days (refused otherwise). See create_post.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "schedule_post",
    "arguments": {
      "content": "...",
      "platforms": [],
      "scheduled_for": "..."
    }
  }
}
set_evergreencan modifyexternal accessMark a post evergreen (or not). When the posting queue runs empty, Octopost posts an evergreen post again in …

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).

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID).
evergreenbooleanrequiredtrue to mark it evergreen, false to stop re-posting it.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "set_evergreen",
    "arguments": {
      "post_id": "...",
      "evergreen": false
    }
  }
}
split_threadread-onlySplit long text into thread parts that fit every network you name, breaking at paragraphs, then sentences, …

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.

ParameterTypeDescription
textstringrequiredThe full text to split.
platformsstring[]requiredNetworks the thread will go to. Every part fits all of them.
numberingbooleanoptionalAdd " 1/N" to the end of each part. Default false.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "split_thread",
    "arguments": {
      "text": "...",
      "platforms": []
    }
  }
}
update_postcan modifydestructiveexternal accessUpdate a post's content, platforms, scheduled time, attached media, or thread reply segments. Only works on …

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.

ParameterTypeDescription
post_idstringrequiredThe post ID (UUID) to update.
contentstringoptionalNew post text. Omit to keep existing content.
platformsstring[]optionalNew platform list. Omit to keep existing platforms.
scheduled_forstringoptionalNew scheduled time, ISO 8601. With a timezone offset or Z, e.g. 2026-11-04T09:00:00-05:00 or 2026-11-04T14:00:00Z (a time without one is rejected). Must be in the future. Omit to keep the existing schedule.
media_urlsstring | object[]optionalNew media for the main post (URL strings or {url, alt}; see create_post). Replaces existing media. Pass an empty array [] to remove all media. Omit to keep existing media unchanged.
video_urlstringoptionalNew video URL to attach to the main post. Replaces existing media. Omit to keep existing media unchanged.
segmentsobject[]optionalNew thread reply segments (up to 24; see create_post). Pass an empty array to remove existing thread replies and revert to a single post. Omit to keep existing segments.
variantsobjectoptionalA different version per network; format on create_post. Here an object replaces every variant; pass null or {} to remove them. Omit to keep them (a network you drop from platforms loses its variant).
first_commentstringoptionalNew first comment (posted as a reply right after the post; see create_post). Pass an empty string to remove it. Omit to keep the existing one.
tiktokobjectoptionalFor TikTok. See create_post.

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_post",
    "arguments": {
      "post_id": "..."
    }
  }
}
update_queue_settingscan modifyexternal accessChange your queue settings: how often to post, active hours, timezone, or pause/resume the queue. Defaults: …

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.

ParameterTypeDescription
enabledbooleanoptionalEnable or disable (pause) the queue.
interval_hoursnumberoptionalHours between each queued post (e.g. 4 = one post every 4 hours).
start_hournumberoptionalStart of active hours (0-23). Posts only publish after this hour.
end_hournumberoptionalEnd of active hours (0-23). Posts stop publishing at this hour.
timezonestringoptionalIANA timezone string (e.g. "America/New_York", "Europe/London").

Example call (required arguments only, placeholder values):

{
  "method": "tools/call",
  "params": {
    "name": "update_queue_settings",
    "arguments": {}
  }
}

Badge

Maintain this server? Put its live status in your README:

MCP status badge

[![MCP status](https://mcp.aianytime.net/badge/octopost.svg)](https://mcp.aianytime.net/s/octopost/)

Edit this entry · Report a problem

More in Marketing, content & social

Checks record what a server answered, not whether it is safe. A listing is not a security audit; read a server's source and permissions before you connect it. Add a server · JSON · llms.txt · llms-full.txt

Browse: Agents, IDEs & developer tools · Search & discovery · Knowledge, memory & context · Media & generation · Security · Finance & markets · Marketing, content & social · Cloud, ops & data · Commerce, travel & logistics · Work & productivity · No account needed · Local servers