yeetpostyeetpost

Post to social media from n8n

In n8n you can point an AI Agent's MCP Client Tool node at the yeetpost MCP server, or skip MCP and call the REST API from an HTTP Request node. Both use the same API key.

Get an API keyMCP docs

Set it up

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

MCP Client Tool node

  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. Add an MCP Client Tool node to an AI Agent. Set the endpoint to this URL, the transport to HTTP Streamable, and add a header credential named x-api-key holding your key.

    https://api.yeetpost.com/api/v2/mcp

  4. The agent now has the yeetpost tools. Give it a prompt such as the examples below.

HTTP Request node (REST API)

  1. For a fixed workflow with no agent, add an HTTP Request node: method POST, header x-api-key with your key, and a JSON body. The slugs are the connection slugs from GET /api/v2/connections.

    {
  "text": "{{ $json.text }}",
  "connectionSlugs": ["linkedin", "bluesky"]
}

  2. Add an Idempotency-Key header so a retried run never posts twice. The response has one result per connection, each sent, scheduled or failed.

Three things to ask

  • Every Monday, post this week's blog headline to LinkedIn and Bluesky.
  • When a new row lands in the sheet, queue it to my X account.
  • If a post failed, tell me which platform and why.

What n8n 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

MCP node or HTTP Request node?
Use the MCP Client Tool node when an AI agent decides what to post and where. Use the HTTP Request node when the workflow already knows the text and the connections.
Which platforms can n8n 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, Windsurf, VS Code.

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