yeetpostyeetpost

Post to social media from Windsurf

Add the yeetpost MCP server to Windsurf's mcp_config.json with an API key and Cascade can post, schedule and queue to your connected accounts. Windsurf calls the URL field serverUrl.

Get an API keyMCP docs

Set it up

The server is a Streamable HTTP MCP endpoint at https://api.yeetpost.com/api/v2/mcp.

  1. Connect at least one account in the yeetpost console (https://app.yeetpost.com). Each connection gets a slug, such as linkedin or bluesky, which is how the agent addresses it.

  2. Create an API key on the API page of the yeetpost console (https://app.yeetpost.com/app/api). A key starting yp_test_ reaches sandbox connections only and publishes nothing, which is the one to use while you wire this up.

  3. Open ~/.codeium/windsurf/mcp_config.json and add the server. Note serverUrl, not url:

    {
  "mcpServers": {
    "yeetpost": {
      "serverUrl": "https://api.yeetpost.com/api/v2/mcp",
      "headers": {
        "x-api-key": "yp_secret_your_key_here"
      }
    }
  }
}

  4. Refresh the MCP servers in Windsurf and ask Cascade to post.

Three things to ask

  • Post to Bluesky: we rewrote the scheduler, three things we got wrong.
  • Draft an X thread about this release and save it as a draft.
  • Which of my connections need reconnecting?

What Windsurf gets

All 37 tools of the yeetpost MCP server, including:

  • get_context: Start here. Who you act as, live or test mode, the plan, what is left of today's allowance, and what needs attention (failed posts, expired logins, connections with no slots), each with its fix.
  • create_post: Post to one or more connections now, at scheduledFor, into the queue, or as a draft, with images, a timezone and an idempotencyKey so a retry never posts twice.
  • list_posts: List posts, newest first, filtered by status, tag, connection, platform, profile, send group or time, with paging.
  • draw_card: Draw an image card for an existing post in its connection's look, to show the user and attach when they say yes.
  • get_post_metrics: A post's numbers over time, and whether yeetpost is collecting them for its connection.

The full list is on the MCP docs page.

FAQ

Which platforms can Windsurf post to through yeetpost?
LinkedIn, X, Bluesky, Discord, Telegram and Mastodon. Reddit, Facebook, Instagram, Threads, Google Business Profile, Slack, SMS and email are not live yet.
Can I try it without posting for real?
Yes. A test key (starts yp_test_) sees sandbox connections only: posts are validated and answered like a real platform's, and nothing is published.
Does it cost anything?
Posts are unlimited on every plan. Billing is per connected account, with the first 2 free. X is the one platform with a per-post fee, passed through at X's own cost: 1.5 cents a post, 20 cents when the post has a link.
Which tools does the agent get?
All 37 tools of the hosted MCP server: posting, scheduling and queues, drafts, brand voice and image cards, media, connections and sources. The full list is on the MCP docs page.

More

Other clients: Claude, Cursor, Codex, n8n, VS Code.

By platform: LinkedIn MCP server, X MCP server, Bluesky MCP server, Mastodon MCP server, Telegram MCP server, Discord MCP server.