Octopost + Windsurf

Octopost is a social media MCP server. Add it to Windsurf and your agent can post to X, Bluesky, Mastodon and LinkedIn, write threads, schedule posts and hold them for your approval. Other networks are on the roadmap.

  1. 1. Start a plan and connect X

    Sign up (7 days for $1, then $29 a month), then connect your X account on the accounts page.

  2. 2. Add Octopost to Windsurf

    Add this to ~/.config/devin/mcp_config.json (Windsurf is now Devin Desktop; older builds use ~/.codeium/windsurf/mcp_config.json):

    {
      "mcpServers": {
        "octopost": {
          "serverUrl": "https://octopost.ink/mcp",
          "headers": {
            "Authorization": "Bearer op_YOUR_API_KEY"
          }
        }
      }
    }
    1. Copy an API key from https://octopost.ink/dashboard/api/keys.
    2. Add the octopost entry below and replace op_YOUR_API_KEY with your key.
    3. Check that octopost is switched on in the MCPs section of the Cascade panel.

    Replace op_YOUR_API_KEY with a key from the API keys page. Keys start with op_.

  3. 3. Try it

    Ask your agent:

    • “List my Octopost accounts.”
    • “Queue a post to X about today's release and hold it for my approval.”
    • “Turn these release notes into a 3-post X thread and schedule it for 9am tomorrow.”

If it doesn't connect

  • The sign-in window didn't open, or it says the app isn't registered: remove the Octopost connector and add the URL again.
  • 401 Unauthorized with a key: the key is missing, mistyped, revoked, or not sent as Authorization: Bearer op_.... The error message names which.
  • “Your Octopost plan is not active”: finish the $1 trial checkout on the billing page.
  • “No twitter account connected”: connect X on the accounts page.

Still stuck? Email hello@greatwork.company; a person answers.

Other clients

Any other MCP client: add https://octopost.ink/mcp as a remote (Streamable HTTP) server and sign in, or send Authorization: Bearer op_.... Full reference: MCP docs.