Octopost

Your agent posts, schedules and threads to X, Bluesky, Mastodon and LinkedIn, with a human approval queue. Remote MCP, OAuth 2.1 or API key. Paid plans from $29/month.

Hosted MCP Server

npx add-mcp 'https://octopost.ink/mcp'

Installs into Claude Code, Codex, Cursor and more

Documentation

Octopost

Octopost is a remote MCP server and REST API that lets your AI agent post to X (Twitter). Connect your X account once; then Claude Code, Cursor, Codex or a script can post, schedule, queue and write threads in one call. Posts a person should check first wait in an approval queue. Plans from $29 a month.

Works with: Claude Code, claude.ai, ChatGPT, Cursor, Codex, Gemini CLI, Windsurf, VS Code Copilot, OpenCode, any MCP client (sign in with OAuth, or send a Bearer API key), and plain HTTP from scripts and CI.

This repository holds the agent skill and the MCP config. The Octopost service is hosted; its code is not here.

Networks

NetworkStatus
X (Twitter)Live
ThreadsWorks; opens to customers after Meta approves the Octopost app
Bluesky, LinkedIn, MastodonIn testing

Install

Most clients just need the URL: they open an Octopost sign-in page the first time (OAuth), with no key to copy. An API key (https://octopost.ink/dashboard/api-keys) is for clients without sign-in, scripts and CI.

AgentHow
Claude Codeclaude mcp add --transport http octopost https://octopost.ink/mcp, then /mcp > octopost > Authenticate
Claude Code plugin (skill + server)/plugin marketplace add octopost-ink/octopost-plugin, then /plugin install octopost@octopost, then /mcp > octopost > Authenticate
Claude Code with an API keyclaude mcp add octopost --transport http https://octopost.ink/mcp --header "Authorization: Bearer $OCTOPOST_API_KEY"
claude.ai, Claude Desktop, ChatGPTAdd a custom connector with the URL https://octopost.ink/mcp and sign in
Skill only (any agent that reads skills)npx skills add octopost-ink/octopost-plugin
Cursor, VS Code, Codex, Gemini CLI, WindsurfOne page per client: https://octopost.ink/connect/cursor (all clients linked there)
Scripts, CIREST API at https://octopost.ink/api: https://octopost.ink/docs/agents.md

Install the skill in any agent

skills.sh

npx skills add octopost-ink/octopost-plugin        # this project (asks which agents)
npx skills add octopost-ink/octopost-plugin -g     # user-level, every project

Where the skill lands (to install by hand, copy skills/octopost/ there):

AgentProject folderUser folder (-g)
Claude Code.claude/skills/octopost/~/.claude/skills/octopost/
Codex.agents/skills/octopost/~/.codex/skills/octopost/
Cursor.agents/skills/octopost/~/.cursor/skills/octopost/
GitHub Copilot.agents/skills/octopost/~/.copilot/skills/octopost/
Gemini CLI.agents/skills/octopost/~/.gemini/skills/octopost/
OpenCode.agents/skills/octopost/~/.config/opencode/skills/octopost/
Cline.agents/skills/octopost/~/.agents/skills/octopost/
Windsurf.windsurf/skills/octopost/~/.codeium/windsurf/skills/octopost/
Goose.goose/skills/octopost/~/.config/goose/skills/octopost/
OpenClawskills/octopost/~/.openclaw/skills/octopost/

The skill tells your agent when and how to use Octopost; the MCP server does the work, so connect that too (see Install above).

What your agent can do

list_accounts, create_post, schedule_post, queue_post, approve_queued_post, get_queue_status, update_queue_settings, list_posts, get_post, update_post, reschedule_post, cancel_scheduled, delete_post, retry_failed, list_presets, get_guide.

Pricing

Basic $29/month, Premium $79/month, Business $199/month. Every plan starts with a 7-day trial for $1. X bills per post, so plans include monthly X post units: a plain post uses 1, a post with a link uses 13. Details: https://octopost.ink/pricing

Signing up through an agent? This link opens checkout with the agent code OCTOAGENT applied (20% off the first month): https://octopost.ink/checkout?plan=basic&code=OCTOAGENT

Support

hello@greatwork.company. Octopost is made by Great Work LLC.

License

The skill and the files in this repository are MIT licensed. The Octopost service itself is hosted and is not open source.

Last updated: 2026-11-04